If interested, you can translate KC3改 to your own language.
- Fork
KC3Kai/kc3-translationsrepository - Clone your repo to your local computer
- Make sure
KC3Kai/kc3-translationsis also added as secondary remote - Go to the
datadirectory where you can see language folders, copy one into a new language - Go inside your new language folder, and edit the
jsonfiles - Commit your new language files, and push to your own GitHub repo
- Create a pull request to
KC3Kai/kc3-translations
Promotion to direct write-access
You will first need your own translation fork (as indicated above), and has created a pull-request for the initial translation files for your language. If the language already has a directory, and you want to help existing translators, you will still need a fork, and a pull-request just to see a sample of your work before we can add you on the direct-write access team.
Once these requirements are fulfilled, you may request for promotion:
- Create a new issue on the main
KC3Kairepo - Add
othersandtranslationas label - Subject/Title: Request translation repo access
Then wait until reply, and an invitation to the KC3Kai organization, under the Translation team.
- Download the ZIP file from the project home
- Extract the ZIP on your local computer
- Find the directory
\src\data\translations - Inside, you can see an
enfolder, copy it into a new language - Go inside your new language folder, and edit the
jsonfiles - Create an issue on the main repo, add a label "translation"
- You can name the subject as: "[Translation: (lang_code)] (what_was_translated)"
- For example: "[Translation: JP] Settings Page"
- Paste the translation files / links to its pastebin or puush or any preferred text transmission tool.
The only required file is terms.json. If there are missing files from your translation directory, it will extend the English translations by default.
If there are missing keys in your translated JSON file, it will also extend the English ones by default.
By enabling the setting Dev-Only Strategy Pages, you can check the missing keys in your selected language via Strategy Room Dev-Only Translations page.
These are terms only used by Strategy Room pages. As you know, it's incomplete for now, and welcomed as always that needs help to extract hard-coded texts in main repo (html/js files) into this JSON file.
About the definition of term name, to avoid conflicts and add readabilty, current basic naming scheme is: PageName + RawTextInShort, without any delimeter in upper camel-case.
Even some texts are looked similar or nearly the same, but they may be translated in different way in other languages, so basically do not merge or share them in one name term across different pages. Already existing common terms in terms.json can be re-used, not necessary to add new term in that case.
There are some keys used as meta attributes of quests, such as code, unlock and tracking.
They are not needed to be translated, and can be just omitted in the quests.json of your own language, as long as you do not intend to use different values from English's.
By the way, the values of code in English file are from the quest identifier system defined by wikiwiki.jp/kancolle, which also used by other English wikis.
These Japanese ship class names are basically extracted from in-game ship library banner image. They are supposed to be automatically translated using the same mechanism of ship name translation. So just define your translations in your ships.json and ship_affix.json, and keep the ctype.json being empty (only containing []) in your directory.
Similar with the quests.json, there are keys used as meta data which are not needed to be translated.
The only key required to be translated is name, omitting other keys in your language is fine.
To update the IP address of servers, suggested to execute the script in tools folder, instead of manual modification.
It's a bit complicated about our subtitle mechanism, you might need to learn more from our source code, before another detailed document is ready.
Since game data is already in Japanese, ships.json and items.json do not need to be translated, but will still need to have the files exist, just containing an empty JSON object {}. For more information, please read this.
Generally JSON files are recommended to be saved in Unicode UTF-8 charset.
For Kanji or any non-ascii Unicode character, such as quest descriptions like
Have Tenryuu (\u5929\u9f8d) and Tatsuta (\u9f8d\u7530) in your main fleet.
It is your choice if you want to still include Kanji representations like (\u5929\u9f8d) in your own language.
But do remember to use escaped chars like \uHHHH instead of literal Kanji or non-ascii chars, if you are not sure how to save your JSON file in UTF-8 charset.
For several languages, there are extra notes and rules:
Make sure to read them before contribution.