Difference between revisions of "Become a Translator/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(Documentation Translation)
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<translate><!--T:1-->
+
<noinclude><translate>
<noinclude>{{NavHeader|back=Become a Beta Tester|forward=Become a Developer}}</noinclude>
+
  
If you are interested in translating PC-BSD into your native language, there are three translation areas that you can choose to become involved in:
+
<!--T:39-->
 +
{{NavHeader|back=Become a Beta Tester|forward=Become a Developer}}</noinclude>
  
1. Translate the graphical menus within the PC-BSD operating system.
+
<!--T:25-->
 +
If you are interested in translating PC-BSD® into your native language, there are three translation areas that you can choose to become involved in:
  
2. Translate the documentation that is published with PC-BSD.
+
<!--T:26-->
 +
1. Translate the graphical menus within the PC-BSD® operating system.
  
3. Translate the PC-BSD website.
+
<!--T:27-->
 +
2. Translate the documentation that is published with PC-BSD®.
  
 +
<!--T:28-->
 +
3. Translate the PC-BSD® website.
 +
 +
<!--T:29-->
 
This section describes each of these translation areas in more detail and how to get started as a translator.
 
This section describes each of these translation areas in more detail and how to get started as a translator.
  
== Join the Translations Mailing List ==
+
== Join the Translations Mailing List == <!--T:30-->
  
 +
<!--T:31-->
 
Regardless of the type of translation you are interested in, you should first join the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/translations|txt=translations mailing list}}. When you join, send an email to introduce yourself and indicate which language(s) and which type(s) of translations you can assist with. This will allow you to meet other volunteers as well as keep abreast of any notices or updates that may affect translators.
 
Regardless of the type of translation you are interested in, you should first join the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/translations|txt=translations mailing list}}. When you join, send an email to introduce yourself and indicate which language(s) and which type(s) of translations you can assist with. This will allow you to meet other volunteers as well as keep abreast of any notices or updates that may affect translators.
  
== Menu Translation==
+
== Interface Translation== <!--T:32-->
  
 
<!--T:2-->
 
<!--T:2-->
[[File:Pootle1a.png|thumb|393px|'''Figure 11.2a: The PC-BSD® Pootle Translation System''']]
+
[[File:Pootle1b.png|thumb|393px|'''Figure 11.2a: The PC-BSD® Pootle Translation System''']]
  
 
<!--T:3-->
 
<!--T:3-->
 
PC-BSD® uses {{citelink|wp|url=Pootle|txt=Pootle}} for managing localization of the menu screens used by the installer and the PC-BSD® utilities. Pootle makes it possible to find out if your native language has been fully localized for PC-BSD®. Pootle also makes it easy for users to check and submit translated text, as it provides a web editor and commenting system. This means that translators can spend their time making and reviewing translations rather than learning how to use a translation tool.
 
PC-BSD® uses {{citelink|wp|url=Pootle|txt=Pootle}} for managing localization of the menu screens used by the installer and the PC-BSD® utilities. Pootle makes it possible to find out if your native language has been fully localized for PC-BSD®. Pootle also makes it easy for users to check and submit translated text, as it provides a web editor and commenting system. This means that translators can spend their time making and reviewing translations rather than learning how to use a translation tool.
  
<!--T:5-->
+
<!--T:49-->
The localizations PC-BSD® users have requested are listed alphabetically on the left. If your language is missing and you would like to help in its translation, send an email to the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/translations|txt=translations mailing list}} so it can be added. To see the status of a localization, open up the {{citelink|url=http://pootle.pcbsd.org/|PCBSD Translation System}} in your browser, as seen in Figure 11.2a.
+
To see the status of a localization, open up the [http://pootle.pcbsd.org/ PCBSD Translation System] in a web browser, as seen in Figure 11.2a.  
  
==== Reviewing a Translation's Status ==== <!--T:6-->
+
<!--T:5-->
 +
The localizations PC-BSD® users have requested are listed alphabetically on the left. If your language is missing and you would like to help in its translation, send an email to the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/translations|txt=translations mailing list}} so it can be added.
  
 
<!--T:7-->
 
<!--T:7-->
Line 56: Line 65:
 
* '''Cosmetic''' -- ''make it look better''
 
* '''Cosmetic''' -- ''make it look better''
 
: brackets, doublequoting, doublespacing, doublewords, endpunc, endwhitespace, puncspacing, simplecaps, simpleplurals, startcaps, singlequoting, startpunc, startwhitespace, validchars
 
: brackets, doublequoting, doublespacing, doublewords, endpunc, endwhitespace, puncspacing, simplecaps, simpleplurals, startcaps, singlequoting, startpunc, startwhitespace, validchars
 
  
 
<!--T:15-->
 
<!--T:15-->
 
[[File:Pootle3b.png|thumb|393px|'''Figure 11.2c: Reviewing a Language's Quality Checks''']]
 
[[File:Pootle3b.png|thumb|393px|'''Figure 11.2c: Reviewing a Language's Quality Checks''']]
  
 +
<!--T:33-->
 
In order to edit a translation, you will also need to create a Pootle login account. Once you are logged in to Pootle, navigate to the menu item that you wish to translate. Figure 11.2d continues the earlier example by clicking on the link for the Greek version of LifePreserver.po.
 
In order to edit a translation, you will also need to create a Pootle login account. Once you are logged in to Pootle, navigate to the menu item that you wish to translate. Figure 11.2d continues the earlier example by clicking on the link for the Greek version of LifePreserver.po.
  
Line 72: Line 81:
 
For untranslated strings, you can use the "Google translate" button to suggest a translation, then fix as necessary for correctness. If a string fails a quality check, a message will indicate which check failed. For example, if the whitespace or double-spacing check fails, remove the extra space. As you translate or fix a string, click the "Add Comment" link to type in an optional comment then press the "Submit" button to save the translated text.
 
For untranslated strings, you can use the "Google translate" button to suggest a translation, then fix as necessary for correctness. If a string fails a quality check, a message will indicate which check failed. For example, if the whitespace or double-spacing check fails, remove the extra space. As you translate or fix a string, click the "Add Comment" link to type in an optional comment then press the "Submit" button to save the translated text.
  
 +
<!--T:34-->
 
If you need help with a translation or using the Pootle system, you can ask for help on the translations mailing list or in the {{citelink|url=http://forums.pcbsd.org/forumdisplay.php?f=19|txt=PC-BSD® Translations Forum}}.
 
If you need help with a translation or using the Pootle system, you can ask for help on the translations mailing list or in the {{citelink|url=http://forums.pcbsd.org/forumdisplay.php?f=19|txt=PC-BSD® Translations Forum}}.
  
== Documentation Translation ==
+
== Documentation Translation == <!--T:35-->
  
The PC-BSD Users Handbook is published with each version of PC-BSD. The PC-BSD wiki is used to create the next version of the Handbook. As new features are added to the upcoming version of PC-BSD, they are documented on the wiki. Once the upcoming operating system version reaches its RC (Release Candidate) stage, the content on the wiki is "frozen" so that the published versions can be formatted in time for release.
+
<!--T:36-->
 +
The PC-BSD® Users Handbook is published with each version of PC-BSD®. The PC-BSD® wiki is used to create the next version of the Handbook. As new features are added to the upcoming version of PC-BSD®, they are documented on the wiki.  
  
As of April, 2013, the wiki has been configured with the [http://www.mediawiki.org/wiki/Help:Extension:Translate MediaWiki Translate Extension]. Wiki pages that are to appear in the published version of the Handbook has been marked with the translate tag so that they are available to translators.
+
<!--T:37-->
 +
The wiki has been configured with the [http://www.mediawiki.org/wiki/Help:Extension:Translate MediaWiki Translate Extension]. Wiki pages that are to appear in the published version of the Handbook has been marked with the translate tag so that they can be translated by translators.
  
== Website Translation ==
+
<!--T:40-->
 +
In order to translate a wiki page, you must first create a wiki account and log in.
 +
 
 +
<!--T:41-->
 +
To translate a page, click the "Translate this page" link at the top of the page. This will open the translation editor. In the upper right corner, click the "Translate to English" drop-down menu to select the language you wish to translate into. Once the language is selected, click the "Edit" link next to the string to be translated. This will open an editor where you can type in the translation. You can then either click the "Save translation" button to return to the previous page or click the "Skip to next" button to go to the next string to be translated. In the example shown in Figure 11.2e, the user selected the Introduction page, clicked to translate to Russian, and has selected a paragraph to translate.
 +
 
 +
<!--T:50-->
 +
[[File:Translation.png|thumb|393px|'''Figure 11.2e: Translating a Wiki Page''']]
 +
 
 +
<!--T:42-->
 +
You can review the status of the translation by clicking the "Page" button at the bottom of the screen. This will display the English and the translated versions side by side.
 +
 
 +
<!--T:44-->
 +
When translating, make sure to adhere to the following rules. This is important as it ensures that the formatting of the published document is consistent across all translations.
 +
 
 +
<!--T:45-->
 +
* do not translate any text between formatting tags which are enclosed within < > brackets.
 +
 
 +
<!--T:46-->
 +
* do not translate the names of a command (such as '''pc-updatemanager''') or application (such as AppCafe®).
 +
 
 +
<!--T:47-->
 +
* do not translate the output of a command unless it appears differently in a localized version of PC-BSD®.
 +
 
 +
<!--T:48-->
 +
* do not translate or remove any text contained between comment tags <<nowiki>!</nowiki>-- and -->.
 +
 
 +
* do not translate template names, they appear directly after <nowiki>{{</nowiki>.
 +
 
 +
== Website Translation == <!--T:38-->
 +
 
 +
<!--T:51-->
 +
If you are interested in translating the PC-BSD® website, send an email to the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/translations|txt=translations mailing list}}. Someone will introduce you to the webmaster who will get you started on website translation.
  
 
<!--T:24-->
 
<!--T:24-->
 
<noinclude>
 
<noinclude>
 
{{refheading}}
 
{{refheading}}
[[category:handbook]]
 
 
[[category:Supporting PC-BSD®]]
 
[[category:Supporting PC-BSD®]]
 
[[category:Become a Translator]]
 
[[category:Become a Translator]]
</noinclude>
+
[[category:handbook]]
 
</translate>
 
</translate>
 +
<languages/>
 +
</noinclude>

Revision as of 02:01, 28 September 2013

(Sorry for the inconvenience)

Contents

If you are interested in translating PC-BSD® into your native language, there are three translation areas that you can choose to become involved in:

1. Translate the graphical menus within the PC-BSD® operating system.

2. Translate the documentation that is published with PC-BSD®.

3. Translate the PC-BSD® website.

This section describes each of these translation areas in more detail and how to get started as a translator.

Join the Translations Mailing List

Regardless of the type of translation you are interested in, you should first join the translations mailing list[1]. When you join, send an email to introduce yourself and indicate which language(s) and which type(s) of translations you can assist with. This will allow you to meet other volunteers as well as keep abreast of any notices or updates that may affect translators.

Interface Translation

Figure 11.2a: The PC-BSD® Pootle Translation System

PC-BSD® uses Pootle[2] for managing localization of the menu screens used by the installer and the PC-BSD® utilities. Pootle makes it possible to find out if your native language has been fully localized for PC-BSD®. Pootle also makes it easy for users to check and submit translated text, as it provides a web editor and commenting system. This means that translators can spend their time making and reviewing translations rather than learning how to use a translation tool.

To see the status of a localization, open up the PCBSD Translation System in a web browser, as seen in Figure 11.2a.

The localizations PC-BSD® users have requested are listed alphabetically on the left. If your language is missing and you would like to help in its translation, send an email to the translations mailing list[1] so it can be added.

The green bar in the "Overall Completion" column indicates the percentage of PC-BSD® menus that have been localized. If a language is not at 100%, it means that the menus that currently are not translated will appear in English instead of in that language.

If you click on a language name then click on the pcbsd hyperlink under the "Name" column, you will see each menu item that is available for translation. The example shown in Figure 11.2b is for the Greek localization:

Figure 11.2b: Viewing a Language's Available Menus

In this example, the menu for CrashHandler is complete, but the one for Life Preserver is not.

Editing a Translation

If you click on the "Review" tab, you will see a list of statistics as seen in Figure 11.2c. This page will indicate the results of Pootle's quality checks, helping translators to notice any problematic items. A description of each quality check can be found at sourceforge's translate site[3]. Some tests are more important than others so they are classified to help determine which to run first:

  • Critical -- can break a program
accelerators, escapes, newlines, nplurals, printf, tabs, variables, xmltags, dialogsizes
  • Functional -- may confuse the user
acronyms, blank, emails, filepaths, functions, gconf, kdecomments, long, musttranslatewords, notranslatewords, numbers, options, purepunc, sentencecount, short, spellcheck, urls, unchanged
  • Cosmetic -- make it look better
brackets, doublequoting, doublespacing, doublewords, endpunc, endwhitespace, puncspacing, simplecaps, simpleplurals, startcaps, singlequoting, startpunc, startwhitespace, validchars
Figure 11.2c: Reviewing a Language's Quality Checks

In order to edit a translation, you will also need to create a Pootle login account. Once you are logged in to Pootle, navigate to the menu item that you wish to translate. Figure 11.2d continues the earlier example by clicking on the link for the Greek version of LifePreserver.po.

Figure 11.2d: Using the Pootle Interface to Edit a Translation String

In this example, the first string, the phrase "No Previous Backup" has been translated. Each text field (string) in the menu is numbered -- click on the hyperlink associated with the number to open that text field in the Pootle editor, or use the "Next" and "Previous" links to navigate between text fields.

For untranslated strings, you can use the "Google translate" button to suggest a translation, then fix as necessary for correctness. If a string fails a quality check, a message will indicate which check failed. For example, if the whitespace or double-spacing check fails, remove the extra space. As you translate or fix a string, click the "Add Comment" link to type in an optional comment then press the "Submit" button to save the translated text.

If you need help with a translation or using the Pootle system, you can ask for help on the translations mailing list or in the PC-BSD® Translations Forum[4].

Documentation Translation

The PC-BSD® Users Handbook is published with each version of PC-BSD®. The PC-BSD® wiki is used to create the next version of the Handbook. As new features are added to the upcoming version of PC-BSD®, they are documented on the wiki.

The wiki has been configured with the MediaWiki Translate Extension. Wiki pages that are to appear in the published version of the Handbook has been marked with the translate tag so that they can be translated by translators.

In order to translate a wiki page, you must first create a wiki account and log in.

To translate a page, click the "Translate this page" link at the top of the page. This will open the translation editor. In the upper right corner, click the "Translate to English" drop-down menu to select the language you wish to translate into. Once the language is selected, click the "Edit" link next to the string to be translated. This will open an editor where you can type in the translation. You can then either click the "Save translation" button to return to the previous page or click the "Skip to next" button to go to the next string to be translated. In the example shown in Figure 11.2e, the user selected the Introduction page, clicked to translate to Russian, and has selected a paragraph to translate.

Figure 11.2e: Translating a Wiki Page

You can review the status of the translation by clicking the "Page" button at the bottom of the screen. This will display the English and the translated versions side by side.

When translating, make sure to adhere to the following rules. This is important as it ensures that the formatting of the published document is consistent across all translations.

  • do not translate any text between formatting tags which are enclosed within < > brackets.
  • do not translate the names of a command (such as pc-updatemanager) or application (such as AppCafe®).
  • do not translate the output of a command unless it appears differently in a localized version of PC-BSD®.
  • do not translate or remove any text contained between comment tags <!-- and -->.
  • do not translate template names, they appear directly after {{.

Website Translation

If you are interested in translating the PC-BSD® website, send an email to the translations mailing list[1]. Someone will introduce you to the webmaster who will get you started on website translation.


References


  1. 1.0 1.1 1.2 http://lists.pcbsd.org/mailman/listinfo/translations
  2. http://en.wikipedia.org/wiki/Pootle
  3. http://translate.sourceforge.net/wiki/toolkit/pofilter_tests
  4. http://forums.pcbsd.org/forumdisplay.php?f=19
Other languages:German 62% • ‎English 100% • ‎French 24%
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox