Difference between revisions of "Handbook translating"

From PC-BSD Wiki
Jump to: navigation, search
m (Created page with "==Translating the Handbook== Anyone is welcome to help with translating the handbook into other languages. We hope to eventually be able to use the MediaWiki for translation work...")
 
(41 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Translating the Handbook==
+
<translate>
Anyone is welcome to help with translating the handbook into other languages. We hope to eventually be able to use the MediaWiki for translation work. However, since we have not yet been able to get MediaWiki to provide a working translation plugin, this is how our translation process works:
+
<!--T:1-->
 +
{{NavHome}}
 +
{{note|class=rightfloat|This page may be incomplete. Further instructions may be added to this page or linked from here to an entirely new page as needed.}}
  
===Handbook v9.0===
+
Anyone is welcome to help with translating the handbook into other languages. MediaWiki can now be used for the translation work of version 9.2 and may be the method used in the future, although the old method could still be used but at a cost of delayed access. The mediawiki method may be the quickest to make available to the public.
* Translators and potential translators are encouraged to join [http://lists.pcbsd.org/mailman/listinfo/translations the translations mailing list]
+
== Mediawiki == <!--T:2-->
* Documentation in the wiki gets "frozen" a few weeks before release so that they can be translated
+
The task should be as simple as choosing through the mediawiki link ''"translate this page"'' and selecting the desired language. Then use the mediawiki mechanism to do your work.
* The text (in odt format) is sent to the translations mailing list and emailed back when it is finished
+
* leave the UseTOC line as is (paste source text and "save translation" for that line) if there is no "title={{i|translate what is here}}" portion.
 +
* It may be considered the most important step, to localize all of the page titles for those pages listed in the {{phrase-table of contents}} of the {{local|link=PC-BSD®_Users_Handbook}} because that section will automagically "import" those translated page titles.
 +
* Page links that use template:local such as <nowiki>{{local|link=handbook translating}}</nowiki> will appear as localized links if their page title has been translated, and more complex links also work, such as <nowiki>{{local|static=Warden®/{{release}}|anchor=Using Template Manager|Template Manager}}</nowiki> are displayed as {{local|static=Warden®/{{release}}|anchor=Using Template Manager|Template Manager}}.
 +
* Application names should not be translated (AppCafe, LifePreserver, etc)
  
An expected "Freeze" date is roughly Late August or so, but that depends on the results of FreeBSD's RC process.
+
<!--T:13-->
 +
{{note|icon48=Although no explanation may be given, if a page previously marked to be translated (especially the templates for "''word-''.." or "''phrase-''.." which are used by the Navigation and other templates) gets marked as ''discouraged'' on the [[Special:PageTranslation]] page let someone know that you wish to be able to translate it.}}
  
Some teams may use google docs or other sharing mechanisms to work on the translation, other teams might have only one person or divide up who does which sections. Use the method that works best or makes the task easiest.
+
==Earlier methods== <!--T:14-->
  
===Older versions of the Handbook===
+
<!--T:12-->
 +
Since at that time we were not able to get MediaWiki to provide a working translation plugin, and other structures (templates) were not yet in place, below is how our translation process had worked.
 +
 
 +
=== Handbook v9.1 === <!--T:3-->
 +
 
 +
<!--T:4-->
 +
* Translators and potential translators are encouraged to join [http://lists.pcbsd.org/mailman/listinfo/translations the translations mailing list].
 +
 
 +
<!--T:5-->
 +
* Documentation in the wiki gets "frozen" a few weeks before release so that they can be translated.
 +
 
 +
<!--T:6-->
 +
* The text (in odt format) is sent to the translations mailing list and emailed back when it is finished.
 +
 
 +
<!--T:7-->
 +
An expected "Freeze" date depends on the results of FreeBSD's RC process.
 +
 
 +
<!--T:8-->
 +
Some teams may use Google Docs™ or other sharing mechanisms to work on the translation, other teams might have only one person or divide up who does which sections. Use the method that works best or makes the task easiest.
 +
 
 +
=== Older versions (9.0 and 8.2) === <!--T:9-->
 +
 
 +
<!--T:10-->
 
For those who desire to translate them, we welcome your contributions and ask that you notify us so that we can help make them available.
 
For those who desire to translate them, we welcome your contributions and ask that you notify us so that we can help make them available.
Additional formats including HTML, ODF (for OpenOffice and [http://en.wikipedia.org/wiki/.odf#Software other software]),  EPUB (for [http://en.wikipedia.org/wiki/Comparison_of_e-book_formats#Supporting_Hardware e-readers]), and PDF formats are available as downloads from the [ftp://ftp.pcbsd.org/pub/handbook/ PC-BSD ftp server]. Translations of the Handbook are added to the ftp server as they become available, its file name indicating the language with a [http://reference.sitepoint.com/html/lang-codes 2-letter ISO code].
+
Additional formats including HTML, ODF (for OpenOffice and [http://en.wikipedia.org/wiki/.odf#Software other software]),  EPUB (for [http://en.wikipedia.org/wiki/Comparison_of_e-book_formats#Supporting_Hardware e-readers]), and PDF formats are available as downloads from the [ftp://ftp.pcbsd.org/pub/handbook/ PC-BSD® ftp server]. Translations of the Handbook are added to the ftp server as they become available, its file name indicating the language with a [http://reference.sitepoint.com/html/lang-codes 2-letter ISO code].
 +
 
 +
</translate>
 +
<languages />

Revision as of 01:43, 4 June 2014

Contents

Template:Word-note This page may be incomplete. Further instructions may be added to this page or linked from here to an entirely new page as needed.

Anyone is welcome to help with translating the handbook into other languages. MediaWiki can now be used for the translation work of version 9.2 and may be the method used in the future, although the old method could still be used but at a cost of delayed access. The mediawiki method may be the quickest to make available to the public.

Mediawiki

The task should be as simple as choosing through the mediawiki link "translate this page" and selecting the desired language. Then use the mediawiki mechanism to do your work.

  • leave the UseTOC line as is (paste source text and "save translation" for that line) if there is no "title=translate what is here" portion.
  • It may be considered the most important step, to localize all of the page titles for those pages listed in the Table of Contents of the PC-BSD®_Users_Handbook because that section will automagically "import" those translated page titles.
  • Page links that use template:local such as {{local|link=handbook translating}} will appear as localized links if their page title has been translated, and more complex links also work, such as {{local|static=Warden®/{{release}}|anchor=Using Template Manager|Template Manager}} are displayed as Template Manager.
  • Application names should not be translated (AppCafe, LifePreserver, etc)
NOTE: Although no explanation may be given, if a page previously marked to be translated (especially the templates for "word-.." or "phrase-.." which are used by the Navigation and other templates) gets marked as discouraged on the Special:PageTranslation page let someone know that you wish to be able to translate it.

Earlier methods

Since at that time we were not able to get MediaWiki to provide a working translation plugin, and other structures (templates) were not yet in place, below is how our translation process had worked.

Handbook v9.1

  • Documentation in the wiki gets "frozen" a few weeks before release so that they can be translated.
  • The text (in odt format) is sent to the translations mailing list and emailed back when it is finished.

An expected "Freeze" date depends on the results of FreeBSD's RC process.

Some teams may use Google Docs™ or other sharing mechanisms to work on the translation, other teams might have only one person or divide up who does which sections. Use the method that works best or makes the task easiest.

Older versions (9.0 and 8.2)

For those who desire to translate them, we welcome your contributions and ask that you notify us so that we can help make them available. Additional formats including HTML, ODF (for OpenOffice and other software), EPUB (for e-readers), and PDF formats are available as downloads from the PC-BSD® ftp server. Translations of the Handbook are added to the ftp server as they become available, its file name indicating the language with a 2-letter ISO code.

Other languages:German 79% • ‎English 100% • ‎French 14%
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox