Поддерживайте переводы своей документации с лёгкостью
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 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
Большая переработка внутренней структуры: PerlIO теперь используется вместо ручного ковыряния с кодировками. Также этот релиз исправляет множество багов в модулях работающих с AsciiDoc, Tex, Markdown, Yaml, TexInfo и в общих частях кода. И наконец, эта версия содержит несколько улучшений в документации, в частности, на странице po4a(7), которая теперь лучше описывает внутреннюю структуру для новых потенциальных разработчиков (подробнее).
2023-01-01 — выпуск po4a 0.69
Значительно улучшили обработку шаблонов в XML и внутреннюю очистку в Yaml, объединив два имеющихся синтаксических анализатора. Кроме того, в этом выпуске исправлены небольшие ошибки в модулях Markdown и Man (подробности).
2022-09-04 — выпуск po4a 0.68
Значительно улучшили процесс использовния gettext и переписали несколько глав документации. Кроме того, использование po4a-translate и po4a-updatepo сейчас считается устаревшим: вместо них следует использоват po4a. И, наконец, в этом релизе испралено несколько ошибок в модулях Markdown и Man. (подробности).
2022-07-14 — выпуск po4a 0.67
Исправления ошибок и улучшения в модулях AsciiDoc, Man, Mardown, xHTML и основных модулях (подробности).
2022-01-02 — выпуск po4a 0.66
Новый параметр для выбора элементов Yaml для перевода; Более надежная обработка таблиц Asciidoc подробности).
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
Отключение переноса строк в asciidoc, дабы избежать приблем с переворматированием и другие исправления ошибок, плюс обновление переводов (подробности).
2020-08-05 — выпуск po4a 0.61
Ещё больше исправлений ошибок (снова, чтобы не ломать зависимости в Debian от po4a) и обновление переводов (подробности).
2020-07-15 — выпуск po4a 0.60
Исправления ошибок и обновление переводов (подробности).
2020-05-20 — выпуск po4a 0.59
Релиз с исправлением ошибок, дабы не ломать сборку нескольких пакетов в Debian (как минимум). Подробности.
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
Новые возможности и исправления ошибок как для отдельных анализаторов, так и для общих частей (подробности).
2018-06-30 — выпуск po4a 0.54
Мы исправили кучу багов и устранили много глюков (подробности).
2018-05-25 — выпуск po4a 0.53
Наиболее заметные изменения – это новый модуль YAML и тот факт, что Alioth был отключён (детали).