НАЗВА¶

Locale::Po4a::SimplePod — перетворення даних POD на файли PO, і навпаки, за допомогою 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 коментар текст") не містить назви формату (наприклад, "коментар"), тому повідомлення складається виключно з тексту. Натомість, поточний формат Pod зберігає назву формату, у результаті чого виникає повідомлення типу "коментар текст". Перший варіант вважається зручнішим для перекладачів.
• Записів, подібні до наведеного нижче, що позначають "=кінець коментаря", більше немає, як це трапляється у поточному модулі 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 256 "Consider migration 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>

АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ¶

  © gemmaro <gemmaro.dev@gmail.com>, 2025.

Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої (див. файл COPYING).