You will need to use a version controlled hosting for the mod. Github, Bitbucket, any other git (or even mercurial, subversion) hosting should do. Easiest to use is Github.
Once you have that, you can start preparing the mod. That basically boils down to having proper file and directory names and correct encodings. Because Weblate cannot guess those things, you should follow the convention to provide this info.
If you're having problems with these instructions, refer to Ascension repo for live example. If still not clear, ask on the forum.
1. Dedicate a separate directory to translations. It could be "tra", or "language", or anything else. Just don't store other stuff in that directory.
Example:
Code: Select all
ascension/lang/english
ascension/lang/french
Code: Select all
ascension/lang/spanish
ascension/lang/polish
4. Ensure that all EE-only strings are stored in files ending with "_ee.tra" or named "ee.tra" AND they are encoded in UTF-8.
Code: Select all
ascension/lang/spanish/ee.tra
ascension/lang/spanish/dialog_ee.tra
5. Ensure that all remaning files are using proper encoding, as per WeiDU documentation.
Special note: setup.tra/install.tra in Russian must be in cp866, not cp1251.
6. Ensure that all existing translations are actual:
- There are no, say, english strings in french tra files
- There are no outdated strings (when a source language string was updated, but translation was not).
Delete any such strings.
7. (For the time being) Ensure that source tra files are delimited by tildes: @1= ~Test~ (as opposed to quotes @1= "Test"). For now only tildes are supported.
8. Create a .bgforge.yml file. It shows where the translation files should be found. The two directives are "tra_dir" (directory with translations) and "src_lang" (source language). Defaults values are "tra" and "english". If your values differ from defaults, you need to specify them in the config.
Example:
Code: Select all
translation:
tra_dir: ascension/lang # if this is just "tra", you don't need to specify it
src_lang: russian # if this is "english", you don't need to specify it
10. Create a request topic here, specifying mod name and repo url.
If you have existing translations, they can be pre-loaded.
11. Subscribe to github integration annoucement topic.