Difference between revisions of "Translation guidance"
(→Translation process) |
|||
(8 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 | + | 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 [ | + | # 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 27: | Line 28: | ||
<br /> | <br /> | ||
Please see the following screenshots:<br /> | Please see the following screenshots:<br /> | ||
− | [[File:Prana_breath_translation_guide_1.png | + | [[File:Prana_breath_translation_guide_1.png]] |
− | [[File:Prana_breath_translation_guide_2.png | + | [[File:Prana_breath_translation_guide_2.png]] |
− | [[File:Prana_breath_translation_guide_3.png | + | [[File:Prana_breath_translation_guide_3.png]] |
− | [[File:Prana_breath_translation_guide_4.png | + | [[File:Prana_breath_translation_guide_4.png]] |
− | [[File:Prana_breath_translation_guide_5.png | + | [[File:Prana_breath_translation_guide_5.png]] |
− | [[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 44: | Line 46: | ||
' | ' | ||
" | " | ||
− | then please add slash before them, as they are used in programming code, and should differ from it. Also keep | + | 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.<br /> |
Example: ''"Time's"'' should be written like ''\"Time\'s\"''.<br /> | Example: ''"Time's"'' should be written like ''\"Time\'s\"''.<br /> | ||
<br /> | <br /> | ||
Line 52: | Line 54: | ||
3. Also there are some formatting html-tags in the app strings that also should be ignored and left where they are.<br /> | 3. Also there are some formatting html-tags in the app strings that also should be ignored and left where they are.<br /> | ||
Example: ''<nowiki>"<b>My goal:</b>"</nowiki>'' (that will be bold in the app) will be translated as ''"<nowiki><b>Моя цель:</b></nowiki>"'' | Example: ''<nowiki>"<b>My goal:</b>"</nowiki>'' (that will be bold in the app) will be translated as ''"<nowiki><b>Моя цель:</b></nowiki>"'' | ||
+ | |||
+ | == Translating wiki pages == | ||
+ | There are a few hints and biases that are important for the proper translation and text formatting:<br /> | ||
+ | 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: <br /> | ||
+ | "Training sounds" is always "Звуки тренировки" in Russian, and no synonyms are used. <br /> | ||
+ | |||
+ | 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: <br /> | ||
+ | <nowiki></b></nowiki>, <nowiki><br /></nowiki>, <nowiki>== Title ==</nowiki>. <br /> | ||
+ | You can use "Paste source text" button so you don't have to type all of the tags and special symbols.<br /> | ||
+ | |||
+ | 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).<br /> | ||
+ | |||
+ | 4. There are internal links to wiki pages and even to certain sections, like this one:<br /> | ||
+ | <nowiki>[[Special:MyLanguage/Training_tab#Look_through_the_training_details|Details]]</nowiki>. <br /> | ||
+ | Please make sure you don't edit/translate the part before '''''the vertical dash''''', but translate the part '''''after'''''. It should be<br /> | ||
+ | <nowiki>[[Special:MyLanguage/Training_tab#Look_through_the_training_details|Детали]]</nowiki> <br /> | ||
+ | in this case. In the real page it will look like:<br /> | ||
+ | [[Special:MyLanguage/Training_tab#Look_through_the_training_details|Details]] and [[Special:MyLanguage/Training_tab#Look_through_the_training_details|Детали]].<br /> | ||
+ | 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.<br /> | ||
+ | |||
+ | 4.1. If you see the internal wiki link doesn't have '''Special:MyLanguage/''' part in it, please '''''add it'''''. Example: <br /> | ||
+ | <nowiki>[[Training_tab#Look_through_the_training_details|Details]]</nowiki> <br /> | ||
+ | should be corrected to<br /> | ||
+ | <nowiki>[[Special:MyLanguage/Training_tab#Look_through_the_training_details|Details]]</nowiki>. <br /> | ||
+ | Sometimes it happens it is missing. This redirect is important so you can land on a page translated to your language.<br /> | ||
+ | |||
+ | 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: <br /> | ||
+ | <nowiki>== <span id="View detailed info about each practice">View detailed info about each practice</span> ==</nowiki><br /> | ||
+ | should be<br /> | ||
+ | <nowiki>== <span id="View detailed info about each practice">Просмотр детальной статистики о каждой практике</span> ==</nowiki><br /> | ||
+ | |||
+ | 4.3. The last line of a tab page should look like the one below:<br /> | ||
+ | <nowiki>[[Category:Tabs{{#translation:}}|Tabs]]</nowiki><br /> | ||
+ | Please edit the label. So in Russian it looks like this:<br /> | ||
+ | <nowiki>[[Category:Tabs{{#translation:}}|Вкладки]]</nowiki><br /> | ||
+ | |||
+ | 5. The link like this <br /> | ||
+ | <nowiki>[https://play.google.com/store/apps/details?id=com.abdula.pranabreath Prana Breath]</nowiki> <br /> | ||
+ | or<br /> | ||
+ | <nowiki>[{{GPLAY_URL}} Prana Breath]</nowiki> | ||
+ | is an external link, and basically it is <br /> | ||
+ | <nowiki>[http://www.example.org Link label]</nowiki>. <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 /> | ||
+ | <nowiki>[https://en.wikipedia.org/wiki/Frederick_Gowland_Hopkins Frederick Hopkins]</nowiki> <br /> | ||
+ | to<br /> | ||
+ | <nowiki>[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 Фредерик Хопкинс]</nowiki><br /> | ||
+ | |||
+ | 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: <br /> | ||
+ | <nowiki>== What can be seen and done in this tab ==</nowiki><br /> | ||
+ | <nowiki>=== In action bar ===</nowiki><br /> | ||
+ | <nowiki>(from left to right)</nowiki><br /> | ||
+ | should be translated with the same words on all the pages about tabs. <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 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!
Contents
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
- Contact us so we can create the translator's account for you.
- Log in the 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.
- Choose the language you're going to translate to.
- Tap on "Translate" on top of the page.
- 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.
- 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.
- 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:
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.