轻松地维护文档的翻译
The po4a (PO for anything) eases documentation translations and their maintenance. It extracts the translatable material from the original document, and places it into a PO file that is adapted to the translation process. Once this PO file is updated by the translator, po4a re-injects the translation into the structure of the original document to generate a translated document.
If the translation is only partial, the original (English) text is used instead for the missing parts. This ensures that your translated documentation is always both up to date with regard to the original one, and as translated as possible.
po4a automatizes all the translation maintenance with one configuration file containing the settings and a list of documents to translate. po4a will update them automatically when something happens.
支持的格式
po4a 目前支持以下格式:
- asciidoc: AsciiDoc 格式
- man: 老旧的手册页面格式
- pod: Perl 在线文档 (POD) 格式
- xml: 通用 XML 文档
- docbook: DocBook XML
- xhtml: XHTML 文档
- dia: 未压缩的 DIA 图表
- guide: Gentoo Linux 的 XML 文档格式
- wml: WML 文档
- sgml: 标准通用标记语言 (SGML) 用于 DebianDoc 或 DocBook DTD
- latex: LaTeX 格式
- tex: 通用 TeX 文档
- texinfo: 信息页面格式
- bibtex: bibtex 格式
- text: 简单的文本文档 (包括 markdown、fortunes、YAML 主要内容部分、Debian/Changelog 和 Debian/Control 的选项)
- yaml: YAML 文档
- rubydoc: RubyDoc (RD) 文档
- halibut: 西蒙·塔瑟姆 (Simon Tatham's) 的文件生产系统
- ini: INI 格式
- kernelhelp: 每个内核编译选项的帮助消息
2024-06-17 - po4a 0.73 released
Improve some error messages to help debugging encoding issues now that po4a is much more picky about it (since v0.70). (more details).
2024-01-29 - po4a 0.70 released
Major internal overhaul to use PerlIO instead of messing up manually with encodings. Also, this release fixes many bugs in AsciiDoc, Tex, Markdown, Yaml, TexInfo and in the common parts. Finally, this version contains several documentation improvements, in particular in po4a(7), which now better introduces the internals to potential contributors. (more details).
2023-01-01 - po4a 0.69 released
Greatly improve the handeling of placeholders in XML, and internal cleanups around Yaml by merging the two parsers that we had. Also, this release fixes small bugs in Markdown and Man modules. (more details).
2022-09-04 - po4a 0.68 released
Greatly improve the gettextization process, and rewrite several documentation chapters. Also, po4a-translate and po4a-updatepo are now deprecated: you should use po4a instead. Finally, this release fixes some bugs in Markdown and Man modules. (more details).
2022-07-14 - po4a 0.67 released
Many bug fixes and improvement in AsciiDoc, Man, Mardown, xHTML and in core modules (more details).
2022-01-02 - po4a 0.66 发布
New option to select Yaml elements to translate; More robust Asciidoc table handling (+bugfixes and translation updates -- more details).
2021-11-14 - po4a 0.65 发布
Allow to group several translations per POT file in split mode (+bugfix and translation updates -- more details).
2021-09-12 - po4a 0.64 发布
错误修复和翻译更新 (更多细节)。
2021-02-02 - po4a 0.63 发布
Fix a regression in 0.62 where the translation of po4a binaries were not installed. Plus other bugfixes and translation updates (more details).
2020-12-07 - po4a 0.62 发布
Unwrap asciidoc to avoid reformating issues and other bugfixes, plus translation updates (more details).
2020-08-05 - po4a 0.61 发布
More bugfix (again to not break Debian packages depending on po4a), and translation updates (more details).
2020-07-15 - po4a 0.60 发布
错误修复和翻译更新 (更多细节)。
2020-05-20 - po4a 0.59 发布
Bugfix release to not break the build of several Debian packages (at least). More details.
2020-05-04 - po4a 0.58 发布
- 重写所有测试,使它们更健壮,不那么宽松。
- 修复针对解析器报告的许多问题。
- 为清晰和简洁起见,重写文档。
- (更多细节)。
2019-10-25 - po4a 0.57 发布
AsciiDoc 中的翻译更新和一个错误修复。 (更多细节)。
2019-06-06 – po4a 0.56发布
新特性和错误修复,主要针对 AsciiDoc 解析器 (更多细节)。
2018-12-09 - po4a 0.55 发布
New features and bugfixes to both the individual parsers and common parts (more details).
2018-06-30 - po4a 0.54 发布
我们修复了大量的 bug,并消除了许多错误更多细节。
2018-05-25 - po4a 0.53 发布
The most visible change is a new YAML module, and the fact that Alioth was turned off (more details).