1. NAME

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

2. DESCRIPTION

The po4a (PO for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation.

Locale::Po4a::Docbook is a module to help the translation of DocBook XML documents into other [human] languages.

Please note that this module is still under heavy development, and not distributed in official po4a release since we don't feel it to be mature enough. If you insist on trying, check the CVS out.

3. STATUS OF THIS MODULE

This module is fully functional, as it relies in the Locale::Po4a::Xml module. This only defines the translatable tags and attributes.

The only known issue is that it doesn't handle entities yet, and this includes the file inclusion entities, but you can translate most of those files alone (except the typical entities files), and it's usually better to maintain them separated.

4. SEE ALSO

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

5. AUTHORS

Jordi Vilalta <>

6. COPYRIGHT AND LICENSE

Copyright (c) 2004 by Jordi Vilalta <> Copyright (c) 2007-2009 by Nicolas Franc\*,ois <>

This program is free software; you may redistribute it and/or modify it under the terms of GPL (see the COPYING file).