From 992900728fa359ecb56c77f583ea4eeeb83d9d86 Mon Sep 17 00:00:00 2001 From: heroesiiifan <77574150+heroesiiifan@users.noreply.github.com> Date: Fri, 5 Jan 2024 22:02:14 +0000 Subject: [PATCH] Update Translations.md --- docs/modders/Translations.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/modders/Translations.md b/docs/modders/Translations.md index 00a836129..1428ec28d 100644 --- a/docs/modders/Translations.md +++ b/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 `/launcher/eu.vcmi.VCMI.metainfo.xml` - Translate and save the file + +#### Desktop file +- Edit `/launcher/vcmilauncher.desktop` and `/launcher/vcmieditor.desktop` +- Add `GenericName[xyz]` and `Comment[xyz]` with your language code and translation ### Translation of Android Launcher +- Copy `/android/vcmi-app/src/main/res/values/strings.xml` to `/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