
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 НАЗВА

Locale::Po4a::VimHelp — перетворення файлів довідки до Vim на файли PO, і
навпаки

=head1 ОПИС

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

C<Locale::Po4a::VimHelp> — допоміжний модуль для перекладу файлів довідки до
Vim. Див. також L<створення файлів
довідки|https://vimhelp.org/helphelp.txt.html#help-writing>, щоб дізнатися
більше про синтаксис.

=head1 СТАН ЦЬОГО МОДУЛЯ

Цей модуль перебуває на початковій стадії розробки. Його успішно перевірено
на простих файлах, зокрема C<helphelp.txt>. Втім, перевірка на повноцінних
файлах довідки усе ще попереду, і спосіб обробки може бути виправлено і
удосконалено, особливо у перенесенні рядків в абзацаї.

=head1 РОЗРОБКА

Обробка файлів довідки Vim для po4a є складною справою. Тут наведено лише
декілька проблем, які виявлено під час розробки цього модуля.is
difficult. Якщо у вас є якісь ідеї, не соромтеся надіслати латку (із
додатковими перевірками).

=over

=item C<1. foo> — виглядає як упорядкований список

Не непотрібним. Зверніться до наступного абзацу.

 There are 2 wandering tanukis, not
 1. He's using his cloning technique.

З тої самої причини, те, що виглядає як заголовок (наприклад C<1.1 bar>) або
невпорядкований список (наприклад C<o baz>) не може бути виявлено.

=item Виключені праві теґи слід виключити з цілей перекладу

Це проблемна тема іще і через те, що її пов'язано із відмінностями мов
перекладу.

Розгляньмо такий приклад.

 Типове і коротке поняття у деяких мовах, *теґи*

яке може бути перекладено як

 Теґи є незвичними, немає відповідних понять і *теґів*
 потрібне довше речення, щоб пояснити їх у відповідній мові

Коли таке трапляється, вам доведеться вирішувати, де ви хочете додати теґ
I<коректно>. Це не просто. Файл довідки до Vim має формат із жорстким
перенесенням рядків, навіть для частин, які не є блоками програмного коду.

Те саме, стосується посилань на теґи, зокрема C<|ref|>.

=item Використання C<--wrapcol> для стеження за шириною тексту

Використання параметра C<--wrapcol> для видачі попереджень, коли ширина
тексту перевищує задані межі, здається розумним підходом. Офіційні файли
довідки Vim містять рядок режиму, такий як
C<vim:tw=78:ts=8:noet:ft=help:norl:>, як показано в
L<C<runtime/doc/if_perl.txt>|https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>.
Однак, є кілька проблем, які слід врахувати:

=over

=item Поведінка при обробці файла

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

=item Типові і нетипові значення

Загальне типове значення для C<--wrapcol> становить 76, тоді як у файлах
довідки Vim зазвичай використовується 78. У більшості випадків значення у
параметрах, що передаються цьому модулю, типово дорівнює 76, але
незрозуміло, чи це значення було встановлено явно, чи застосовано неявно.

=back

=back

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

L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 АВТОРИ

 gemmaro <gemmaro.dev@gmail.com>

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

 © gemmaro, 2024, 2025.

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