.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "PO4A-TRANSLATE 1p" .TH PO4A-TRANSLATE 1p "2023-01-03" "Інструменти Po4a" "Інструменти Po4a" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "НАЗВА" .IX Header "НАЗВА" po4a\-translate —програма для перетворення даних файла \s-1PO\s0 у формат документації .SH "КОРОТКИЙ ОПИС" .IX Header "КОРОТКИЙ ОПИС" \&\fBpo4a\-translate\fR \fB\-f\fR \fIформат\fR \fB\-m\fR \fIосновний.документ\fR \fB\-p\fR \fI\s-1XX\s0.po\fR \fB\-l\fR \fI\s-1XX\s0.doc\fR .PP (\fI\s-1XX\s0.документ\fR є результатом перетворення, усі інші аргументи є файлами вхідних даних) .SH "ОПИС" .IX Header "ОПИС" Метою проєкту po4a (\s-1PO\s0 для усього) є спрощення перекладу (та, що ще цікавіше, супровід перекладів) за допомогою інструментів gettext у областях, де такий переклад спочатку не передбачався, зокрема у документації. .PP Скрипт \fBpo4a\-translate\fR призначено для перетворення перекладу (який було виконано у форматі файла \s-1PO\s0) назад у формат документації. Заданий файл \s-1PO\s0 має бути перекладом файла \s-1POT,\s0 створеного за допомогою \fBpo4a\-gettextize\fR\|(1). .SH "ПАРАМЕТРИ" .IX Header "ПАРАМЕТРИ" .IP "\fB\-f\fR, \fB\-\-format\fR" 4 .IX Item "-f, --format" Формат документації, з якою ви працюватимете. Скористайтеся параметром \fB\-\-help\-format\fR, щоб ознайомитися зі списком доступних форматів. .IP "\fB\-a\fR, \fB\-\-addendum\fR" 4 .IX Item "-a, --addendum" Додати файл до файла результатів (для того, щоб, наприклад, вказати ім'я перекладача або додати розділ «Про цей переклад»). Першим рядком файла, який слід вставити, має бути заголовок \s-1PO4A,\s0 який вказує, куди слід додати дані (див. розділ \fBЯк додавати текст до перекладів\fR у \fBpo4a\fR\|(7)). .IP "\fB\-A\fR, \fB\-\-addendum\-charset\fR" 4 .IX Item "-A, --addendum-charset" Кодування для додатків. Зауважте, що дані усіх додатків мають зберігатися у одному кодуванні. .IP "\fB\-m\fR, \fB\-\-master\fR" 4 .IX Item "-m, --master" Файл, який містить основний документ для перекладу. .IP "\fB\-M\fR, \fB\-\-master\-charset\fR" 4 .IX Item "-M, --master-charset" Кодування символів файла, який містить дані документа, який слід перекласти. .IP "\fB\-l\fR, \fB\-\-localized\fR" 4 .IX Item "-l, --localized" Файл, до якого слід записати перекладений документ. .IP "\fB\-L\fR, \fB\-\-localized\-charset\fR" 4 .IX Item "-L, --localized-charset" Кодування символів файла, який містить дані перекладеного документа. .IP "\fB\-p\fR, \fB\-\-po\fR" 4 .IX Item "-p, --po" Файл, з якого слід прочитати каталог повідомлень. .IP "\fB\-o\fR, \fB\-\-option\fR" 4 .IX Item "-o, --option" Додаткові параметри, які слід передати додатку форматування. Докладніші відомості щодо параметрів кожного з додатків можна знайти у документації до відповідного додатка. Наприклад, ви можете передати «\-o tablecells» до обробника AsciiDoc, а обробнику звичайного тексту можна передати «\-o tabs=split». .IP "\fB\-k\fR, \fB\-\-keep\fR" 4 .IX Item "-k, --keep" Мінімальне порогове значення частки перекладених рядків у відсотках, щоб файл результат було збережено, тобто записано (типове значення: 80). Інакше кажучи, типово, щоб файл було записано, його має бути перекладено принаймні на 80%. .IP "\fB\-w\fR, \fB\-\-width\fR" 4 .IX Item "-w, --width" Позиція, на якій слід переносити рядки у файлі\-результаті. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Показати коротке довідкове повідомлення. .IP "\fB\-\-help\-format\fR" 4 .IX Item "--help-format" Список форматів документації, відомих po4a. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Вивести дані щодо версії скрипту і завершити роботу. .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Збільшити докладність повідомлень програми. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Вивести деякі діагностичні відомості. .IP "\fB\-\-porefs\fR \fIтип\fR[,\fBwrap\fR|\fBnowrap\fR]" 4 .IX Item "--porefs тип[,wrap|nowrap]" Вказує формат посилань. Аргумент \fIтип\fR може мати значення \fBnever\fR, якщо не слід взагалі створювати посилань; \fBfile\fR, якщо слід вказати файл без номерів рядків; \fBcounter\fR, якщо слід замінити номер рядка значенням лічильника; і \fBfull\fR, якщо посилання слід включити повністю (типове значення: full). .Sp За аргументом можна вказати кому і ключове слово \fBwrap\fR або \fBnowrap\fR. Посилання типово записуються в один рядок. Використання ключового слова \fBwrap\fR призведе до перенесення рядків у посиланнях з метою імітувати поведінку інструментів \fBgettext\fR (\fBxgettext\fR і \fBmsgmerge\fR). Цей варіант стане типовим у майбутньому випуску, оскільки його використання має більше сенсу. Варіант \fBnowrap\fR лишиться доступним для користувачів, які хочуть зберегти поведінку попередніх версій програми. .IP "\fB\-\-wrap\-po\fR \fBno\fR|\fBnewlines\fR|\fIчисло\fR (типове значення: 76)" 4 .IX Item "--wrap-po no|newlines|число (типове значення: 76)" Визначає спосіб перенесення рядків у файлі po. Так можна вибрати між файлами із добре перенесеними рядками, які можуть спричиняти конфлікти у git, та файлами, які простіше обробляються автоматично, але є важчими для читання. .Sp Так історично склалося, що комплект програм gettext виконує переформатування файлів po так, щоб рядки було перенесено на 77\-й позиції, з косметичних міркувань. За допомогою цього параметра можна встановити відповідну поведінку po4a. Якщо встановлено числове значення, po4a переноситиме рядки у файлі po після вказаної позиції і після символів розриву рядка у самих рядках. Якщо встановити значення \fBnewlines\fR, po4a розриватиме рядки у msgid і msgstr лише після символів нового рядка у вмісті. Якщо встановити значення \fBno\fR, po4a не переноситиме рядки у файлі po взагалі. Перенесення рядків у коментарях контролюється за допомогою параметра \fB\-\-porefs\fR. .Sp Зауважте, що цей параметр не стосується того, яким чином переноситимуться рядки у msgid і msgstr, тобто того, у який спосіб до цих рядків додаватимуться символи розриву рядків. .SH "Додавання даних (окрім перекладів) до створених файлів" .IX Header "Додавання даних (окрім перекладів) до створених файлів" Щоб додати якісь дані до створеного документа, окрім перекладів (наприклад, ім'я перекладача або розділ «Про цей переклад»), вам слід скористатися параметром \fB\-\-addendum\fR. .PP Першим рядком додатка має бути заголовок, який вказує, куди слід дописати додаток у документі (можна вказати позицію до чи після вказаної частини документа). Решту файла буде додано без змін до документа\-результату без подальшої обробки. .PP Зауважте, що якщо po4a\-translate не вдасться додати один із вказаних файлів, увесь переклад буде відкинуто (оскільки у пропущеному файлі можуть бути дані щодо перекладача, і його нестача може призвести до неможливостя для користувачів зв'язатися із автором перекладу і повідомити йому чи їй про вади у перекладі). .PP Заголовок має доволі строгий синтаксис. Щоб дізнатися більше про те, як скористатися цією можливістю, і як вона працює, будь ласка, зверніться до сторінки підручника щодо <\fBpo4a\fR\|(7)>. .SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ" .IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ" \&\fBpo4a\-gettextize\fR\|(1), \fBpo4a\-normalize\fR\|(1), \fBpo4a\-updatepo\fR\|(1), \fBpo4a\fR\|(7) .SH "АВТОРИ" .IX Header "АВТОРИ" .Vb 3 \& Denis Barbier \& Nicolas François \& Martin Quinson (mquinson#debian.org) .Ve .SH "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ" .IX Header "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ" © \s-1SPI,\s0 inc., 2002–2020. .PP Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання \s-1GPL\s0 (див. файл \s-1COPYING\s0).