Difference between revisions of "WesnothTranslationsHowTo"
(→Specifying typefaces and fonts for a translation: Refer to data/hardwired/fonts.cfg) |
|||
(15 intermediate revisions by 9 users not shown) | |||
Line 3: | Line 3: | ||
== How to submit your translations == | == How to submit your translations == | ||
+ | Important: Please '''do not submit translations as pull requests''' on the Wesnoth github repository site. While that seems like a good idea, it causes potential complications that we cannot always easily resolve. As a result, we cannot accept translations submitted via pull request and will close such PRs immediately. | ||
'' ''' Translation Maintainers ''' '' | '' ''' Translation Maintainers ''' '' | ||
Line 8: | Line 9: | ||
The translation maintainers should send the updated/new translation | The translation maintainers should send the updated/new translation | ||
po-files to the language coordinator: | po-files to the language coordinator: | ||
− | Ivanovic (crazy-ivanovic AT gmx DOT net | + | Ivanovic (crazy-ivanovic AT gmx DOT net). |
− | |||
Additionally they have to quickly check over other people's translations | Additionally they have to quickly check over other people's translations | ||
(other people translating the same language) as the other translators | (other people translating the same language) as the other translators | ||
(if any) will have to send their translations to their language maintainer | (if any) will have to send their translations to their language maintainer | ||
− | before inclusion in the | + | before inclusion in the source-code repository. You should also subscribe to the [http://www.wesnoth.org/wiki/WesnothTranslations#Mailing_List wesnoth-i18n mailinglist]. |
Send the files as an archive containing the complete .po files (no .mo or .gmo files) and ensure that they follow the directory structure used in version control. For example, the archive with the German (de) translations should therefore be structured as follows: | Send the files as an archive containing the complete .po files (no .mo or .gmo files) and ensure that they follow the directory structure used in version control. For example, the archive with the German (de) translations should therefore be structured as follows: | ||
Line 26: | Line 26: | ||
the maintainer for their language to see if there is some work to do. | the maintainer for their language to see if there is some work to do. | ||
After you have done some work on the translation you should email it | After you have done some work on the translation you should email it | ||
− | to your language maintainer. | + | to your language maintainer. They will then (if needed) check it over |
before sending it on to the language coordinators. A list of all translators | before sending it on to the language coordinators. A list of all translators | ||
currently working on a language is found on each language page. | currently working on a language is found on each language page. | ||
Line 35: | Line 35: | ||
contact the translation maintainer for the language. | contact the translation maintainer for the language. | ||
If you want to start translation of Wesnoth to a new language, | If you want to start translation of Wesnoth to a new language, | ||
− | first contact Ivanovic | + | first contact Ivanovic. |
And then just follow the instructions written in '' Translators '' . | And then just follow the instructions written in '' Translators '' . | ||
== Translations How-To == | == Translations How-To == | ||
− | + | If you are a translator, see [[GettextForTranslators]] for more information. | |
− | + | ||
− | * | + | If you are a developer or UMC author, gettext internals for Wesnoth are discussed here: [[GettextForWesnothDevelopers]]. For UMC authors, the tool for generating .po files is linked to from [[GettextForWesnothDevelopers#Generating the_.pot_and_.po_files_for_UMC]]. |
− | * | + | |
+ | === Files === | ||
+ | |||
+ | We will use the Swedish (sv) language and the ''wesnoth-editor'' domain as an example. There are three important files for each text-domain: | ||
+ | * ''wesnoth-editor/wesnoth-editor.pot'' file, which is a template containing all the strings used in the domain, but with empty strings instead of a translation. You can see how a ''.pot'' file looks like in the repository : [https://github.com/wesnoth/wesnoth/blob/master/po/wesnoth-editor/wesnoth-editor.pot#L50 Current repository version]. | ||
+ | * ''wesnoth-editor/sv.po'', the file containing the translation, you can see how a ''.po'' file looks like in the repository: [https://github.com/wesnoth/wesnoth/blob/master/po/wesnoth-editor/sv.po#L50 Current repository version]. | ||
+ | * ''{translations_dir}/sv/LC_MESSAGES/wesnoth-editor.mo'', which is a binary version of <lang>.po that the game will use for efficiency reasons. This is not found in the repo, but is created during compilation of the game. | ||
+ | |||
+ | The first of these files, we update every once in a while, when there is new or modified text, | ||
+ | for instance when a new campaign scenario hits the repository. | ||
+ | |||
+ | Then, ''msgmerge'' is used to merge this new "state of the game strings" with your current translations, and generate a new, up-to-date, ''sv.po''. | ||
− | + | Then, a tool called ''msgfmt'' is called, which generates a new ''wesnoth.mo'' file from your ''wesnoth.po'' file, which will be used by the game once installed. | |
+ | |||
+ | "make -C po update-po" does these three steps in one pass. | ||
+ | |||
+ | That was for the "Big Picture". | ||
+ | But you really just need to be concerned with the po file: | ||
+ | translating new strings, checking "fuzzy" entries. | ||
+ | We can handle the administrative tasks of updating etc. | ||
+ | You really don't need to bother with any of these commands, unless you want to compile .mo files to check in-game. | ||
− | + | Ivanovic is now responsible for integrating translations into Wesnoth, with the help of Torangan and ott. | |
+ | You should contact Ivanovic (crazy-ivanovic AT gmx DOT net), and he'll put them in the game. | ||
== Specifying typefaces and fonts for a translation == | == Specifying typefaces and fonts for a translation == | ||
− | Translations in a language which | + | Translations in a language which use characters outside of the Latin, Greek and Cyrillic character sets may want to specify different typefaces. There are some translatable strings in data/hardwired/fonts.cfg which specify the fonts to use; these strings appear in the ''wesnoth'' text domain, and can be configured by putting the required fonts' names as the translations. |
− | + | ||
− | which | + | Note the documentation in data/hardwired/fonts.cfg. |
− | |||
− | |||
== See Also == | == See Also == | ||
Line 62: | Line 80: | ||
* [[TranslatorsGuide]] | * [[TranslatorsGuide]] | ||
* [http://gettext.wesnoth.org Translation statistics] | * [http://gettext.wesnoth.org Translation statistics] | ||
− | |||
[[Category:Translations]] | [[Category:Translations]] |
Revision as of 21:54, 11 October 2021
This page contains information on how-to translate and submit translation updates.
Contents
How to submit your translations
Important: Please do not submit translations as pull requests on the Wesnoth github repository site. While that seems like a good idea, it causes potential complications that we cannot always easily resolve. As a result, we cannot accept translations submitted via pull request and will close such PRs immediately.
Translation Maintainers
The translation maintainers should send the updated/new translation po-files to the language coordinator: Ivanovic (crazy-ivanovic AT gmx DOT net). Additionally they have to quickly check over other people's translations (other people translating the same language) as the other translators (if any) will have to send their translations to their language maintainer before inclusion in the source-code repository. You should also subscribe to the wesnoth-i18n mailinglist.
Send the files as an archive containing the complete .po files (no .mo or .gmo files) and ensure that they follow the directory structure used in version control. For example, the archive with the German (de) translations should therefore be structured as follows:
wesnoth/de.po wesnoth-httt/de.po wesnoth-tutorial/de.po
etc.
Translators
The other translators (those who are not maintainers) should contact the maintainer for their language to see if there is some work to do. After you have done some work on the translation you should email it to your language maintainer. They will then (if needed) check it over before sending it on to the language coordinators. A list of all translators currently working on a language is found on each language page.
NEW Translators
If you want to help out with the translation of an language already started on, contact the translation maintainer for the language. If you want to start translation of Wesnoth to a new language, first contact Ivanovic. And then just follow the instructions written in Translators .
Translations How-To
If you are a translator, see GettextForTranslators for more information.
If you are a developer or UMC author, gettext internals for Wesnoth are discussed here: GettextForWesnothDevelopers. For UMC authors, the tool for generating .po files is linked to from GettextForWesnothDevelopers#Generating the_.pot_and_.po_files_for_UMC.
Files
We will use the Swedish (sv) language and the wesnoth-editor domain as an example. There are three important files for each text-domain:
- wesnoth-editor/wesnoth-editor.pot file, which is a template containing all the strings used in the domain, but with empty strings instead of a translation. You can see how a .pot file looks like in the repository : Current repository version.
- wesnoth-editor/sv.po, the file containing the translation, you can see how a .po file looks like in the repository: Current repository version.
- {translations_dir}/sv/LC_MESSAGES/wesnoth-editor.mo, which is a binary version of <lang>.po that the game will use for efficiency reasons. This is not found in the repo, but is created during compilation of the game.
The first of these files, we update every once in a while, when there is new or modified text, for instance when a new campaign scenario hits the repository.
Then, msgmerge is used to merge this new "state of the game strings" with your current translations, and generate a new, up-to-date, sv.po.
Then, a tool called msgfmt is called, which generates a new wesnoth.mo file from your wesnoth.po file, which will be used by the game once installed.
"make -C po update-po" does these three steps in one pass.
That was for the "Big Picture". But you really just need to be concerned with the po file: translating new strings, checking "fuzzy" entries. We can handle the administrative tasks of updating etc. You really don't need to bother with any of these commands, unless you want to compile .mo files to check in-game.
Ivanovic is now responsible for integrating translations into Wesnoth, with the help of Torangan and ott. You should contact Ivanovic (crazy-ivanovic AT gmx DOT net), and he'll put them in the game.
Specifying typefaces and fonts for a translation
Translations in a language which use characters outside of the Latin, Greek and Cyrillic character sets may want to specify different typefaces. There are some translatable strings in data/hardwired/fonts.cfg which specify the fonts to use; these strings appear in the wesnoth text domain, and can be configured by putting the required fonts' names as the translations.
Note the documentation in data/hardwired/fonts.cfg.