Поддерживайте переводы своей документации с лёгкостью
po4a (PO for anything, PO для всего) упрощает поддержку переводов документации. Он извлекает доступный для перевода материал из оригинального документа и помещает его в PO-файл, который хорошо адаптированный для перевода. Как только этот PO-файл будет обновлён переводчиками, po4a заново вставит переводы в структуру исходного документа, создавая новый переведённый документ.
Если перевод завершён только частично, вместо недостающей части используется исходный (английский) текст. Это гарантирует, что ваша переведённая документация всегда и обновляется по мере обновления исходных документов, и переведена насколько, насколько это возможно.
po4a автоматизирует все задачи по поддержке переводов с помощью только одного файла настроек, содержащего все параметры и список переводимых документов. po4a будет автоматически обновлять их, когда что-то происходит.
Поддерживаемые форматы
в настоящее время po4a поддерживает следующие форматы:
- asciidoc: формат AsciiDoc
- man: старый добрый формат man-страниц
- pod: формат Perl Online Documentation (POD)
- xml: XML-документы
- docbook: DocBook XML
- xhtml: документы XHTML
- dia: несжатые диаграммы Dia
- guide: формат документации Gentoo Linux XML
- wml: документы WML
- sgml: Standard Generalized Markup Language (SGML), обычно используется в DebianDoc или DocBook DTD
- latex: форматLaTeX
- tex: обычные документы TeX
- texinfo: формат страниц info
- bibtex: формат bibtex
- text: простые текстовые документы (включая специальные опции для markdown, fortunes, вступительные YAML-секции (Front Matter), debian/changelog и debian/control)
- yaml: документы YAML
- rubydoc: документы RubyDoc (RD)
- halibut: система разработки документации Саймона Тэтхема
- ini: фомат INI
- kernelhelp: справочные сообщения для параметров сборки ядра
2024-06-17 - выпуск po4a 0.73
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
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
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
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
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
Мы исправили кучу багов и устранили много глюков (подробности).
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).