Ocye: Created page with " This page describes the alternate, legacy method of localization. The current procedure can be found here. By choosing a menu language, the d..."

2014-10-01T13:37:13Z

Created page with " This page describes the alternate, legacy method of localization. The current procedure can be found here. By choosing a menu language, the d..."

New page

This page describes the alternate, legacy method of localization.
The current procedure can be found [[Configuration:Localization|here]].

By choosing a menu language, the dialog elements of the program are shown in your localization. The items are read from a simple text file, using the ini style formatting but with the file extension <code>.lang</code>. The file has to be stored with UTF-8 encoding. <strike> If not available the program creates a new file ''english.lang'' which could be used as basis for new translations.</strike>

At the top of the file some general information are collected under the key word <code>[Header]</code>. That is <code>Author</code>, <code>Version</code>, and <code>Date</code> which are shown in the [[Configuration:Localization|configuration dialog]]. The identifier of <code>LangID=<value></code> will be used for the flag on the game server. It follows the [[wikipedia:List_of_ISO_639-1_codes|ISO 639-1 code]]. Furthermore you can add more information in the header like licensing or comments.

{| width="100%"
|width="75%"|
The section <code>[Translation]</code> lists all items that can be localized. The hard-coded controls have a name and a property which is used for identification. This is mi=Menuitem, cb=Checkbox, gb=Groupbox, lb=Label, for example. The properties <code>Caption</code> and <code>Hint</code> contain the text, caption is the actual label, hint the respective tooltip. Captions may contain of accelerator keys defined by the [[wikipedia:en:Ampersand|ampersand]] which allows the activation by alt+<key> of the respective feature. You can use any letter of the caption, or omit it at all. For example, the ampersand at <code>&Game</code> at the line with <code>tbNewGame.Caption=New &Game</code> makes the G underlined and provides access via alt+G. Alternatively you can use <code>New Ga&me</code> to have alt+M as accelerator key.

Many controls are created after program start and do not follow the default identification. For example, <code>r2dview_caption=2D-view</code> or <code>rmain_infoappstarted=Program started</code>.
|width="25%"|
'''[Header]'''
Author=John Doe
Version=1
Date=2010-01-30
LangID=eo
Licence=Creative Commons
Comment=Just a demo
'''[Translation]'''
fmMain.Caption=Scrabble3D
tbExit.Caption=E&xit
tbExit.Hint=Fini programo
rMain_GameEnd=Ludofino

|}

A completely new localization can be created by copying and renaming an existing file or by just creating an empty file. If the empty file has the extension <code>.lang</code> and if it's placed in the [[Configuration:Localization|configuration directory]], you can "load it" after next restart. And loading means that all non-existing entries are replaced by the current setting.

Special formatting are %s (strings) and %d (decimal numbers). The position of these place holders is free but make sure the items contains it. For example, you can replace <code>rmain_gameendwin=Game is won by %s</code> by <code>rmain_gameendwin=%s wins the game.</code>. The statement %s will be replaced dynamically by the name of the player. In case of more than one formatting the sequence matters. In particular you must not interchange %s and %d.

For hints it is possible to define line breaks. To do so, add ''\\n'' at the position where you want to break the text. You may add as many line breaks as you need.

In case of multiple plurals you can use the pipe char to separate the forms. The plural forms are fix implemented and defined by language ID at the header. For example <code>Zero items|One item|Many items</code>, in case of French.

{{Languages|Configuration:Create_Menu_Language}}

[[Category:English]][[Category:Configuration]]

Configuration:Create Menu Language - Revision history

Ocye: Created page with " This page describes the alternate, legacy method of localization. The current procedure can be found here. By choosing a menu language, the d..."