LOCALE::PO4A::VIMHELP.3PM(1)

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

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.

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

ESTADO DESTE MÓDULO
Este módulo está em uma fase inicial de desenvolvimento. Foi testado com sucesso em arquivos simples como "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.

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).

"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, "1.1 bar") ou uma lista não ordenada (por exemplo, "o baz") não pode ser detectado.

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 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 "|ref|".

Aproveitando "--wrapcol" para monitorar larguras de texto
    Usando a opção "--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 "vim:tw=78:ts=8:noet:ft=help:norl:", como visto em "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:

    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.

    Padrão vs. valores personalizados
        O valor padrão genérico de "--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.

VEJA TAMBÉM
Locale::Po4a::TransTractor(3pm), po4a(7)

AUTORES
 gemmaro <gemmaro.dev@gmail.com>

TRADUÇÃO
 Luiz Fernando Ranghetti <elchevive@opensuse.org>
 Rafael Fontenelle <rafaelff@gnome.org>

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 COPYING).