############################################################################## IMPORTANT NOTES FOR TRANSLATORS ############################################################################## Thank you for translating this application to an other language. To start a translation, you can use the English language file as a starting point. To do so, copy the file "en.English.lng" and rename it as described in the following. FILE NAME The file name will be used for the language list in the application as well as for the automatic selection of the language based on the user's system language. The language file name must consists of the following parts: 1. The lower case 2-digit ISO 639-1 code for the language (e.g. "de" for German or "fr" for French). See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes for a list. This part will be used to set the language automatically based on the user's system language. 2. A single dot as delimiter. 3. The unique language name in English This part will be displayed in the application's language selection list. 4. The file extension ".lng". Examples: de.German.lng en.English.lng fr.French.lng FILE FORMAT Language files have to be saved as UTF-8, including the UTF-8 BOM (Byte Order Mask). You can do this for example with the Windows Editor by saving the file with the encoding "UTF-8" in the save dialog. If you have a text editor with syntax highlighting, you can use the syntax highlighter for INI files. COMMENTS Comments must start with a sharp character ("#") in a new line. Syntax: # Comment STRINGS Each string starts with an identifier, followed by an equal sign ("=") and a text. Only the first equal sign is used as delimiter, so there is no problem, if there is an other one in the text. Syntax: Identifier=Text IMPORTANT: DO NOT CHANGE ANYTHING IN FRONT OF THE EQUAL SIGN! Strings for menu entries can contain a hotkey marker ("&"). You can access the hotkeys by pressing the Alt key. Example: Main.Menu.File=&File This defines "F" as hotkey for the "File" menu. For one menu or sub-menu, all hotkeys must be different letters. FONT The font used for the user interface can be changed by editing the strings "General.Font.Name" and "General.Font.Size". IMPORTANT: CHANGE THIS ONLY IF IT'S REQUIRED TO DISPLAY THE LANGUAGE CORRECTLY. DO NOT "TRANSLATE" THE FONT NAME! PLACEHOLDERS Placeholders are numbers, enclosed with curly brackets ("{" and "}"). In the text can be one or more placeholders. These placeholders will be replaced by the application with a variable text depending on the string. Example: Example.String=This is step {0} out of a total of {1} Example output: This is step 3 out of a total of 6 The placeholder "{0}" will be replaced with the current step number and the placeholder "{1}" with the total count. The grammar of a language can be different, so the text can be written in an other order too, like the following alternative: Example.String=Total steps: {1}, current step: {0} The special placeholder "{APPNAME}" is available in all strings and will be replaced by the applications name. IMPORTANT: PLACEHOLDERS MUST NOT BE CHANGED! ESCAPE CHARACTERS Some applications print a text in multiple lines or use a tabulator character. To print control characters or special characters, a escape character is used. Supported escape characters: \s Space \r Carriage Return \n New Line \t Tabulator \w Windows line break (it's equal to "\r\n") The text "Headline:\r\n\tContent" prints the text "Headline:" in the first line. After a Windows line break follows a tabulator and then the text "Content". SPACE CHARACTERS Spaces in front of a text (after the equal sign) will not be trimmed. Spaces at the end of a text will be trimmed. To avoid trimming the space characters at the end of a text, the placeholder "{END}" can be used. The text "Spaces follows {END}" will result in "Spaces follows ". Escape characters can be used too, like: "Spaces follows\s\s\s". PLEASE USE PLACEHOLDERS, ESCAPE CHARACTERS AND SPACE CHARACTERS (see above) ONLY IF THEY ARE USED IN THE ORIGINAL TEXT OF THE ENGLISH LANGUAGE FILE TOO. ##############################################################################