
        *****************************************************
        *           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 NOME

Locale::Po4a::VimHelp - converte arquivos de juda Vim de/para arquivos PO.

=head1 DESCRIÇÃO

O objetivo do projeto po4a (PO for anything, ou PO para qualquer coisa) é
facilitar traduções (e o mais interessante, a manutenção das traduções)
usando as ferramentas do gettext em áreas em que não se esperava, como
documentação.

C<Locale::Po4a::VimHelp> é um módulo para ajudar a tradução do arquivo de
ajuda do Vim. Veja também L<Escrevendo arquivos de
ajuda|https://vimhelp.org/helphelp.txt.html#help-writing> (em inglês) para
sua sintaxe.

=head1 ESTADO DESTE MÓDULO

Este módulo está em uma fase inicial de desenvolvimento. Foi testado com
sucesso em arquivos simples como C<helphelp.txt>. No entanto, ainda não foi
testado em arquivos de ajuda completa, e a forma como analisá-los pode mudar
para correções e melhorias, especialmente quebra de linha de parágrafos.

=head1 DESENVOLVIMENTO

A análise de arquivos de ajuda do Vim para po4a é difícil. Aqui estão alguns
obstáculos ao desenvolver este módulo. Se você tem uma ideia melhor,
sinta-se livre para sugerir um patch (com casos de teste adicionais).

=over

=item C<1. foo> parece uma lista ordenada

Não necessariamente. Considere o parágrafo seguinte.

 Existem 2 tanukis errantes, não
 1. Ele está usando sua técnica de clonagem.

Pela mesma razão, o que parece ser um cabeçalho (por exemplo, C<1.1 bar>) ou
uma lista não ordenada (por exemplo, C<o baz>) não pode ser detectado.

=item As tags da direita fluidas devem ser excluídas do alvo de tradução

Este tópico também é difícil, uma vez que se relaciona com as diferenças
linguísticas na localização.

Considere o seguinte exemplo.

 Tal conceito comum e curto em alguns idiomas *tags*

que pode ser traduzido para

 Eles são desconhecidos, não há conceitos correspondentes e *tags*
 leva uma sentença mais longa para expressá-los neste idioma

Quando isso acontece, você tem que decidir em que ponto você quer adicionar
uma tag I<de forma agradável>. Isto não deve ser fácil. O arquivo de ajuda
do Vim está em um formato de quebra rígida, mesmo para partes que não são
blocos de código.

O mesmo se aplica a referências de tags como C<|ref|>.

=item Aproveitando C<--wrapcol> para monitorar larguras de texto

Usando a opção C<--wrapcol> para emitir avisos quando a largura do texto
excede os limites especificados parece uma abordagem razoável. Os arquivos
oficiais de ajuda do Vim apresentam uma linha de modo, como
C<vim:tw=78:ts=8:noet:ft=help:norl:>, como visto em
L<C<runtime/doc/if_perl.txt>|https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>.
No entanto, existem alguns desafios a considerar:

=over

=item Comportamento de análise de arquivo

Se essa opção for implementada, seria ideal ler o arquivo inteiro primeiro,
detectar se a linha de modo existe e determinar quais seções são
afetadas. Infelizmente, o mecanismo de análise progressiva não é empregado
neste caso.

=item Padrão vs. valores personalizados

O valor padrão genérico de C<--wrapcol> é 76, enquanto os arquivos de ajuda
do Vim comumente usam 78. Na maioria dos casos, o valor nas opções passadas
para este módulo padrão para 76, mas não é claro se esse valor foi
explicitamente definido ou aplicado implicitamente.

=back

=back

=head1 VEJA TAMBÉM

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

=head1 AUTORES

 gemmaro <gemmaro.dev@gmail.com>


=head1 TRADUÇÃO

 Luiz Fernando Ranghetti <elchevive@opensuse.org>
 Rafael Fontenelle <rafaelff@gnome.org>

=head1 COPYRIGHT E LICENÇA

 Copyright © 2024, 2025 gemmaro.

Esse programa é um software livre; você pode redistribuí-lo e/ou modificá-lo
sob os termos da GPL v2.0 ou posterior (veja o arquivo F<COPYING>).
