When po4a prepares the translated content as POD or DocBook XML, the final documentation can then be built using po4a-build. Both the untranslated and translated content is built as a single process, updating the POT files at the same time.
Existing build instructions are replaced by a single call to po4a-build and a simple configuration file is used to tell po4a-build how to build each element and which binary packages will include the translated and untranslated content.
Once built, the content will be in package-specific directories beneath the BASEDIR specified in the configuration file. For a binary package foo, with translations into German and French, this would result in:
BASEDIR/foo/man/man1/foo.1 BASEDIR/foo/man/de/man1/foo.1 BASEDIR/foo/man/fr/man1/foo.1
This makes it easy to include all the generated content into the binary package with a single install location:
doc/foo/man/* ./usr/share/man/ doc/foo/html/* ./usr/share/doc/foo/
Currently, po4a-build supports the following combinations:
All supported formats, in all supported combinations, can be handled in a single po4a-build.conf configuration file and in a single call to po4a-build. See po4a-build.conf(5).
po4a-build uses a default configuration file, po4a-build.conf which should be in the top level directory of your package VCS. (Use the -f option to specify a different file.) See po4a-build.conf(5).
Example 1. example configuration file
An example configuration file is available at:
The configuration file consists of several sections, general, XML/XSL support, POD support and HTML support.
General includes the name and location of the po4a config file (probably best to leave this as po4a.config), the po directory containing the documentation PO files (often doc/po), the full name of the POT file used to create the translations, the BASEDIR for the generated output, whether the package contains manpages in section 3 rather than just section 1 and the names of the binary packages which are to contain the generated output.
XML/XSL support includes specifying which of the binary packages use XSL support in the XMLPACKAGES variable, the top level DocBook file to pass to xsltproc and the location of the XML or DocBook files. The XSLFILE can be overridden, if necessary.
POD support includes specifying which of the binary packages use POD support in the PODPACKAGES variable and the full name of the POD file.
HTML support specifies the subdirectory to create below BASEDIR for the untranslated and translated HTML content and the DocBook file to generate the HTML. The HTMLXSL file can be overridden, if necessary.
Example 2. svn-buildpackage example
svn-buildpackage has explicit support for this kind of addition, using the useNativeDist SVN property and the native-dist Make target.
# adds the POT file to the source tarball native-dist: Makefile po4a-build --pot-only
$ svn propset useNativeDist 1 debian
po4a-build was written by Neil Williams <email@example.com>.
This manual page was written by Neil Williams <firstname.lastname@example.org>