НАЗВА

       po4a-gettextize — програма для перетворення початкового файла (і його перекладу) на файл
       PO

КОРОТКИЙ ОПИС

       po4a-gettextize -f формат -m основний.документ [-l XX.документ] -p XX.po

       (XX.po вказує на результат, усі інші вказують на вхідні дані)

ОПИС

       Метою проекту po4a (PO для усього) є спрощення перекладу (та, що ще цікавіше, супровід
       перекладів) за допомогою інструментів gettext у областях, де такий переклад спочатку не
       передбачався, зокрема у документації.

       Скрипт po4a-gettextize відповідає за перетворення файлів документації на файли PO. Якщо ви
       розпочинаєте новий переклад, po4a-gettextize виконає видобування придатних до перекладу
       рядків з файла документації і запише на його основі файл POT.

       Якщо у вас вже є перекладений файл, po4a-gettextize спробує виконати видобування
       перекладів з нього і збереже їх до записаного файла PO. Майте на увазі, що можливості із
       розбору тексту у цьому процесі доволі обмежено: програма просто вважатиме N-ий рядок із
       перекладеного файла перекладом N-го рядка із початкового файла. Якщо це не так, нічого не
       вийде. Ось чому важливо, щоб обидва файли мали абсолютно однакову структуру.

       Втім, po4a-gettextize виявлятиме проблеми із розсинхронізацією файлів і повідомлятиме вам
       про них. Якщо буде виявлено проблему, вам слід виконати редагування вручну, щоб усунути
       розсинхронізацію. Навіть якщо повідомлень про помилки не буде, вам слід уважно вивчити
       створений файл PO і переконатися, що все у ньому як слід (тобто усі рядки msgstr є
       перекладами відповідних рядків msgid, а не якихось сусідніх рядків з тексту).

       Навіть якщо скрипту вдасться виконати завдання без жодних видимих проблем, він все одно
       позначить усі видобуті переклади як неточні, щоб переконатися, що перекладач вивчить їх і
       виявить усі залишкові проблеми.

       Якщо у основному документі є символи, як не є символами ASCII, новостворений файл PO буде
       записано у кодуванні UTF-8 з метою предсталвення нестандартних символів у незалежний від
       локалі спосіб. У інших випадках (якщо основний документ містить лише символи ASCII),
       створений файл PO використовуватиме кодування перекладеного вхідного документа.

ПАРАМЕТРИ

       -f, --format
           Формат документації, з якою ви працюватимете. Скористайтеся параметром --help-format,
           щоб ознайомитися зі списком доступних форматів.

       -m, --master
           Файл, який містить основний документ для перекладу. Ви можете скористатися цим
           параметром декілька разів, якщо ви хочете перетворити на формат gettext декілька
           документів одночасно.

       -M, --master-charset
           Кодування символів файла, який містить дані документа, який слід перекласти.

       -l, --localized
           Файл, який містить дані перекладеного документа. Якщо було вказано декілька основних
           файлів, вам варто вказати декілька перекладених файлів, додавши їх до списку
           декількома використаннями цього параметра у одній команді.

       -L, --localized-charset
           Кодування символів файла, який містить дані перекладеного документа.

       -p, --po
           Файл, до якого слід записати каталог повідомлень. Якщо файл не вказано, каталог
           повідомлень буде записано до стандартного виведення (stdout).

       -o, --option
           Додаткові параметри, які слід передати додатку форматування. Кожен параметр слід
           вказувати у форматі назва=значення. Докладніші відомості щодо параметрів кожного з
           додатків можна знайти у документації до відповідного додатка.

       -h, --help
           Показати коротке довідкове повідомлення.

       --help-format
           Список форматів документації, відомих po4a.

       -V, --version
           Вивести дані щодо версії скрипту і завершити роботу.

       -v, --verbose
           Збільшити докладність повідомлень програми.

       -d, --debug
           Вивести деякі діагностичні відомості.

       --msgid-bugs-address адреса@електронної.пошти
           Встановити адресу для звітування щодо помилок у msgid (початкових неперекладених
           рядках). Типово, у створених файлах POT не буде полів Report-Msgid-Bugs-To.

       --copyright-holder рядок
           Встановити запис авторських прав у заголовку POTr. Типовим значенням є «Free Software
           Foundation, Inc.»

       --package-name рядок
           Встановити назву пакунка для заголовка POT. Типовою є назва пакунка «PACKAGE».

       --package-version рядок
           Встановити версію пакунка для заголовка POT. Типовим є запис «VERSION».

ТАКОЖ ПЕРЕГЛЯНЬТЕ

       po4a-normalize(1), po4a-translate(1), po4a-updatepo(1), po4a(7)

АВТОРИ

        Denis Barbier <barbier@linuxfr.org>
        Nicolas François <nicolas.francois@centraliens.net>
        Martin Quinson (mquinson#debian.org)

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

       © SPI, inc., 2002–2012

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