Difference between revisions of "Translating STK"

(Reverted edits by 127.0.0.1 (Talk); changed back to last version by Keyboardwolfkingusa)
(Creating a new translation)
Line 5: Line 5:
  
 
The directory where you need to go is /data/po. There you will see a file named ''supertuxkart.pot'' and a script called ''update_pot.sh''. The .pot file contains all translatable strings of STK. The ''update_pot.sh'' script can be run from the base directory to update the .pot file, but you generally do not need to do that since the STK developers will do it for you.
 
The directory where you need to go is /data/po. There you will see a file named ''supertuxkart.pot'' and a script called ''update_pot.sh''. The .pot file contains all translatable strings of STK. The ''update_pot.sh'' script can be run from the base directory to update the .pot file, but you generally do not need to do that since the STK developers will do it for you.
 +
 +
== Configuring poEdit ==
 +
* Make sure poEdit is configured to compile .mo files on saving (check in preferences)
 +
[[Image:Poedit_prefs.png]]
 +
 +
* from the '''View''' memu, check '''Show automatic comments window'''. This will make a new area appear : this area will sometimes contain tips that the devs left to help you translate a string, for instance if its meaning is ambiguous.
 +
[[Image:Poedit_comments.png]]
  
 
== Creating a new translation ==
 
== Creating a new translation ==
Line 17: Line 24:
 
* Enter the appropriate information in the dialog that pops-up (ignore fields you do not understand or that do not make sense for this project. Only the first tab needs to be completed)
 
* Enter the appropriate information in the dialog that pops-up (ignore fields you do not understand or that do not make sense for this project. Only the first tab needs to be completed)
 
[[Image:Poedit3.png]]
 
[[Image:Poedit3.png]]
 
* Make sure poEdit is configured to compile .mo files on saving (check in preferences)
 
[[Image:Poedit_prefs.png]]
 
  
 
* Then simply select the strings in the list and enter a translation.
 
* Then simply select the strings in the list and enter a translation.

Revision as of 20:38, 17 September 2016

This article will explain how to translate STK into another language.

  • Get poEdit from http://www.poedit.net/ or from your repositories on linux. (you may use other tools but the procedure for them is not documented here)
  • Get STK version 0.5rc1 or better

The directory where you need to go is /data/po. There you will see a file named supertuxkart.pot and a script called update_pot.sh. The .pot file contains all translatable strings of STK. The update_pot.sh script can be run from the base directory to update the .pot file, but you generally do not need to do that since the STK developers will do it for you.

Configuring poEdit

  • Make sure poEdit is configured to compile .mo files on saving (check in preferences)

File:Poedit prefs.png

  • from the View memu, check Show automatic comments window. This will make a new area appear : this area will sometimes contain tips that the devs left to help you translate a string, for instance if its meaning is ambiguous.

File:Poedit comments.png

Creating a new translation

  • Open poEdit and use menu File > New catalog from POT file.

File:Poedit1.png

  • Select supertuxkart.pot.

File:Poedit2.png

  • Enter the appropriate information in the dialog that pops-up (ignore fields you do not understand or that do not make sense for this project. Only the first tab needs to be completed)

File:Poedit3.png

  • Then simply select the strings in the list and enter a translation.
  • When you're done, save the file as [language code].po. Along it, a .mo file will be generated. Move the .mo file to /data/po/[language_code]/LC_MESSAGES/supertuxkart.mo.
  • Then translate the following strings.
  • To test, export LANG=[keycode] then run SuperTuxKart (on Unix systems)

Updating an existing translation

  • Open the language code.po file in poEdit.
  • Choose Catalog > update from POT file

File:Poedit update.png

  • Select supertuxkart.pot.

File:Poedit2.png

  • You will then get a summary of changes (new and/or obsolete strings) if any.
  • Then simply select the strings in the list and enter a translation.
  • When you're done, save the file. Along it, a .mo file will be generated. Move the .mo file to /data/po/[language_code]/LC_MESSAGES/supertuxkart.mo.