1Locale::Po4a::Docbook(3pm)        Po4a Tools        Locale::Po4a::Docbook(3pm)
2
3
4

NAME

6       Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files
7

DESCRIPTION

9       The po4a (PO for anything) project goal is to ease translations (and
10       more interestingly, the maintenance of translations) using gettext
11       tools on areas where they were not expected like documentation.
12
13       Locale::Po4a::Docbook is a module to help the translation of DocBook
14       XML documents into other [human] languages.
15

STATUS OF THIS MODULE

17       This module is fully functional, as it relies in the Locale::Po4a::Xml
18       module. This only defines the translatable tags and attributes.
19
20       The only known issue is that it doesn't handle entities yet, and this
21       includes the file inclusion entities, but you can translate most of
22       those files alone (except the typical entities files), and it's usually
23       better to maintain them separated.
24

OVERRIDE THE DEFAULT BEHAVIOR WITH COMMAND LINE OPTIONS

26       The default behavior of system provided modules is set to be on the
27       safe side.
28
29       For example, the default of <author> tag is aiming it to appear under
30       <para>.  But you may be using it only under <bookinfo>.  For this case,
31       you may want to translate it independently for each author.
32
33       If you don't like the default behavior of the xml module and its
34       derivative modules, you can provide command line options to change
35       their behavior.  For example, you can add the following to the po4a
36       configuration file:
37
38         opt:"-k 0 -o nodefault=\"<bookinfo> <author>\" \
39                   -o break=\"<bookinfo> <author>\" \
40                   -o untranslated=\"<bookinfo>\" \
41                   -o translated=\"<author>\""
42
43       This overrides the default behavior for <bookinfo> and <author>, set
44       <bookinfo> and <author> to break input data stream on these tags, set
45       <bookinfo> not to translate its tagged content, and set <author> to
46       translate its tagged content.
47

SEE ALSO

49       Locale::Po4a::TransTractor(3pm), Locale::Po4a::Xml(3pm), po4a(7)
50

AUTHORS

52        Jordi Vilalta <jvprat@gmail.com>
53
55        Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>
56        Copyright © 2007-2009 Nicolas François <nicolas.francois@centraliens.net>
57
58       This program is free software; you may redistribute it and/or modify it
59       under the terms of GPL (see the COPYING file).
60
61
62
63Po4a Tools                        2022-01-21        Locale::Po4a::Docbook(3pm)
Impressum