Kris has finished integrating the source files for the PC-BSD Handbook documentation into Pootle, meaning that translators can now use their web browser to translate the Handbook into their native language. As translations are completed, we’ll make sure that the build server generates HTML copies and includes them in /usr/local/share/pcbsd/doc/html (right away for EDGE users and with the next release for PRODUCTION users).
To translate the documentation, go to http://translate.pcbsd.org/translate/, click the “All Projects” drop-down menu, and select “PC-BSD Handbook”. You can then click the link for the language to translate. Currently, German and French are available. If you want to translate to a different language, send an email to the translations mailing list and request that it be added.
When translating the documentation, be aware of the following:
- At this time, some formatting tags are still displayed in raw text, as seen in the examples in Figures 1 and 2. It is IMPORTANT that you do not accidently remove the formatting as this can break the documentation build for that language. In the first example, it is OK to translate the phrase “Using the Text Installer” but care must be taken to not accidently remove any of the surrounding colons and backticks, or to change the text of the “ref” tag. In the second example, the asterisks are used to bold the word “install”. It is OK to translate “install”, but do not remove the asterisks.
Figure 1: Do Not Remove Formatting Characters
Figure 2: Another Formatting Characters Example
If you have any questions on how to use Pootle, have suggestions on how to streamline the translation process, or find any gotchas when translating, please send them to the translations mailing list so that the developers and other translators are aware of them.
The 9.0 PC-BSD Users Handbook has been translated to Indonesian and is available for download in the following formats:
Thanks goes to Tri Mulya S for the translation.
Tigersharke is working on the HTML version which should show up here some time in the next few days.
There will not be a Kindle version as this language is not supported by Amazon Kindle.
For those of you trying out the 9.0-STABLE-20120225 testing snapshot, or who are curious about the revamped installer for 9.1, Chapters 3, 4, and 5 of the PC-BSD Handbook have been updated with the new screenshots and functionality. Some sections are still being tested or aren’t yet fully implemented and will contain a comment to that effect in ALL CAPS.
I particularly like the new FreeBSD setup wizard; that and the ability to configure ZFS and encryption during installation makes it my new FreeBSD installer of choice.
Some of the new installer features will be refined between now and 9.1-RELEASE and the documentation will be updated accordingly. We will be releasing regular testing snapshots between now and 9.1 to give testers ample time to test new features as they are implemented. It is expected that the next testing snapshot will contain bug fixes from the last snapshot, the new gdm GUI configuration tool, and the changes to Warden that Kris is currently coding.
If you have any feedback or suggestions for the new installer, please send them to the PC-BSD testing mailing list.
For those of you who like a hard copy of documentation, the PC-BSD 9.0 Users Handbook is now available for purchase from the FreeBSD Mall. The Handbook is available as:
I’ve heard that the book looks awesome and have seen the cover/label/insert artwork for the DVD. Thanks to Jenny Rosenberg for the artwork and to Theresa Garner at FreeBSD Mall.
The PC-BSD 9.0 Users Handbook is complete and available in several formats:
- as an icon on the 9.0-RELEASE desktop (which should be announced as available in the next day or so)
- in HTML, PDF, and epub formats from the handbook page of the ftp server
- as a Kindle version which should be available from Amazon some time this week
- FreeBSD Mall will be selling a “dead tree” version; more details on pricing and ordering should be available on their website in a few days
Let me know if you are interested in translating this version of the Handbook so I can send you the source and make sure that the translations mailing list is aware of the pending translation.