Language files

The language files use a syntax similar to INI files. They are just plain text files, so you can edit them with any text editor, such as Windows' Notepad.

The file contains sections. A section is a name between brackets. The section names are application's windows names.

> e.g.: `[MainWindow]`

Under that, you find all the items corresponding to the specified window. These items are pairs of attributes and values.

> e.g.: `Attribute=Value`

The attributes are the paths to the component to translate, and the value is the new text to display. The path is build with the component name, a dot, then the property to modify ("component.property"). For some items there are components inside components. Sometimes there are arrays, so there is an index in square brackets. For window properties there is only a property name alone.

> e.g. for [ExportWin] section:

> `Caption=Export to another file format` // caption of the Exportation window
> `btn1.Caption=Help` // caption of the first button of the Exportation window
> `Messages.Strings.String[0]=Unable to save` // first message of the messages list of the Exportation window

The component names use "standard" names.

Buttons begin with "btn", Actions (menu/toolbar items) begin with "Action", Checkboxes begin with "CB", Radiobuttons begin with "RB", labels begin with L or LH, Entry fields begin with E, etc...

The base window dialog can have 0 to 4 buttons, called btn1, btn2, btn3, btn4; where btn1 is the button in the lower right corner.

A comment line begins with a semicolon (;) and is ignored by the program.

There is a special section that is used to display information in the language selection window:

`[FileInformation]`
`Icon=` A 16x16 bitmap image (4-bit color), MIME-encoded
`Name=` Name of the language, in English
`LocalName=` Name of the language translated in the language itself
`Version=` Version of the program for which the contents was translated (if lower than the VersionFormat, it means that parts are still in English)
`VersionFormat=` Version of the program for which the file structure is made
`Comments=` Free text (linebreaks = "|", link = <link>address</link>)
`Authors=` Name and e-mail addresses of the translators (each name/address is separated by a "|": name1|addr1|name2|addr2)

If you want to be notified of translation errors, you can launch the program with the `/tr_show_errors` parameter.