Celestia/Internationalization

From v1.5, Celestia fully supports internationalization. Celestia i18n is processed using gettext.
All the strings used in the program can be translated. For each language, the list of strings and their translation is saved in a .po file.

Getting .po files

The .po files can be downloaded from the Celestia SVN repository or from the table in the 'Celestia translation overview' section below.

Editing .po files

The .po files can be edited using the following software:

• Poedit: for Linux and Windows.
• KBabel: for KDE

Updating existing .po files

The already existing .po files for a language can easily be updated to latest version by using the celestia.pot. In poEdit this can be done with the command "Catalog/Update from POT file". This results then in the program showing a list of removed and changed or newly introduced strings. But be advised that the creation date of the .po file internally is not updated. KBabel should also have such a mechanism.

Creating a new .po file

• Download the celestia.pot file from the Celestia SVN repository.
• Rename it using the ISO 639-1 code of your language.
• Edit it as described in the above 'Editing .po files' section.

Sending completed .po files

Once the translation is completed, .po files can be sent to gvince@sfr.fr.

Building internationalization files from the source in MS Windows

• Follow the celestia build for Win 32 platform as described in http://en.wikibooks.org/wiki/Celestia/Development/Win32_platform. It is assumed that celestia source is in "c:\celestia" and other programs are installed in c drive, too.

• Install perl (e.g. ActivePerl) and POEdit for Windows

• Add path for POEdit (e.g. C:\Program Files\Poedit\bin). This is for msgfmt.

• Open Windows command console (cmd.exe)

• Execute "C:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat"

• Change directory with "cd C:\celestia\celestia\po" command

• Run "perl translate_resources.pl". The translate_resources.pl script does:
  • translate resource files from po files -> src/celestia/rc/celestia_LL.rc
  • build dll files -> src/celestia/rc/celestia_LL.res -> locale/res_LL.dll
  • compile catalogs -> locale/LL/LC_MESSAGES/celestia[_constellations].mo

Building .txf font texture files

Celestia uses its own .txf font textures to display the OpenGL overlay text. Some non-Latin characters may be missing from the font textures wich are distributed with the standard Celestia package, though.
In that case, please use the following process to build celestia .txf font textures from standard .ttf fonts:

• Download the txf utilities from http://www.shatters.net/~claurel/stuff/txfutil.tar.gz
• Generate the .txf files:

ttf2txf -w 1048 -h 1048 -f codepoints_LL.txt -s 12 -o sans12_LL.txf font.ttf
ttf2txf -w 1048 -h 1048 -f codepoints_LL.txt -s 14 -o sans14_LL.txf font.ttf
ttf2txf -w 1048 -h 1048 -f codepoints_LL.txt -s 20 -o sansbold20_LL.txf font_bold.ttf

This will create the following font textures which should be placed in the font/ dir:

• sans12_LL.txf
• sans14_LL.txf
• sansbold20_LL.txf.
  

Note for Windows users:

• A pre-compiled version of ttf2txf is available at: http://gvince.perso.sfr.fr/celestia/dev/ttf2txf.zip
• The codepoints_LL.txt file is generated by running the translate_resources.pl perl script from the po/ dir. See Building internationalization files from the source in MS Windows section above.

Celestia translation overview

The translation process currently applies to Celestia 1.6.1 (development version).

>> Last celestia.pot file update: 2010-01-04

Main .po files:

Constellation names .po files:

Other localizable files

The following files can be localized too: controls.txt, COPYING, demo.cel, guide.cel, start.cel.
These files can be edited using a simple text editor. For UTF-8 encoding, please consider using, e.g., notepad++
Once the translation is completed, just rename the file as controls_LL.txt, COPYING_LL, demo_LL.cel, guide_LL.cel, start_LL.cel, where LL represents the ISO 639-1 code of your language.
Once the translation is completed, these files can be sent to gvince@sfr.fr.