Поддерживайте переводы своей документации с лёгкостью
po4a (PO for anything, PO для всего) упрощает поддержку переводов документации. Он извлекает доступный для перевода материал из оригинального документа и помещает его в PO-файл, который хорошо адаптированный для перевода. Как только этот PO-файл будет обновлён переводчиками, po4a заново вставит переводы в структуру исходного документа, создавая новый переведённый документ.
Если перевод завершён только частично, вместо недостающей части используется исходный (английский) текст. Это гарантирует, что ваша переведённая документация всегда и обновляется по мере обновления исходных документов, и переведена насколько, насколько это возможно.
po4a автоматизирует все задачи по поддержке переводов с помощью только одного файла настроек, содержащего все параметры и список переводимых документов. po4a будет автоматически обновлять их, когда что-то происходит.
Поддерживаемые форматы
в настоящее время po4a поддерживает следующие форматы:
- asciidoc: формат AsciiDoc
- man: good old manual page format
- 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: the info page format
- bibtex: формат bibtex
- text: простые текстовые документы (включая специальные опции для markdown, fortunes, вступительные YAML-секции (Front Matter), debian/changelog и debian/control)
- yaml: документы YAML
- rubydoc: документы RubyDoc (RD)
- halibut: система разработки документации Саймона Тэтхема
- ini: фомат INI
- kernelhelp: справочные сообщения для параметров сборки ядра
2025-07-12— выпуск po4a 0.74
Исправления ошибок и обновление переводов (подробности).
2024-06-17 - выпуск po4a 0.73
Улучшены некоторые сообщения об ошибках, помогающие устранять проблемы с кодировкой, поскольку теперь po4a гораздо более требователен к этому (начиная с версии 0.70). (подробнее).
2024-01-29 - выпуск po4a 0.70
Большая переработка внутренней структуры: PerlIO теперь используется вместо ручного ковыряния с кодировками. Также этот релиз исправляет множество багов в модулях работающих с AsciiDoc, Tex, Markdown, Yaml, TexInfo и в общих частях кода. И наконец, эта версия содержит несколько улучшений в документации, в частности, на странице po4a(7), которая теперь лучше описывает внутреннюю структуру для новых потенциальных разработчиков (подробнее).
2023-01-01 — выпуск po4a 0.69
Greatly improve the handling 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
Значительно улучшили процесс использования gettext и переписали несколько глав документации. Кроме того, использование po4a-translate и po4a-updatepo сейчас считается устаревшим: вместо них следует использовать po4a. И, наконец, в этом релизе исправлено несколько ошибок в модулях Markdown и Man. (подробности).
2022-07-14 — выпуск po4a 0.67
Many bug fixes and improvement in AsciiDoc, Man, Markdown, 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
Позволить группе нескольких переводов на POT файл в раздельном режиме. Исправления ошибок и обновление переводов (подробности).
2021-09-12— выпуск po4a 0.64
Исправления ошибок и обновление переводов (подробности).
2021-02-02 — выпуск po4a 0.63
Исправлена регрессия в 0.62 из-за которой бинарные файлы переводов po4a не устанавливались. Плюс другие исправления ошибок и обновления переводов (подробности).
2020-12-07 - выпуск po4a 0.62
Unwrap AsciiDoc to avoid reformatting issues and other bugfixes, plus translation updates (more details).
2020-08-05 — выпуск po4a 0.61
Исправления ошибок и обновление переводов (подробности).
2020-07-15 — выпуск po4a 0.60
Исправления ошибок и обновление переводов (подробности).
2020-05-20 — выпуск po4a 0.59
Исправления ошибок и обновление переводов (подробности).
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
Новые возможности и исправления ошибок, в основном в парсере AsciiDoc (подробности).
2018-06-30 — выпуск po4a 0.54
Мы исправили кучу багов и устранили много глюков (подробности).
2018-05-25 — выпуск po4a 0.53
Новые возможности и исправления ошибок, в основном в парсере AsciiDoc (подробности).