Mercurial > pyntnclick
diff README-i18n.txt @ 478:a9925aaf5f61 1.0.1
i18n and Russian translation
author | Stefano Rivera <stefano@rivera.za.net> |
---|---|
date | Tue, 08 Mar 2011 12:29:14 +0200 |
parents | |
children | 4ea237bbcef8 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README-i18n.txt Tue Mar 08 12:29:14 2011 +0200 @@ -0,0 +1,42 @@ +These are notes on internationalization and translation. They are +suitable for Unix like systems. As prerequisites you need `gettext' +being installed and (if you want to translate) some editor for +gettext catalogs like `poedit' or `virtaal'. In case you are familiar +with gettext ".po" format any text editor will do. + + +== How do I translate suspended-sentence into my language? == + +First of all look if there is already translation catalog for +your locale in `po/' subdirectory. The file should be named like +`<locale>.po' where <locale> is the language code for your locale. +For example, catalog for German is called `de.po'. If it is there +you can start translating. + +If there is no file for your locale you need to generate it. To do +this navigate to the `po/' directory in terminal and type command + + msginit -l <locale> + +where <locale> is two-letters-language-code you need. Then translate +generated file using your preferred editor. + +To get new translation worked you need to compile and install it by +executing `install-po.sh' script. + + +== How can I mark the string in code as translatable? == + +Just surround it with _( and ) like + "Hello, world" -> _("Hello, world!") + +_() is a function that I placed in `gamelib/i18n.py' file, so you +might want to import it first. + + from gamelib.i18n import _ + +And don't forget to update message catalogs with new strings. To do +that just execute `update-po.sh' script. It collects all translatable +strings from files that are specified in `po/POTFILES'. Make sure file +you worked on is in there. +