.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" 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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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 .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LOCALE::PO4A::VIMHELP.3PM 1" .TH LOCALE::PO4A::VIMHELP.3PM 1 2025-11-22 "perl v5.42.0" "User Contributed Perl Documentation" .\" 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 "НАЗВА" Locale::Po4a::VimHelp — перетворення файлів довідки до Vim на файли PO, і навпаки .SH ОПИС .IX Header "ОПИС" Метою проєкту po4a (PO для усього) є спрощення перекладу (та, що ще цікавіше, супровід перекладів) за допомогою інструментів gettext у областях, де такий переклад спочатку не передбачався, зокрема у документації. .PP \&\f(CW\*(C`Locale::Po4a::VimHelp\*(C'\fR — допоміжний модуль для перекладу файлів довідки до Vim. Див. також створення файлів довідки , щоб дізнатися більше про синтаксис. .SH "СТАН ЦЬОГО МОДУЛЯ" .IX Header "СТАН ЦЬОГО МОДУЛЯ" Цей модуль перебуває на початковій стадії розробки. Його успішно перевірено на простих файлах, зокрема \f(CW\*(C`helphelp.txt\*(C'\fR. Втім, перевірка на повноцінних файлах довідки усе ще попереду, і спосіб обробки може бути виправлено і удосконалено, особливо у перенесенні рядків в абзацаї. .SH РОЗРОБКА .IX Header "РОЗРОБКА" Обробка файлів довідки Vim для po4a є складною справою. Тут наведено лише декілька проблем, які виявлено під час розробки цього модуля.is difficult. Якщо у вас є якісь ідеї, не соромтеся надіслати латку (із додатковими перевірками). .ie n .IP """1. foo"" — виглядає як упорядкований список" 4 .el .IP "\f(CW1. foo\fR — виглядає як упорядкований список" 4 .IX Item "1. foo — виглядає як упорядкований список" Не непотрібним. Зверніться до наступного абзацу. .Sp .Vb 2 \& There are 2 wandering tanukis, not \& 1. He\*(Aqs using his cloning technique. .Ve .Sp З тої самої причини, те, що виглядає як заголовок (наприклад \f(CW\*(C`1.1 bar\*(C'\fR) або невпорядкований список (наприклад \f(CW\*(C`o baz\*(C'\fR) не може бути виявлено. .IP "Виключені праві теґи слід виключити з цілей перекладу" 4 .IX Item "Виключені праві теґи слід виключити з цілей перекладу" Це проблемна тема іще і через те, що її пов\*(Aqязано із відмінностями мов перекладу. .Sp Розгляньмо такий приклад. .Sp .Vb 1 \& Типове і коротке поняття у деяких мовах, *теґи* .Ve .Sp яке може бути перекладено як .Sp .Vb 2 \& Теґи є незвичними, немає відповідних понять і *теґів* \& потрібне довше речення, щоб пояснити їх у відповідній мові .Ve .Sp Коли таке трапляється, вам доведеться вирішувати, де ви хочете додати теґ \&\fIкоректно\fR. Це не просто. Файл довідки до Vim має формат із жорстким перенесенням рядків, навіть для частин, які не є блоками програмного коду. .Sp Те саме, стосується посилань на теґи, зокрема \f(CW\*(C`|ref|\*(C'\fR. .ie n .IP "Використання ""\-\-wrapcol"" для стеження за шириною тексту" 4 .el .IP "Використання \f(CW\-\-wrapcol\fR для стеження за шириною тексту" 4 .IX Item "Використання --wrapcol для стеження за шириною тексту" Використання параметра \f(CW\*(C`\-\-wrapcol\*(C'\fR для видачі попереджень, коли ширина тексту перевищує задані межі, здається розумним підходом. Офіційні файли довідки Vim містять рядок режиму, такий як \&\f(CW\*(C`vim:tw=78:ts=8:noet:ft=help:norl:\*(C'\fR, як показано в \&\f(CW\*(C`runtime/doc/if_perl.txt\*(C'\fR . Однак, є кілька проблем, які слід врахувати: .RS 4 .IP "Поведінка при обробці файла" 4 .IX Item "Поведінка при обробці файла" Якщо реалізовано цей параметр, ідеально було б спочатку прочитати весь файл, визначити, чи є рядок режиму, та визначити, на які роздівли він впливає. На жаль, у цьому випадку механізм попступової обробки не використовується. .IP "Типові і нетипові значення" 4 .IX Item "Типові і нетипові значення" Загальне типове значення для \f(CW\*(C`\-\-wrapcol\*(C'\fR становить 76, тоді як у файлах довідки Vim зазвичай використовується 78. У більшості випадків значення у параметрах, що передаються цьому модулю, типово дорівнює 76, але незрозуміло, чи це значення було встановлено явно, чи застосовано неявно. .RE .RS 4 .RE .SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ" .IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ" \&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7) .SH АВТОРИ .IX Header "АВТОРИ" .Vb 1 \& gemmaro .Ve .SH "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ" .IX Header "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ" .Vb 1 \& © gemmaro, 2024, 2025. .Ve .PP Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої (див. файл \fICOPYING\fR).або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої (див. файл \fICOPYING\fR).