|
|
8.
|
|
|
<command>po4a-build</command> <group> <arg choice='plain'><option>-?</option></arg> <arg choice='plain'><option>-h</option></arg> <arg choice='plain'><option>--help</option></arg> <arg choice='plain'><option>--version</option></arg> </group>
|
|
|
type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:28
|
|
|
9.
|
|
|
DESCRIPTION
|
|
|
type: =head1
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:38 share/doc//po4aman-display-po.xml:31 share/doc//po4apod-display-po.xml:32 po4a:22 po4a:37 po4a-gettextize:24 po4a-normalize:22 po4a-translate:24 po4a-updatepo:24 scripts/msguntypot:25 lib/Locale/Po4a/BibTeX.pm:30 lib/Locale/Po4a/Chooser.pm:92 lib/Locale/Po4a/Common.pm:16 lib/Locale/Po4a/Debconf.pm:29 lib/Locale/Po4a/Dia.pm:35 lib/Locale/Po4a/Docbook.pm:37 lib/Locale/Po4a/Guide.pm:35 lib/Locale/Po4a/Halibut.pm:30 lib/Locale/Po4a/Html.pm:34 lib/Locale/Po4a/Ini.pm:91 lib/Locale/Po4a/KernelHelp.pm:142 lib/Locale/Po4a/LaTeX.pm:30 lib/Locale/Po4a/Man.pm:9 lib/Locale/Po4a/NewsDebian.pm:29 lib/Locale/Po4a/Po.pm:34 lib/Locale/Po4a/Pod.pm:203 lib/Locale/Po4a/Sgml.pm:38 lib/Locale/Po4a/TeX.pm:30 lib/Locale/Po4a/Texinfo.pm:30 lib/Locale/Po4a/Text.pm:30 lib/Locale/Po4a/TransTractor.pm:38 lib/Locale/Po4a/Wml.pm:29 lib/Locale/Po4a/Xhtml.pm:35 lib/Locale/Po4a/Xml.pm:37
|
|
|
10.
|
|
|
<command>po4a-build</command> is intended to make it as easy to produce translated documentation as it can be to produce the current untranslated content.
|
|
|
type: Content of: <refentry><refsect1><para>
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:39
|
|
|
11.
|
|
|
When <command>po4a</command> prepares the translated content as POD or DocBook XML, the final documentation can then be built using <command>po4a-build</command>. Both the untranslated and translated content is built as a single process, updating the POT files at the same time.
|
|
|
type: Content of: <refentry><refsect1><para>
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:43
|
|
|
12.
|
|
|
Existing build instructions are replaced by a single call to <command>po4a-build</command> and a simple configuration file is used to tell <command>po4a-build</command> how to build each element and which binary packages will include the translated and untranslated content.
|
|
|
type: Content of: <refentry><refsect1><para>
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:49
|
|
|
13.
|
|
|
Once built, the content will be in package-specific directories beneath the <option>BASEDIR</option> specified in the configuration file. For a binary package foo, with translations into German and French, this would result in:
|
|
|
type: Content of: <refentry><refsect1><para>
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:55
|
|
|
14.
|
|
|
BASEDIR/foo/man/man1/foo.1 
BASEDIR/foo/man/de/man1/foo.1
BASEDIR/foo/man/fr/man1/foo.1
|
|
|
type: Content of: <refentry><refsect1><programlisting>
|
|
|
represents a line break.
Start a new line in the equivalent position in the translation.
|
|
|
represents a space character.
Enter a space in the equivalent position in the translation.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:61
|
|
|
15.
|
|
|
This makes it easy to include all the generated content into the binary package with a single install location:
|
|
|
type: Content of: <refentry><refsect1><para>
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:65
|
|
|
16.
|
|
|
doc/foo/man/* ./usr/share/man/
doc/foo/html/* ./usr/share/doc/foo/
|
|
|
type: Content of: <refentry><refsect1><programlisting>
|
|
|
represents a line break.
Start a new line in the equivalent position in the translation.
|
|
|
represents a space character.
Enter a space in the equivalent position in the translation.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:69
|
|
|
17.
|
|
|
This rule will not need to be updated when new translations are added and adding a second binary package (bar) allows the content for that package to kept separate.
|
|
|
type: Content of: <refentry><refsect1><para>
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
share/doc//po4a-build.xml:72
|
