
        *****************************************************
        *           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 file di aiuto Vim da/a file PO.

=head1 DESCRIZIONE

L'obiettivo del progetto po4a (PO per tutto) è di facilitare le traduzioni
(e cosa più interessante, la manutenzione delle traduzioni) usando gli
strumenti associati a gettext in aree inaspettate come la documentazione.

C<Locale::Po4a::VimHelp> è un modulo per aiutare la traduzione del file di
aiuto di Vim. Vedere anche L<Scrivere di file di
aiuto|https://vimhelp.org/helphelp.txt.html#help-writing> per la sua
sintassi.

=head1 STATO DI QUESTO MODULO

Questo modulo è in una fase iniziale di sviluppo. È stato testato con
successo su file semplici come C<helphelp.txt>. Tuttavia, non è ancora stato
testato su file di aiuto completi e il modo in cui li analizza potrebbe
cambiare a causa di correzioni e miglioramenti, in particolare la parte che
gestisce l'interruzione di paragrafo.

=head1 SVILUPPO

L'analisi dei file di aiuto di Vim per po4a è difficile. Ecco alcuni
ostacoli durante lo sviluppo di questo modulo. Se si pensa di aver avuto
un'idea migliore, sentitevi liberi di suggerire una patch (con test
aggiuntivi).

=over

=item C<1. foo> sembra un elenco ordinato

Non necessariamente. Si consideri il seguente paragrafo.

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

Per lo stesso motivo, ciò che sembra essere un'intestazione (ad esempio
C<1.1 bar>) o un elenco non ordinato (ad esempio C<o baz>) non può essere
rilevato.

=item I tag svuotati a destra dovrebbero essere esclusi dall'obiettivo di
traduzione

Anche questo argomento è difficile perché riguarda le differenze
linguistiche nella localizzazione.

Si consideri il seguente esempio.

 Such a common and short concept in some languages *tags*

che potrebbe essere tradotto in

 They are unfamiliar, there are no corresponding concepts and *tags*
 it takes a longer sentence to express them in this language

Quando ciò accade, bisogna decidere a che punto si vuole aggiungere un
marcatore I<nicely>. Non dovrebbe essere facile. Il file di aiuto di Vim è
in un formato con ritorni a capo non modificabili, anche per le parti che
non sono blocchi di codice.

Lo stesso vale per i riferimenti a marcatori come C<|ref|>.

=item Utilizzo di C<--wrapcol> per monitorare la larghezza del testo

Usare l'opzione C<--wrapcol> per visualizzare avvisi quando la larghezza del
testo supera i limiti specificati sembra un approccio ragionevole. I file di
aiuto ufficiali di Vim presentano una riga di modalità, come
C<vim:tw=78:ts=8:noet:ft=help:norl:>, come mostrato in
L<C<runtime/doc/if_perl.txt>|https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>.
Tuttavia, ci sono alcune difficoltà da considerare:

=over

=item Comportamento dell'analisi dei file

Se questa opzione viene implementata, sarebbe ideale leggere prima l'intero
file, verificare se la riga di modalità esiste e determinare quali sezioni
sono interessate. Purtroppo, in questo caso il meccanismo di analisi
progressiva non viene utilizzato.

=item Valori predefiniti contro personalizzati

Il valore predefinito generico di C<--wrapcol> è 76, mentre i file di aiuto
di Vim usano comunemente 78. Nella maggior parte dei casi, il valore nelle
opzioni passate a questo modulo è impostato di default su 76, ma non è
chiaro se questo valore sia stato impostato esplicitamente o applicato
implicitamente.

=back

=back

=head1 VEDERE ANCHE

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

=head1 AUTORI

 gemmaro <gemmaro.dev@gmail.com>


=head1 TRADUZIONE

 Danilo Piazzalunga <danilopiazza@libero.it>
 Marco Ciampa <ciampix@posteo.net>

=head1 COPYRIGHT E LICENZA

 Copyright © 2024, 2025 gemmaro.

Questo programma è software libero; è lecito ridistribuirlo o modificarlo
secondo i termini della licenza GPL v2.0 o successive (vedere il file
F<COPYING>).
