• This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn more.

CFT: PO/Gettext Translation System for FreeBSD DocBook Documents


Staff member

Thanks: 3,581
Messages: 13,850

For the last couple of years, there has been an effort to modernize the way that translations of FreeBSD documentation are produced. The manual methods that have been used for decades are too labor-intensive to keep
up with the rate of change of the documentation.

These new changes make use of the standard PO/Gettext translation used by many other open-source projects. Translators only need to translate strings, not try to track upstream changes. While some knowledge of
DocBook will be helpful, being able to write full DocBook documents is not required.

At this point, we need some testing and feedback.

We know this has been a long time coming, and we appreciate your patience and help. Thank you!


The documentation build system has been updated, and is included when the documentation tree is checked out.

Version 2.0.6 of the textproc/docproj port has been updated to include the basic PO translation tools. If the port is already installed, turn on the TRANSLATOR option and reinstall it:
# cd /usr/ports/textproc/docproj
# make config
# make reinstall clean
A preliminary version of a new PO Translations chapter for the FDP Primer starts here: http://wonkity.com/~wblock/tmp/translation/po-translations.html

Proceed through the multiple sections by clicking Next at the upper or lower right.

The Quick Start section has a quick overview of the whole process. For testing, we recommend translating the Leap Seconds article shown there. It is short and provides a reasonable overview of the process.

More detail is provided in the later sections, including examples in the Creating New Translations section.

Feedback and Assistance

The mailing list for FreeBSD translators is at https://lists.freebsd.org/mailman/listinfo/freebsd-translators.
Last edited: