Translate a Page: Difference between revisions

From KDE Wiki Sandbox
No edit summary
(Marked this version for translation)
 
(35 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Available Tools ==
<languages />
* [[Translation Workflow|Translation Workflow]] describes the workflow to migrate to the new translation system
<translate>


== Workflow ==
== Available Tools == <!--T:1-->


* Request addition to the Translator group by posting a message with the language you wish to translate for in [[User_talk:Annew]]
<!--T:2-->
* When your user has been added, click on '''[[Special:LanguageStats|Translation Tool]]''' in the sidebar
* [[Special:myLanguage/Translation Workflow|Translation Workflow]] describes the workflow to migrate to the new translation system
* Enter the language you want to translate to in '''Language code''' and click on '''Go'''


:{|cellpadding="2"
== Workflow == <!--T:3-->
|[[Image:Im-status-message-edit.png]]||'''Note'''||Entering ''en'' (English) as the language code won't display any translation statistics since it's the source language
 
<!--T:4-->
* Request addition to the Translator group:
** Click on [[Special:myLanguage/Translator Account|Get a Translator Account]] in the sidebar
** Click on the <menuchoice>Edit</menuchoice> icon [[Image:Userbase-edit.png|14px]] and enter your username, the language you want to translate for and if you intend to translate off-line
** Use <menuchoice>Save page</menuchoice> to save the information
 
<!--T:5-->
* When your user has been added to the group (you should get an e-mail notification), click on [[Special:LanguageStats|Start Translating]] in the sidebar
 
<!--T:6-->
* If the UserBase interface is in English and there are no any page titles showed on the page, you may need to enter the language you want to translate to in <menuchoice>Language code</menuchoice> and click on <menuchoice>Go</menuchoice>.
 
<!--T:7-->
{{Note|Entering ''en'' (English) as the language code won't display any untranslated messages since all original content is written in English}}
 
<!--T:8-->
* Click on a page you want to translate in the list
 
<!--T:9-->
* In the '''Translate page''', set <menuchoice>View all untranslated messages</menuchoice> in the first drop-down list or you can choose <menuchoice>Review all translated messages</menuchoice> to improve the translated messages
 
<!--T:10-->
* Check that the correct language code is showing
 
<!--T:11-->
* In the <menuchoice>Navigation</menuchoice> section, click on the link to the left of the message you want to translate
 
<!--T:12-->
* Enter the translation - a Google translation is provided for reference, but your own translation is usually preferred.
 
<!--T:13-->
* Click on <menuchoice>Save and open next</menuchoice> to continue with the next message or <menuchoice>Save page</menuchoice> to save the translation if you wish to stop working.
 
<!--T:14-->
{{Warning|1=Do not create a localized page variant manually (by entering pagename/langcode and trying to translate the original). This will mess up the translation system and no translation will be shown at all.}}
 
== Hints and Tips == <!--T:15-->
 
===Image display instructions=== <!--T:16-->
 
<!--T:17-->
A typical example is <nowiki>[[Image:Plasma-kickoff.jpg|right|160px]]</nowiki>.  The whole of this is a system instruction on how to display the image.  None of it is translated.
 
===Category statements=== <!--T:18-->
 
<!--T:19-->
In this context, think of the word "Category" as a system word which therefore should not be translated.  For example, <nowiki>[[Category:Administration]]</nowiki> would become <nowiki>[[Category:Administrasi/id]]</nowiki>
 
<!--T:20-->
For consistency, we have lists of approved translations of categories, and ask you to use them.  You can find one suited to your language linked from [[Translation_Help_Needed]].  If there are any blanks in your table, feel free to add a suitable translation.
 
===Links to other pages on UserBase=== <!--T:21-->
 
<!--T:22-->
These take the form <nowiki>[[Special:myLanguage/Other page|link text]]</nowiki>  The link should remain untranslated, whereas the link text should always be translated.  If no link text is present, please add a suitable (translated) link text. Note, that this also goes for subpage links, ie. links of the form <nowiki>[[Special:myLanguage/Page#Section|link text]]</nowiki>.
 
<!--T:23-->
Note: "myLanguage" will try to load the translated version of the link in the language you have set in your user preferences. If it fails to load it will just load the English original, so it is safe to use it for any internal link.
 
===Links to external sites=== <!--T:24-->
 
<!--T:25-->
These take the form  <nowiki>[http://example.com link text]</nowiki>  Like the internal links, retain the actual link and translate the link text.
 
=== Links in the Sidebar === <!--T:43-->
 
<!--T:44-->
Instructions for translating those sidebar links can be found at [[Modifying_the_Sidebar#Translating_Sidebar_Items]]
 
 
===Info-boxes=== <!--T:26-->
 
<!--T:27-->
These generally consist of a header word "Information" or "Note" and an editable information text. If the word "Information" is not in your language, you may need a localized version of the template.
 
<!--T:45-->
{|class="tablecenter vertical-centered"
|Usually, you need to add a forward slash and a specific language code to show the title in your own language. For example, in the picture on the right-hand side, <code>zh-cn</code> is the language code for Chinese(China Mainland)
|[[Image:Info box translation.jpg|center]]
|}
|}


* Click on a page you want to translate
<!--T:46-->
* In the ''Translate page'' under ''Navigation'', click on the link to the left of the message you want to translate
The following pictures show the result:
* Enter the translation
 
* Click on '''Save page''' to save the translation or '''Save and open next''' to continue with the next message
<!--T:47-->
{|class="tablecenter vertical-centered"
|Before: [[Image:Info box (before translated).png|center]]
|After: [[Image:Info box (after adding Chinese language code).png.png|center]]
|}
 
=== Translated units are marked as fuzzy === <!--T:28-->
 
<!--T:29-->
Sometimes it may happen that you have translated a page, but the translation is marked as incomplete. Certain errors in the markup of the original page can cause this. The most common type of error is the appearance of unbalanced brackets or parentheses. The translation system requires that all opening brackets ('[', '{' or '(' ) have a matching closing bracket (']', '}' or ')' ) in the same translation unit, otherwise the translation is considered incomplete.
 
<!--T:30-->
The same rule is not enforced by the wiki software, so it is easy for writers to miss those mistakes. If a bracket character is simply missing, just add it. However, sometimes the bracketed content extends over more than one translation unit, so that the matching closing bracket is in later unit. In this case you need to balance brackets in both units, but you can't simply add bracket characters without changing the meaning or formatting, so you must must comment out the added bracket character, like this
 
<!--T:31-->
{{Input|1=<nowiki><!--}}-->{{Info|1=Beginning of long info box... </nowiki>}}
 
<!--T:32-->
and in a later unit
 
<!--T:33-->
{{Input|1=<nowiki> ...end of long info box}}<!--{{--></nowiki>}}
 
<!--T:34-->
If the offending bracket is part of a smiley, you can replace it with an emoticon icon. For the standard smiley, <!--(-->:-), you can use the template <nowiki>{{Smiley}}</nowiki>
 
<!--T:35-->
Please also correct the original page so other translators won't have the same problem, or leave a message on the discussion page.
 
===Language Statistics discrepancies=== <!--T:36-->
 
<!--T:37-->
You may notice some slight discrepancy between the percentages stated on your LanguageStats page and the percentage on the language bar.  This is normal.  LanguageStats compares only the number of messages that are untranslated or outdated.  The language bar statistic tries to be more intelligent.  For instance, in one page (100 messages) 8 messages had a small (re-branding-releated) change, in each case, a single word was involved.  There was 8% difference between the two statistics, since it was a substantial proportion of the messages, but a small proportion of the whole translation.
 
===If you use the Chromium browser....=== <!--T:38-->
 
<!--T:39-->
Be aware that there seems to be some sort of caching problem on the Chromium browser.  I have noticed that even with forced refreshes, sometimes statistics do not show up as they should (I have seen other things affected, too), yet if I open the same page in Firefox I see the correct stats.
 
== Also See == <!--T:40-->


== Hints and Tips ==
<!--T:41-->
* [http://translatewiki.net/wiki/Translating:Page_translation_feature#Translators]


== Also See ==
<!--T:42-->
* http://translatewiki.net/wiki/Web_interface
[[Category:Contributing]]
</translate>

Latest revision as of 14:06, 15 July 2011

Available Tools

Workflow

  • Request addition to the Translator group:
    • Click on Get a Translator Account in the sidebar
    • Click on the Edit icon and enter your username, the language you want to translate for and if you intend to translate off-line
    • Use Save page to save the information
  • When your user has been added to the group (you should get an e-mail notification), click on Start Translating in the sidebar
  • If the UserBase interface is in English and there are no any page titles showed on the page, you may need to enter the language you want to translate to in Language code and click on Go.
Note
Entering en (English) as the language code won't display any untranslated messages since all original content is written in English


  • Click on a page you want to translate in the list
  • In the Translate page, set View all untranslated messages in the first drop-down list or you can choose Review all translated messages to improve the translated messages
  • Check that the correct language code is showing
  • In the Navigation section, click on the link to the left of the message you want to translate
  • Enter the translation - a Google translation is provided for reference, but your own translation is usually preferred.
  • Click on Save and open next to continue with the next message or Save page to save the translation if you wish to stop working.
Warning
Do not create a localized page variant manually (by entering pagename/langcode and trying to translate the original). This will mess up the translation system and no translation will be shown at all.


Hints and Tips

Image display instructions

A typical example is [[Image:Plasma-kickoff.jpg|right|160px]]. The whole of this is a system instruction on how to display the image. None of it is translated.

Category statements

In this context, think of the word "Category" as a system word which therefore should not be translated. For example, [[Category:Administration]] would become [[Category:Administrasi/id]]

For consistency, we have lists of approved translations of categories, and ask you to use them. You can find one suited to your language linked from Translation_Help_Needed. If there are any blanks in your table, feel free to add a suitable translation.

Links to other pages on UserBase

These take the form [[Special:myLanguage/Other page|link text]] The link should remain untranslated, whereas the link text should always be translated. If no link text is present, please add a suitable (translated) link text. Note, that this also goes for subpage links, ie. links of the form [[Special:myLanguage/Page#Section|link text]].

Note: "myLanguage" will try to load the translated version of the link in the language you have set in your user preferences. If it fails to load it will just load the English original, so it is safe to use it for any internal link.

Links to external sites

These take the form [http://example.com link text] Like the internal links, retain the actual link and translate the link text.

Links in the Sidebar

Instructions for translating those sidebar links can be found at Modifying_the_Sidebar#Translating_Sidebar_Items


Info-boxes

These generally consist of a header word "Information" or "Note" and an editable information text. If the word "Information" is not in your language, you may need a localized version of the template.

Usually, you need to add a forward slash and a specific language code to show the title in your own language. For example, in the picture on the right-hand side, zh-cn is the language code for Chinese(China Mainland)

The following pictures show the result:

Before:
After:

Translated units are marked as fuzzy

Sometimes it may happen that you have translated a page, but the translation is marked as incomplete. Certain errors in the markup of the original page can cause this. The most common type of error is the appearance of unbalanced brackets or parentheses. The translation system requires that all opening brackets ('[', '{' or '(' ) have a matching closing bracket (']', '}' or ')' ) in the same translation unit, otherwise the translation is considered incomplete.

The same rule is not enforced by the wiki software, so it is easy for writers to miss those mistakes. If a bracket character is simply missing, just add it. However, sometimes the bracketed content extends over more than one translation unit, so that the matching closing bracket is in later unit. In this case you need to balance brackets in both units, but you can't simply add bracket characters without changing the meaning or formatting, so you must must comment out the added bracket character, like this

<!--}}-->{{Info|1=Beginning of long info box... 

and in a later unit

 ...end of long info box}}<!--{{-->

If the offending bracket is part of a smiley, you can replace it with an emoticon icon. For the standard smiley, :-), you can use the template {{Smiley}}

Please also correct the original page so other translators won't have the same problem, or leave a message on the discussion page.

Language Statistics discrepancies

You may notice some slight discrepancy between the percentages stated on your LanguageStats page and the percentage on the language bar. This is normal. LanguageStats compares only the number of messages that are untranslated or outdated. The language bar statistic tries to be more intelligent. For instance, in one page (100 messages) 8 messages had a small (re-branding-releated) change, in each case, a single word was involved. There was 8% difference between the two statistics, since it was a substantial proportion of the messages, but a small proportion of the whole translation.

If you use the Chromium browser....

Be aware that there seems to be some sort of caching problem on the Chromium browser. I have noticed that even with forced refreshes, sometimes statistics do not show up as they should (I have seen other things affected, too), yet if I open the same page in Firefox I see the correct stats.

Also See