НАЗВАНИЕ¶

Locale::Po4a::SimplePod - преобразование POD-данных из/в PO-файлы c помощью Pod::Simple

КРАТКОЕ СОДЕРЖАНИЕ¶

  [po4a_paths] /путь/к/pot $lang:/путь/к/po
  [type:SimplePod] /путь/к/исходнику.pod $lang:/путь/к/переводу.pod

или

  [po4a_paths] /путь/к/pot $lang:/путь/к/po
  [po4a_alias:pod] SimplePod
  [type:pod] /путь/к/исходнику.pod $lang:/путь/к/переводу.pod

ОПИСАНИЕ¶

Этот модуль, предназначенным для помощи в переводе документации в формате POD (предпочтительный язык разметки документации Perl) на другие (человеческие) языки.

Можно отметить следующие основные различия между старым форматом Pod и форматом SimplePod:

• Формат SimplePod никогда не включает дополнительные пустые строки в сообщения для перевода. Старый формат Pod, однако, может содержать лишние пустые строки, особенно в абзацах, в частности в дословных абзацах (извлекаемых без изменения переносов строк).
• Абзацы могут отображаться с переносом строк. Модуль Pod::Parser может применять специальную обработку для переносов строк, что затрудняет воспроизведение такого поведения с помощью Pod::Simple. Однако, вывод Pod::Simple кажется более естественным.
• В модуле SimplePod сообщение "=for" (например, "=for comment text") не включает название формата (например, "comment"), так что сообщение содержит исключительно текст. В отличие от этого, текущий модуль Pod сохраняет наименование формата, в результате сообщение выглядит как "comment text". Предыдущий вариант считается более удобным для переводчиков.
• Записи, подобные приведенной ниже, которые обозначают "=end comment", больше не отображаются в текущем модуле Pod. Поскольку эти сообщения не поддаются переводу, их отсутствие является улучшением.

    #. type: =end
    #: sample.pod:10
    msgid "comment"
    msgstr ""
      

• Текстовые блоки, допустимость формата POD для которых неизвестна, теперь обрабатываются как "no-wrap". Это относится, например, к содержимому внутри блока "=begin html". В модуле Pod они не рассматривались как "no-wrap", что иногда приводило к переносу строк.
• Параметр "=begin" больше не подлежит переводу. В текущем модуле Pod он включен. Если есть необходимость включить его в перевод, пожалуйста, сообщите об этом.

СОСТОЯНИЕ ЭТОГО МОДУЛЯ¶

Этот модуль появился недавно и все еще разрабатывается, поэтому он менее стабилен, чем Locale::Po4a::Pod. Он продолжает развиваться, и есть возможности для дальнейшей доработки. Со временем его поведение может измениться, и могут быть добавлены дополнительные опции для оптимизации процесса перевода для пользователей. Отзывы и примеры использования из реальных приложений будут играть ключевую роль в его дальнейшем развитии.

Код полностью протестирован нашим набором тестов, и мы не знаем о каких-либо существующих ошибках. Однако, по состоянию на 2025 год, он не тестировался в реальных рабочих процессах перевода внешними проектами. Тем не менее, мы считаем, что модуль готов к использованию в производственной среде, даже если по мере его распространения неизбежно будут обнаружены некоторые ошибки.

Этот модуль предназначен для замены модуля Locale::Po4a::Pod. Причина в том, что Pod::Parser, который используется текущим Locale::Po4a::Pod, теперь устарел, и вместо него рекомендуется использовать Pod::Simple. См. GitHub issue #256 "Consider migrating away from deprecated "Pod::Parser"" <https://github.com/mquinson/po4a/issues/256>.

СМОТРИТЕ ТАКЖЕ¶

Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, po4a(7), Locale::Po4a::SimplePod::Parser.

АВТОРЫ¶

  gemmaro <gemmaro.dev@gmail.com>

АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ¶

  Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.

Данная программа является свободным программным обеспечением; вы можете распространять и/или изменять её на условиях Универсальной общественной лицензии (GPL) GNU v2.0 или новее (см. файл COPYING).