Difference between revisions of "Translating Mudlet"

From Mudlet
Jump to navigation Jump to search
(Marked this version for translation)
Line 1: Line 1:
 
{{TOC right}}
 
{{TOC right}}
 
<languages/>
 
<languages/>
<translate>Thanks for helping translate Mudlet to your language! Mudlet is a free, open-source project and helping it speak your language means a lot to us. :)</translate>
+
<translate><!--T:1--> Thanks for helping translate Mudlet to your language! Mudlet is a free, open-source project and helping it speak your language means a lot to us. :)</translate>
  
<translate>== How to start? ==</translate>
+
<translate>== How to start? == <!--T:2--></translate>
 
<translate>
 
<translate>
 +
<!--T:3-->
 
* Go to [https://crowdin.com/project/mudlet Mudlet on Crowdin]
 
* Go to [https://crowdin.com/project/mudlet Mudlet on Crowdin]
 
* Select the language you'd like to translate.
 
* Select the language you'd like to translate.
Line 13: Line 14:
 
</translate>
 
</translate>
  
<translate>== How to test my translation? ==</translate>
+
<translate>== How to test my translation? == <!--T:4--></translate>
  
<translate>[https://github.com/mudlet/mudlet/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22new+crowdin+translations%22 Go here] and click on 'New Crowdin translations'. You can then download a test version of Mudlet that has your latest translations.</translate>
+
<translate><!--T:5--> [https://github.com/mudlet/mudlet/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+%22new+crowdin+translations%22 Go here] and click on 'New Crowdin translations'. You can then download a test version of Mudlet that has your latest translations.</translate>
  
 
== How to get a gold star? ==
 
== How to get a gold star? ==
Line 32: Line 33:
 
* Click Context to always display information on where the current string is used exactly. Sometimes you can even see screenshots here for comparison.
 
* Click Context to always display information on where the current string is used exactly. Sometimes you can even see screenshots here for comparison.
  
<translate>== Other translations needed? ==</translate>
+
<translate>== Other translations needed? == <!--T:6--></translate>
  
<translate>Below the file mentioned above, you can find more content from Mudlet website and wiki. For example, international users want to read new release notes or documentation for specific Mudlet functionality, at best in their own language.</translate>
+
<translate><!--T:7--> Below the file mentioned above, you can find more content from Mudlet website and wiki. For example, international users want to read new release notes or documentation for specific Mudlet functionality, at best in their own language.</translate>
  
<translate>== How to coordinate? ==</translate>
+
<translate>== How to coordinate? == <!--T:8--></translate>
  
<translate>A simple chat functionality exists in Crowdin: You can comment on each text seperately. This way, you can also give feedback to Mudlet developers. </translate>
+
<translate><!--T:9--> A simple chat functionality exists in Crowdin: You can comment on each text seperately. This way, you can also give feedback to Mudlet developers. </translate>
  
<translate>However, if you want to coordinate more thoroughly, please feel free to join us on [https://www.mudlet.org/contact/ Discord] or in [https://forums.mudlet.org/viewforum.php?f=14 Mudlet's international forum]. Doing that, you can easily establish a more permanent contact with other translators and continue from there.</translate>
+
<translate><!--T:10--> However, if you want to coordinate more thoroughly, please feel free to join us on [https://www.mudlet.org/contact/ Discord] or in [https://forums.mudlet.org/viewforum.php?f=14 Mudlet's international forum]. Doing that, you can easily establish a more permanent contact with other translators and continue from there.</translate>
  
 
== Special notes on separate translations ==
 
== Special notes on separate translations ==

Revision as of 05:40, 16 August 2019

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎français • ‎italiano • ‎polski • ‎suomi • ‎Ελληνικά • ‎русский • ‎العربية • ‎한국어

Thanks for helping translate Mudlet to your language! Mudlet is a free, open-source project and helping it speak your language means a lot to us. :)

How to start?

  • Go to Mudlet on Crowdin
  • Select the language you'd like to translate.
  • Log in
  • Select development - translations - mudlet.ts
Mudlet-translation-file.png
  • Start translating!

How to test my translation?

Go here and click on 'New Crowdin translations'. You can then download a test version of Mudlet that has your latest translations.

How to get a gold star?

Translating a language above 95% will earn it a gold star.

in this example, the bar is at 30%, but real Mudlet has it at 95%

Can I translate on my phone?

Yep! Crowdin's translation interface is mobile-friendly. Kill some commute time by helping translate!

Suggested settings in Crowdin

  • In options, hide html code, so it will display shortened as <1> and </1> for example.
  • Click Context to always display information on where the current string is used exactly. Sometimes you can even see screenshots here for comparison.

Other translations needed?

Below the file mentioned above, you can find more content from Mudlet website and wiki. For example, international users want to read new release notes or documentation for specific Mudlet functionality, at best in their own language.

How to coordinate?

A simple chat functionality exists in Crowdin: You can comment on each text seperately. This way, you can also give feedback to Mudlet developers.

However, if you want to coordinate more thoroughly, please feel free to join us on Discord or in Mudlet's international forum. Doing that, you can easily establish a more permanent contact with other translators and continue from there.

Special notes on separate translations

English (American) translation

Note Note: This section is a note for Mudlet developers only :)

This is a special case that is handled internally as the CrowdIn system does not allow for one target locale to only contain the plural form when the remainder of the source texts are in the required language already. The translation file thus consists only of translations that contain a numerus (quantity-dependent) translation where the source text varies depending on a quantity, e.g. "You have just destroyed %n room(s)...!". In English this means that there are two plural forms one for the single (one room) case and the other for all other quantities (many or no rooms). For this example text it would require the two translations "You have just destroyed a room...!" and "You have just destroyed %n rooms...!".

N.B. Others language have other variations (for instance French uses an additional "s" for the zero case, as well as the more than one, one; on the other hand Japanese has only one form for all quantities, in comparison Russian has a more complex systems with three variations, see Translation Rules for Plurals for the details).

For the developer who is in the root of the source code, (ensure you are using the latest version you can of the following Qt utilities):

lupdate -pluralonly ./src/ ./3rdparty/dblsqd/dblsqd ./3rdparty/edbee-lib/edbee-lib -ts ./translations/translated/mudlet_en_US.ts will ensure the translation file is up to date.
linguist ./translations/translated/mudlet_en_US.ts will allow editing the translation for this locale.
the resulting file will then be converted into the binary ./translations/translated/mudlet_en_US.qm file to be included into the main Mudlet resources along with the other translations when the project is next compiled.