Difference between revisions of "Translation guidance"

From Olekdia Wiki
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<noinclude>
 
The goal of Prana Breath app is to help people to better their life with breathing practices, and for most people it is more convenient to do that using their native language. That's why we are so exited when another volunteer translator appears!<br />
 
The goal of Prana Breath app is to help people to better their life with breathing practices, and for most people it is more convenient to do that using their native language. That's why we are so exited when another volunteer translator appears!<br />
  
Line 7: Line 8:
  
 
== How to start translating ==
 
== How to start translating ==
If you'd like to translate the app to your language that is not in the list above, or would like to correct something in existing translation, please feel free to [mailto:olekdia@gmail.com?subject=Prana+Breath+translation contact us]! We will create a new translator's account, as we have locked the ability to translate without logging in in order to avoid spam.<br />
+
If you'd like to translate the app to your language that is or is not in the list above, or would like to correct something in existing translation, please feel free to [mailto:pranabreath@olekdia.groups.io?subject=Prana+Breath+#translation contact us]! We will create a new translator's account, as we have locked the ability to translate without logging in in order to avoid spam.<br />
 
For your help we would gladly grant you promo-codes for "Guru forever" version, and, if you wish, would add your name and link to your website/social profile to "About" tab in the app, so you can get some public attention and even new clients.
 
For your help we would gladly grant you promo-codes for "Guru forever" version, and, if you wish, would add your name and link to your website/social profile to "About" tab in the app, so you can get some public attention and even new clients.
  
Line 18: Line 19:
 
== Translation process ==
 
== Translation process ==
 
# [mailto:olekdia@gmail.com?subject=Prana+Breath+translation Contact us] so we can create the translator's account for you.
 
# [mailto:olekdia@gmail.com?subject=Prana+Breath+translation Contact us] so we can create the translator's account for you.
# Log in the [http://http://pranabreath.info site of Prana Breath] (see top right corner), using login and password you've received in the letter from us.
+
# Log in the [https://pranabreath.info/wiki wiki of Prana Breath] (see top right corner), using login and password you've received in the letter from us.
 
# Go to [[App strings]] page. If you're using your mobile device, please go to the bottom of the page and choose "Desktop" version so you can edit the strings with no problems.
 
# Go to [[App strings]] page. If you're using your mobile device, please go to the bottom of the page and choose "Desktop" version so you can edit the strings with no problems.
 
# Choose the language you're going to translate to.
 
# Choose the language you're going to translate to.
Line 34: Line 35:
 
[[File:Prana_breath_translation_guide_6.png]]
 
[[File:Prana_breath_translation_guide_6.png]]
 
[[File:Prana_breath_translation_guide_7.png]]
 
[[File:Prana_breath_translation_guide_7.png]]
 +
</noinclude>
  
 
== Tips and explanations ==
 
== Tips and explanations ==
Line 94: Line 96:
 
is an external link, and basically it is <br />
 
is an external link, and basically it is <br />
 
   <nowiki>[http://www.example.org Link label]</nowiki>. <br />
 
   <nowiki>[http://www.example.org Link label]</nowiki>. <br />
You can edit link label if needed, but please leave the link (or the {{template}}) the way it is. As for the name of the app, you can leave it in English as users see this name every time they tap on the app's shortcut to open it.<br />
+
You can edit link label if needed, but please leave the link (or the <nowiki>{{template}}</nowiki>) the way it is. As for the name of the app, you can leave it in English as users see this name every time they tap on the app's shortcut to open it.<br />
  
 
5.1. You can edit the external link in case it leads to wikipedia page that exists in your language. Example: <br />
 
5.1. You can edit the external link in case it leads to wikipedia page that exists in your language. Example: <br />
Line 108: Line 110:
 
6.1. You can use "Suggestions", in the section right to the translation field, under "Documentation". If wikiTranslate has "seen" something similar to the current string, in this section you may see some alike translations you (probably) have used before. Sometimes it guesses right! )<br />
 
6.1. You can use "Suggestions", in the section right to the translation field, under "Documentation". If wikiTranslate has "seen" something similar to the current string, in this section you may see some alike translations you (probably) have used before. Sometimes it guesses right! )<br />
  
7. I'm (Nadia, a humble author of all texts on this wiki) not a native English speaker, and am just a human being, so I can make mistakes. If you see one, please contact me via telegram so I can correct it. Please don't edit English page by yourself, as it will create a mess for translation pages. But if you'd like to edit it anyway, contact me so I can tell you how to do it right.
+
7. I am (Nadia, a humble author of all texts on this wiki) not a native English speaker, and am just a human being, so I can make mistakes. If you see one, please contact me via telegram so I can correct it. Please don't edit English page by yourself, as it will create a mess for translation pages. But if you'd like to edit it anyway, contact me so I can tell you how to do it right.

Latest revision as of 15:52, 10 January 2019

The goal of Prana Breath app is to help people to better their life with breathing practices, and for most people it is more convenient to do that using their native language. That's why we are so exited when another volunteer translator appears!

Languages in the app

For this very moment we have the app translated to the following languages:

Language Messages Untranslated Completion Reviewed Outdated
ar: Arabic 717 0 100% 0% 0%
az: Azerbaijani 717 11 98% 0% 0%
be: Belarusian 717 11 98% 0% 0%
bg: Bulgarian 717 0 100% 6% 0%
bn: Bangla 717 592 17% 0% 0%
ca: Catalan 717 11 98% 0% 0%
cs: Czech 717 11 98% 0% 0%
da: Danish 717 146 79% 0% 0%
de: German 717 0 100% 0% 0%
el: Greek 717 23 96% 4% 0%
es: Spanish 717 0 100% 0% 0%
es-formal: español (formal) 717 462 35% 0% 0%
et: Estonian 717 23 96% 0% 0%
fa: Persian 717 0 100% 26% 0%
fi: Finnish 717 11 98% 0% 0%
fr: French 717 0 100% 0% 0%
gu: Gujarati 717 23 96% 9% 0%
he: Hebrew 717 23 96% 0% 0%
hi: Hindi 717 0 100% 0% 0%
hr: Croatian 717 592 17% 0% 0%
hu: Hungarian 717 0 100% 18% 0%
id: Indonesian 717 0 100% 0% 0%
it: Italian 717 0 100% 0% 0%
ja: Japanese 717 0 100% 9% 0%
ka: Georgian 717 24 96% 0% 0%
kn: Kannada 717 11 98% 0% 0%
ko: Korean 717 20 97% 65% 0%
lt: Lithuanian 717 406 43% 0% 0%
lv: Latvian 717 500 30% 0% 0%
mr: Marathi 717 11 98% 0% 0%
ms: Malay 717 11 98% 0% 0%
my: Burmese 717 222 69% 0% 0%
nl: Dutch 717 0 100% 0% 0%
nn: Norwegian Nynorsk 717 277 61% 0% 0%
pl: Polish 717 0 100% 0% 0%
pt: Portuguese 717 11 98% 0% 0%
qqq: Message documentation 717 502 29% 0% 0%
ro: Romanian 717 0 100% 50% 0%
ru: Russian 717 0 100% 0% 0%
sh: Serbo-Croatian 717 557 22% 0% 0%
sk: Slovak 717 11 98% 0% 0%
sr-ec: Serbian (Cyrillic script) 717 0 100% 18% 0%
sv: Swedish 717 0 100% 0% 0%
ta: Tamil 717 460 35% 0% 0%
th: Thai 717 11 98% 0% 0%
tl: Tagalog 717 449 37% 0% 0%
tr: Turkish 717 0 100% 0% 0%
uk: Ukrainian 717 0 100% 0% 0%
uz: Uzbek 717 478 33% 0% 0%
vi: Vietnamese 717 0 100% 0% 0%
yue: Cantonese 717 536 25% 0% 0%
zh: Chinese 717 11 98% 88% 0%
zh-cn: Chinese (China) 717 0 100% 29% 0%
zh-tw: Chinese (Taiwan) 717 375 47% 0% 0%
All 54 languages together 38,718 6,822 82% 7% 0%

How to start translating

If you'd like to translate the app to your language that is or is not in the list above, or would like to correct something in existing translation, please feel free to contact us! We will create a new translator's account, as we have locked the ability to translate without logging in in order to avoid spam.
For your help we would gladly grant you promo-codes for "Guru forever" version, and, if you wish, would add your name and link to your website/social profile to "About" tab in the app, so you can get some public attention and even new clients.

Text for translation

There are 3 main pages with the text to be translated:

Translation process

  1. Contact us so we can create the translator's account for you.
  2. Log in the wiki of Prana Breath (see top right corner), using login and password you've received in the letter from us.
  3. Go to App strings page. If you're using your mobile device, please go to the bottom of the page and choose "Desktop" version so you can edit the strings with no problems.
  4. Choose the language you're going to translate to.
  5. Tap on "Translate" on top of the page.
  6. Click on "Untranslated" to see the text for translation OR click on "Translate to ..." item on the right to suggest the translation to the language that is not in Time Planner yet.
  7. You will see a string to be translated and a window where you can type it translated. Note that the explanation of the context (if needed) is on the right.
  8. Enter your translation and click "Save translation" button. You will automatically be directed to the next string. You can always edit what you (or someone else before you) have written.


Please see the following screenshots:
Prana breath translation guide 1.png Prana breath translation guide 2.png Prana breath translation guide 3.png Prana breath translation guide 4.png Prana breath translation guide 5.png Prana breath translation guide 6.png Prana breath translation guide 7.png


Tips and explanations

1. Please use punctuation marks that are distinctive for your language (you can read more about it here). If you use the following apostrophe and quotation marks:

    ’
    “”
    «»

Just leave them as they are. If you use another ones like this (straight ones):

    ' 
    " 

then please add slash before them, as they are used in programming code, and should differ from it. Also keep consistence with those marks through the whole document.
Example: "Time's" should be written like \"Time\'s\".

2. You can find some special characters in the app strings. Those are the parts of the code that substitute a certain value/number, so please read the explanation on the right and don't delete it from the string. You can use "Paste source text" button so you should not type those characters.
Example: "Repeat every %1$s %2$s" (that will give "Repeat every 2 days" in the output) can be translated to "Повторять каждые %1$s %2$s".

3. Also there are some formatting html-tags in the app strings that also should be ignored and left where they are.
Example: "<b>My goal:</b>" (that will be bold in the app) will be translated as "<b>Моя цель:</b>"

Translating wiki pages

There are a few hints and biases that are important for the proper translation and text formatting:
1. Make sure every entity in the translation is named the very same way as in the app. Please look through the app or ask Nadia so you can be sure what you're writing about. Example:

 "Training sounds" is always "Звуки тренировки" in Russian, and no synonyms are used. 

2. Please leave all tags and special symbols where they are, as they define the formatting of the wiki text shown on a page. Examples:

 </b>, <br />, == Title ==. 

You can use "Paste source text" button so you don't have to type all of the tags and special symbols.

3. For wiki pages, there is no need to put a slash in front of brackets, whatever ones you use. Unlike for app strings (see the previous chapter of this page).

4. There are internal links to wiki pages and even to certain sections, like this one:

 [[Special:MyLanguage/Training_tab#Look_through_the_training_details|Details]]. 

Please make sure you don't edit/translate the part before the vertical dash, but translate the part after. It should be

 [[Special:MyLanguage/Training_tab#Look_through_the_training_details|Детали]] 

in this case. In the real page it will look like:

 Details and Детали.

As you might see, those links lead to the very same page, but the ones who have Russian as their language (see on top of this page, left to your account name), will see the Russian translation of this page. You can use any grammatical cases, if needed and if applicable.

4.1. If you see the internal wiki link doesn't have Special:MyLanguage/ part in it, please add it. Example:

 [[Training_tab#Look_through_the_training_details|Details]] 

should be corrected to

 [[Special:MyLanguage/Training_tab#Look_through_the_training_details|Details]]. 

Sometimes it happens it is missing. This redirect is important so you can land on a page translated to your language.

4.2. Some of section titles have "span" tag, as it is needed for the proper internal redirect. Please translate the text inside the tag, like this:

 == <span id="View detailed info about each practice">View detailed info about each practice</span> ==

should be

 == <span id="View detailed info about each practice">Просмотр детальной статистики о каждой практике</span> ==

4.3. The last line of a tab page should look like the one below:

 [[Category:Tabs{{#translation:}}|Tabs]]

Please edit the label. So in Russian it looks like this:

 [[Category:Tabs{{#translation:}}|Вкладки]]

5. The link like this

 [https://play.google.com/store/apps/details?id=com.abdula.pranabreath Prana Breath] 

or

 [{{GPLAY_URL}} Prana Breath]

is an external link, and basically it is

 [http://www.example.org Link label]. 

You can edit link label if needed, but please leave the link (or the {{template}}) the way it is. As for the name of the app, you can leave it in English as users see this name every time they tap on the app's shortcut to open it.

5.1. You can edit the external link in case it leads to wikipedia page that exists in your language. Example:

 [https://en.wikipedia.org/wiki/Frederick_Gowland_Hopkins Frederick Hopkins] 

to

 [https://ru.wikipedia.org/wiki/%D0%A5%D0%BE%D0%BF%D0%BA%D0%B8%D0%BD%D1%81,_%D0%A4%D1%80%D0%B5%D0%B4%D0%B5%D1%80%D0%B8%D0%BA_%D0%93%D0%BE%D1%83%D0%BB%D0%B5%D0%BD%D0%B4 Фредерик Хопкинс]

6. Please keep the translation consistent, meaning if you have alike text in a few pages, translate it the very same way every time. Example:

 == What can be seen and done in this tab ==
=== In action bar ===
(from left to right)

should be translated with the same words on all the pages about tabs.
6.1. You can use "Suggestions", in the section right to the translation field, under "Documentation". If wikiTranslate has "seen" something similar to the current string, in this section you may see some alike translations you (probably) have used before. Sometimes it guesses right! )

7. I am (Nadia, a humble author of all texts on this wiki) not a native English speaker, and am just a human being, so I can make mistakes. If you see one, please contact me via telegram so I can correct it. Please don't edit English page by yourself, as it will create a mess for translation pages. But if you'd like to edit it anyway, contact me so I can tell you how to do it right.