Difference between revisions of "Become a Translator/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(25 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Image:home.png|link=http://wiki.pcbsd.org/index.php/PC-BSD_Users_Handbook|center|Return to Table of Contents]] [[Image:previous1.png|left|link=http://wiki.pcbsd.org/index.php/Become_a_Beta_Tester|Previous: Become a Beta Tester]] [[Image:next1.png|right|link=http://wiki.pcbsd.org/index.php/Become_a_Developer|Next: Become a Developer]]
+
<noinclude>{{NavHeader|back=Become a Beta Tester|forward=Become a Developer}}</noinclude>
  
 +
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.
  
 +
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:
  
 +
'''Figure 11.2a: The PC-BSD® Pootle Translation System'''
  
 +
[[Image:Pootle1a.png|border]]
  
PC-BSD uses [http://en.wikipedia.org/wiki/Pootle 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.
+
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 [http://pootle.pcbsd.org/ PCBSD Translation System] in your browser, as seen in Figure 9.2a:
+
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.
  
'''Figure 9.2a: The PC-BSD Pootle Translation System'''
+
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:
  
[[Image:Pootle1.png]]
+
'''Figure 11.2b: Viewing a Language's Available Menus'''
  
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 [http://lists.pcbsd.org/mailman/listinfo/translations translations mailing list] so it can be added.
+
[[Image:Pootle2a.png|border]]
  
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 aren't translated will appear in English instead of in that language.
+
In this example, the menu for CrashHandler is complete, but the one for [[Life Preserver]] is not.
  
If you click on a language name then click on the pcbsd hyperlink under the "Name" column, you'll see each menu item that is available for translation. The example shown in Figure 9.2b is for the Greek localization:
+
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 {{citelink|url=http://translate.sourceforge.net/wiki/toolkit/pofilter_tests|txt=sourceforge's translate site}}.
  
'''Figure 9.2b: Viewing a Language's Available Menus'''
+
'''Figure 11.2c: Reviewing a Language's Quality Checks'''
  
[[Image:Pootle2.png]]
+
[[Image:Pootle3b.png|border]]
  
In this example, the menu for CrashHandler is complete, but the one for LifePreserver is not.
+
If you wish to help localize your language, you should first join the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/translations|txt=translations mailing list}} and introduce yourself and which language(s) 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 the translations. You will also need to create a Pootle login account.
  
If you click on the Review tab, you'll see a list of statistics as seen in Figure 9.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 [http://translate.sourceforge.net/wiki/toolkit/pofilter_tests here].
+
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 9.2c: Reviewing a Language's Quality Checks'''
+
'''Figure 11.2d: Using the Pootle Interface to Edit a Translation String'''
  
[[Image:Pootle3a.png]]
+
[[Image:Pootle4a.png|border]]
  
If you wish to help localize your language, you should first join the [http://lists.pcbsd.org/mailman/listinfo/translations translations mailing list] and introduce yourself and which language(s) 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 the translations. You will also need to create a Pootle login account.
+
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.
  
Once you are logged in to Pootle, navigate to the menu item that you wish to translate. Figure 9.2c continues the earlier example by clicking on the link for LifePreserver.po.
+
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.
  
'''Figure 9.2d: Using the Pootle Interface to Edit a Translation String'''
+
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}}.
  
[[Image:Pootle4.png]]
+
<noinclude>{{refheading}}</noinclude>
 
+
<noinclude>
In this example, the first string (the word Disabled) has been translated but is failing 2 of the quality checks. The translator can check the correctness of the translation as well as fix the whitespace and double-spacing issue. Once finished, the translator can click the "Add Comment" link to type in an optional comment then press the "Submit" button to save any changes. 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.
+
[[category:handbook]]
 +
[[category:Supporting PC-BSD®]]
 +
[[category:Become a Translator]]
 +
</noinclude>

Revision as of 10:03, 6 November 2012

(Sorry for the inconvenience)

PC-BSD® uses Pootle[1] 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 [1][2] in your browser, as seen in Figure 11.2a:

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

Pootle1a.png

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[3] 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

Pootle2a.png

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

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[4].

Figure 11.2c: Reviewing a Language's Quality Checks

Pootle3b.png

If you wish to help localize your language, you should first join the translations mailing list[3] and introduce yourself and which language(s) 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 the translations. 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

Pootle4a.png

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[5].

References


  1. http://en.wikipedia.org/wiki/Pootle
  2. http://pootle.pcbsd.org/
  3. 3.0 3.1 http://lists.pcbsd.org/mailman/listinfo/translations
  4. http://translate.sourceforge.net/wiki/toolkit/pofilter_tests
  5. http://forums.pcbsd.org/forumdisplay.php?f=19
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox