Maintain the translations of your documentation with ease
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.
po4a extracts the translatable material from the original document, and places it into a PO file that is well adapted to the translation work.
Once the translation is completed in the PO file, po4a re-injects the translation into the structure of the document to generate a translated document.
If the translation is only partially completed, the original (english) text is used instead. This ensures that your translated documentation is always both up to date with regard to the original one, and as translated as possible.
You can fully automatize the translation maintenance with a single configuration file, specifying all settings and the list of documents to translate. With this information, po4a automatically determines the files to update when something changes.
Supported formats
po4a currently supports the following formats:
- manpages
- POD
- XML (generic, DocBook, XHTML, Dia, Guide, or WML)
- SGML
- TeX (generic, LaTeX, or Texinfo)
- text (simple text files with some formatting, markdown, or AsciiDoc)
- INI
- KernelHelp
2020-15-07 - po4a 0.60 released
Bug fix and translation updates (more details).
2020-20-05 - po4a 0.59 released
Bug fix release to not break the build of several Debian packages (at least). More details.
2020-05-04 - po4a 0.58 released
- Rewrite all tests to make them more robust and less permissive.
- Fix many issues reported against the parsers.
- Rewrite the documentation for sake of clarity and brevity.
- (more details).
2019-10-25 - po4a 0.57 released
Translation update and one bug fix in AsciiDoc. (more details).
2019-06-06 - po4a 0.56 released
New features and bug fixes, mostly to the AsciiDoc parser (more details).
2018-12-09 - po4a 0.55 released
New features and bug fixes to both the individual parsers and common parts (more details).
2018-06-30 - po4a 0.54 released
We fixed tons of bugs, and removed many glitches (more details).
2018-05-25 - po4a 0.53 released
The most visible change is a new YAML module, and the fact that alioth was turned off (more details).