.How localization works vv1

Language xml files and Terms

At startup, Macrium Reflect loads the language .xml file corresponding the chosen language in 'Other tasks' > 'Edit Defaults and Settings' > 'Advanced' > 'Language':

Folder 'C:\program Files\Macrium\Common\Languages' is the source for all available languages and translations.
New languages are automatically downloaded when Reflect starts.  

Language files are named using the ISO 639-1 character code of the language.

Example xml format:

<localization>
    <language code="de" updated="2021-11-12T15:18:15+0000">German</language>
    <date_created>19/11/2021 11:48</date_created>
    <executable>
        <name>ReflectBin</name>
        <strings>
                <IDR_MAINFRAME-POPUP1>&amp;Datei</IDR_MAINFRAME-POPUP1>

• The language code must be a valid ISO 639- code, in this case it's "de"
  
  
• The updated date of "2021-11-12T15:18:15+0000" indicates whether the file is outdated, and if so, it will be replaced if a later file is found when checking for updates or if the language is switched to German.
  
  
• The executable name "ReflectBin" indicates that the text is used in the main Reflect application. 
  
  
• In the example above term IDR_MAINFRAME-POPUP1 is a unique identifier (term) that defines the text element Datei in Macrium Reflect, in this case it's the first menu item on the main screen:
  
  

How to find the unique identifier for a term 

Download en-us.xml

You can simply search the English language xml file to locate the term for English text.  The file 'en-us.xml' contains every term available for translation available in Macrium Reflect and installed components,

Use 'DownloadLangXml.exe en-us'   to get the latest English terms. 

See: Viewing your translations in Macrium Reflect  for more information on DownloadLangXml.exe

Open the file in Windows notepad and use the Ctrl+F search facility to search for English text. 



In this example the unique term id is IDS_XML_EMPTY_LIST_PARA2_OPTION1_CREATE_IMAGE for "Create an Image...".

The full term id in POEditor will be preceded by the application name and the # character, i.e, ReflectBin#IDS_XML_EMPTY_LIST_PARA2_OPTION1_CREATE_IMAGE

Macrium Reflect Language Debug Mode

Command Line

Reflect has command line parameters to turn Language Debugging on and off.

Menu Option

You can also create an empty file in the installation folder named: 'debuglanguage': 

Folder:  C:\Program Files\Macrium\Reflect\
File:    debuglanguage

If this file exists then you can toggle debug on/off using the 'Other Tasks' > 'Debug Language' menu option. The file can be created/deleted at any time nd the menu option will show/hide dynamically. 

Registry

Alternatively, you can set the following registry entry to make Reflect load in Language debug mode:

Restart Reflect after changing the registry.

Reflect showing unique identifiers