Create New Language

From PGVWiki
Jump to: navigation, search

Begin by editing file "includes/lang_settings_std.php". Copy one of the other language settings, and make the changes appropriate for the new language. I suggest you use Vietnamese as a guide, but empty the alphabet settings (they can be changed later). The order in which the various languages appear in this file doesn't matter. Although this file contains a lot of special characters, you MUST treat it as a plain ASCII text file. Do NOT attempt to get your text editor to display the non-ASCII characters in their correct form. The file is actually in UTF8 code without the self-identifying Byte Order Mark.

The language name should be "sundanese", and the language shortcut should be "su". This is what you also enter in the file names in place of "vi", "en", or whatever other language you selected as a starting point.

You also need to tell PhpGedView what name to display in English menus when it sees a reference to "sundanese". This is basically a definition of the language variable $pgv_lang["lang_name_sundanese"]. You will find the list of language names in file "languages/configure_help.en.php" between lines 539 and 562. The order of the entries is not important. In fact, you could even add your new language name anywhere else in the file. However, we ask that you not do this, since that would make maintenance of the language list more difficult.

Once you have made these changes, PhpGedView will have "Sundanese" in the list of languages.

Begin by editing the settings for that language. You need to enter the correct name in Sundanese, and you need to enter the alphabet in the correct sorting order, both upper and lower case. If you're using the Latin alphabet with diacritics (normally diacritics are guides to pronunciation), you also need to decide whether you want to use dictionary rules for sorting. Don't forget to mark the language as "active", and to select the correct flag (it should be "Indonesia.gif").

When the Sundanese language is marked as "active", you can find it in the language selection menus. Initially, all text will be in English since you haven't made any translations. It's OK to have missing or empty language files.

You can use the Translator tools to get PhpGedView to create a basic file that you can then edit (translate) on-line. To make this work, the "languages" directory MUST have full read/write/modify permissions for the world. This is the 0777 permission set. Alternatively, you can make a copy of the English files and re-name them with "su" in place of "en" in the file name. You can then edit (translate) these files off-line using your favourite text editor.

The method you use depends on your personal preference. I find it easier to edit off-line when I'm making a lot of changes.

You MUST remember that the language files are in the UTF8 character set without that Byte Order Mark. This is important when you're editing the files off-line.


By: Gerry Kroll (canajun2eh) - 2008-05-16 20:08