In order to edit this wiki, you must register and verify your account.
Tutorial:How to translate Cemu UI: Difference between revisions
From Cemu Wiki
m (→Testing/Using) |
(Added guidelines and updated mantainers) |
||
| Line 1: | Line 1: | ||
==Tutorial== | ==Tutorial== | ||
*Download and install your favorite PO editing tool, e.g.[https://poedit.net/ Poedit]. | *Download and install your favorite PO editing tool, e.g. [https://poedit.net/ Poedit]. | ||
*Choose the language you want to translate: | *Choose the language you want to translate: | ||
**fetch the latest PO file for an existing language from [https://github.com/TeamCemu/Cemu-Language/tree/master/resources here] and open it | **fetch the latest PO file for an existing language from [https://github.com/TeamCemu/Cemu-Language/tree/master/resources here] and open it | ||
**create a new translation and use the English [https://github.com/TeamCemu/Cemu-Language/blob/master/resources/en/cemu.pot cemu.pot file] as source | **create a new translation and use the English [https://github.com/TeamCemu/Cemu-Language/blob/master/resources/en/cemu.pot cemu.pot file] as source | ||
*Submit your finished work by either using a | *Submit your finished work by either using a GitHub pull request (learn about them [https://help.github.com/articles/creating-a-pull-request/ here]), or by sending it in Discord to one of the users listed below. | ||
==General translation guidelines== | |||
* '''Don't overtranslate technical terms.''' Translate English technical terms (e.g. ''stack, v-sync, upscaling'' etc.) into your language only if there's a commonly used equivalent word. In a nutshell: ''avoid literal translations that don't mean anything.'' If in doubt, use your country's Wikipedia for reference or check how the same word has been translated in other programs. If both the original and the translated term are used in your language, prefer the English one (unless it's rarely used). | |||
* '''Keep your work updated, if you can.''' Cemu is an actively mantained project and updates often brings new strings and/or remove some old ones. Therefore you are encouraged to update your translation whenever the English .pot file is updated by Cemu developers (usually a few days after a new release). No hurry needed :) | |||
* '''Disagree with a translation made by another user?''' There are [https://github.com/TeamCemu/Cemu-Language/issues GitHub issues] to give contributors the opportunity to discuss their opinions and reach a conclusion. Just use them if you feel like it. | |||
==Testing/Using new languages== | ==Testing/Using new languages== | ||
| Line 16: | Line 21: | ||
# Select the correct folder as destination | # Select the correct folder as destination | ||
== | ==Repository mantainers== | ||
These | These Discord users have write access to the [https://github.com/TeamCemu/Cemu-Language GitHub repository] and can update files. | ||
If you're not a member of our | If you're not a member of our Discord server yet, you can join us [https://discord.gg/5psYsup here]. | ||
*Petergov#3780 | *Petergov#3780 | ||
*Fs00#9393 | |||
[[Category:List of tutorials|How to translate Cemu UI]] | [[Category:List of tutorials|How to translate Cemu UI]] | ||
Revision as of 15:20, 2 September 2018
Tutorial
- Download and install your favorite PO editing tool, e.g. Poedit.
- Choose the language you want to translate:
- fetch the latest PO file for an existing language from here and open it
- create a new translation and use the English cemu.pot file as source
- Submit your finished work by either using a GitHub pull request (learn about them here), or by sending it in Discord to one of the users listed below.
General translation guidelines
- Don't overtranslate technical terms. Translate English technical terms (e.g. stack, v-sync, upscaling etc.) into your language only if there's a commonly used equivalent word. In a nutshell: avoid literal translations that don't mean anything. If in doubt, use your country's Wikipedia for reference or check how the same word has been translated in other programs. If both the original and the translated term are used in your language, prefer the English one (unless it's rarely used).
- Keep your work updated, if you can. Cemu is an actively mantained project and updates often brings new strings and/or remove some old ones. Therefore you are encouraged to update your translation whenever the English .pot file is updated by Cemu developers (usually a few days after a new release). No hurry needed :)
- Disagree with a translation made by another user? There are GitHub issues to give contributors the opportunity to discuss their opinions and reach a conclusion. Just use them if you feel like it.
Testing/Using new languages
If you want to test your translation or use an existing translation from the repository/another user, simply create the folder with the correct language code in "cemu/resources" and insert the compiled "cemu.mo" file.
Supported language codes can be found here: language codes.
You can use Poedit to compile a MO file:
- Open the PO
- Use the menu bar: File -> Compile to MO...
- Select the correct folder as destination
Repository mantainers
These Discord users have write access to the GitHub repository and can update files. If you're not a member of our Discord server yet, you can join us here.
- Petergov#3780
- Fs00#9393