Merge pull request #3441 from heroesiiifan/patch-5

Extended Translations.md

docs/modders/Translations.md

@@ -28,10 +28,12 @@ This is list of all languages that are currently supported by VCMI. If your lang
 
 VCMI allows translating game data into languages other than English. In order to translate Heroes III in your language easiest approach is to:
 
-- Copy existing translation, such as English translation from here: https://github.com/vcmi-mods/h3-for-vcmi-englisation
+- Copy existing translation, such as English translation from here: https://github.com/vcmi-mods/h3-for-vcmi-englisation (delete sound and video folders)
 - Rename mod to indicate your language, preferred form is "(language)-translation"
 - Update mod.json to match your mod
 - Translate all texts strings from game.json, campaigns.json and maps.json
+- Replace images in data and sprites with translated ones (or delete it if you don't want to translate them)
+- If unicode characters needed for language: Create a submod with a free font like here: https://github.com/vcmi-mods/vietnamese-translation/tree/vcmi-1.4/vietnamese-translation/mods/VietnameseTrueTypeFonts
 
 If you have already existing Heroes III translation you can:
 
@@ -48,6 +50,7 @@ VCMI contains several new strings, to cover functionality not existing in Heroes
 - In-game texts, most noticeably - in-game settings menu.
 - Game Launcher
 - Map Editor
+- Linux specific
 - Android Launcher
 
 Before you start, make sure that you have copy of VCMI source code. If you are not familiar with git, you can use Github Desktop to clone VCMI repository.
@@ -75,7 +78,8 @@ Translation of Map Editor is identical, except for location of translation files
 
 TODO: how to test translation locally
 
-### Translation of AppStream metainfo
+### Translation of Linux specific files
+#### Translation of AppStream metainfo
 
 The [AppStream](https://freedesktop.org/software/appstream/docs/chap-Metadata.html) [metainfo file](https://github.com/vcmi/vcmi/blob/develop/launcher/eu.vcmi.VCMI.metainfo.xml) is used for Linux software centers.
 
@@ -83,11 +87,16 @@ It can be translated using a text editor or using [jdAppStreamEdit](https://flat
 - Install jdAppStreamEdit
 - Open `<VCMI>/launcher/eu.vcmi.VCMI.metainfo.xml`
 - Translate and save the file
+  
+#### Desktop file
+- Edit `<VCMI>/launcher/vcmilauncher.desktop` and `<VCMI>/launcher/vcmieditor.desktop`
+- Add `GenericName[xyz]` and `Comment[xyz]` with your language code and translation
 
 ### Translation of Android Launcher
+- Copy `<VCMI>/android/vcmi-app/src/main/res/values/strings.xml` to `<VCMI>/android/vcmi-app/src/main/res/values-xyz/strings.xml` (`xyz` is your language code)
+- Translate this file
 
-TODO
-see https://github.com/vcmi/vcmi/blob/develop/android/vcmi-app/src/main/res/values/strings.xml
+See also here: https://developer.android.com/guide/topics/resources/localization
 
 ### Submitting changes