From Seven Kingdoms
Revision as of 08:09, 9 August 2019 by Ra (talk | contribs)
Jump to: navigation, search


Since 2.14.4, Seven Kingdoms has been ported to gettext. The translatable strings are extracted and stored in a .pot template file -- from which translations are made and stored in a .po translation file. This means you do not need to work with the source code to translate 7kaa. Instead, you need a PO editor. It is possible to edit a PO file with an ordinary plain text editor, but extra effort would be necessary to make the result valid.

Supported Languages

See System Requirements for Seven Kingdoms 1

8-bit char set

left-to-right written

space for colored blocks (128-159)

Most ISO-8859 codesets work.

PO Editors

Here is a list of widely used PO editors we can recommend:

PO mode. We recommend using GNU Emacs in PO mode, because Emacs is the program that is suitable for performing any task when it comes to maintaining the GNU Project’s website. Provided that you have GNU gettext installed, any .po file you visit should automatically switch to PO mode. You can enable/disable it with M-x po-mode RET. On some GNU/Linux distros such as gNewSense, PO mode is available in a separate package, gettext-el. See Emacs’s PO File Editor in GNU gettext tools.

Gtranslator—the GNOME PO editor. See

Lokalize—the KDE 4 editor. See

KBabel—the KDE 3 editor. No longer supported, but might be available on some old systems.

Poedit—another popular editor that is based on the wxWidgets graphical toolkit. See

How to Use Poedit

Translate *.po files with Poedit

po.vim—ftplugin for the Vim editor. The best option for people who use Vim as their editor. See

Vé – PO Editor

Get the Translation File

The translations are included in the source, which means they are in the source code repository. Development is done via Github at

You can clone the the repository with git if it is installed

$ git clone

and enter the /po dir for the .pot and .po files.

Optionally, you can

$ wget


$ wget (de.po, es.po. fr.po, ru.po).

You can also go to and choose which file you want and click on 'raw' and save the page.

Updating a .po File

Take de as an example:

Add de to po/LINGUAS and run tools/update-pot on latest source checkout. Then po/de.po is up-to date.

Starting or Continuing a Translation

If you would like to continue or edit a translation that has already been started, you can use the .po file. Open it, and do your work. If you want to start a translation of language that hasn't already been started, open the 7kaa.pot file. Click 'Start New Translation' and choose your language. At this point, a .po file will be created and opened for your language. You may begin translating.


7kaa translation is collaborative. each translation can be translated by multiple translators. For example, one person translates but only completes a portion; then one or more translators complete it. Throughout the process or at completion, others can review it for quality assurance until it is agrreed that it is accurate and complete.

Collaborating with others during a translation

if two or more translators want to collaborate as the translation is ongoing, there are a couple of ways to do this.


You can collaborate with other translators via e-mail. This method would require translators to communicate in advance which strings they will translate, so that there isn't duplicate work done; then they send the .po file to the collaborator to be manually inputted to the .po file.


must be installed on server could be difficult for translators/community members

Submitting the Translation

Send your pull request via forum, mail, or github. If you prefer you can mail your patch in an attachment to Make sure you have a real first and last name by which we can attribute the change to. Jesse Allen (the3dfxdude) currently maintains the release repo. He will approve your patch (and if not available, other project managers could step in and approve the patch).

How to Install Translations

See Install Translations

For installing locales, see: How to Install Locales

Copyright and License

Seven Kingdoms:Copyrights

Translators are not required to transfer copyright to the project, but by submitting your translation to the project, it is understood that it will be GPLv2.

Works Consulted

Baker, Mona. In Other Words: A Coursebook on Translation. London: Routledge, 1992. Print.

Drepper, Ulrhic, Jim Meyering, Francois Pinard, and Bruno Haible. "GNU Gettext Tools: Native Language Support Library and Tools." 0.18.2. 25 Feb. 2013.

A Textbook of Translation by Peter Newmark