Anyone is welcome to help with translating the handbook into other languages. MediaWiki is now used for translation work of version 9.2 and may be the method used in the future. The task should be as simple as choosing through the mediawiki link "translate this page" and selecting the desired language. From there, leave the NavHeader line as is, it will transparently localize with small exceptions described on the template:NavHeader page. 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.
Since we were not yet able to get MediaWiki to provide a working translation plugin, below is how our translation process had worked. Although the mediawiki method may be the quickest to make available to the public, the old method could still be used but at a cost of delayed access.
- Translators and potential translators are encouraged to join the translations mailing list.
- 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 of the Handbook
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.