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

po4a-translate - converte un file PO in un documento nel formato originario

=head1 SINTASSI

B<po4a-translate> B<-f> I<formato> B<-m> I<originale.doc> B<-p> I<XX.po> B<-l> I<XX.doc>

dove I<XX.doc> è l'output e tutti gli altri sono input.

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

Il programma B<po4a-translate> si occupa di riconvertire la traduzione (che si trova in un file PO) nel formato d'origine. Il file PO fornito deve essere la traduzione del file POT prodotto da L<po4a-gettextize(1)>.

=head1 OPZIONI

=over 4

=item B<-f>, B<--format>

Formato del documento in questione. L'opzione B<--help-format> mostra l'elenco dei formati disponibili.

=item B<-a>, B<--addendum>

Aggiunge un file al documento risultante; utile per inserire, ad esempio, il nome del traduttore e altre informazioni sulla traduzione. La prima riga del file da inserire deve contenere l'header PO4A, che indica dove aggiungere il file; vedere anche la sezione B<Come si aggiunge del testo extra> in L<po4a(7)>.

=item B<-A>, B<--addendum-charset>

Set di caratteri degli addenda. Tutti gli addenda devono usare la stessa codifica.

=item B<-m>, B<--master>

File contenente il documento originale da tradurre.

=item B<-M>, B<--master-charset>

Set di caratteri del file contenente il documento da tradurre.

=item B<-l>, B<--localized>

File su cui scrivere il documento tradotto.

=item B<-L>, B<--localized-charset>

Set di caratteri del file contenente il documento tradotto.

=item B<-p>, B<--po>

File da cui leggere il catalogo messaggi.

=item B<-o>, B<--option>

Opzioni extra da passare al plugin di formato. Vedere la documentazione per ogni plugin per ulteriori informazioni sulle opzioni valide e sul loro significato. Per esempio si può passare "-o tablecells" al parser AsciiDoc mentre il parser di testo semplice accetta "-o tabs=split".

=item B<-k>, B<--keep>

Minima percentuale di traduzione richiesta affinché il file generato sia conservato e scritto su disco. Il valore predefinito è 80, vale a dire che una traduzione viene accettata solo se è completa almeno per l'80%.

=item B<-w>, B<--width>

Colonna a cui mandare a capo il file risultante.

=item B<-h>, B<--help>

Mostra un breve messaggio di aiuto.

=item B<--help-format>

Elenca i formati di documento gestiti da po4a.

=item B<-V>, B<--version>

Mostra la versione del programma ed esce.

=item B<-v>, B<--verbose>

Rende il programma più prolisso.

=item B<-d>, B<--debug>

Mostra delle informazioni di debug

=item B<--porefs> I<type>[,B<wrap>|B<nowrap>]

Specifica il formato di riferimento. L'argomento I<type> può essere un valore qualsiasi tra: B<never> per non produrre nessun riferimento, B<file> per specificare solo il file senza il numero di riga, B<counter> per rimpiazzare il numero di riga con un contatore incrementale, e B<full> per includere il riferimento completo (valore predefinito: full).

L'argomento può essere seguito da una virgola e da una delle due parole chiave B<wrap> o B<nowrap>.  I riferimenti, come impostazione predefinita, vengono scritti su una singola riga.  L'opzione B<wrap> manda a capo i riferimento su più righe, per emulare il comportamento degli strumenti di B<gettext> (B<xgettext> e B<msgmerge>).  Questa opzione diventerà predefinita in una versione futura, perchè è il comportamento più logico. L'opzione B<nowrap> è disponibile per permettere agli utenti che lo desiderassero, di mantenere il vecchio comportamento.

=item B<--wrap-po> B<no>|B<newlines>|I<numero> (predefinito: 76)

Specifica come il file po deve essere mandato a capo. Consente di scegliere tra file con righe mandate capo ben formattate e quindi ben leggibili ma che potrebbero portare a conflitti in git o file che sono più facili da gestire automaticamente, ma più difficili da leggere per le persone.

Storicamente, la suite gettext riformattava i file po alla 77a colonna per questioni estetiche. Questa opzione specifica il comportamento di po4a. Se impostato su un valore numerico, po4a manderà a capo il file po a questo numero di colonna e dopo i caratteri di a capo nel testo. Se impostato su B<newlines>, po4a dividerà msgstr e msgstr solo dopo i caratteri di a capo nel testo. Se impostato su B<no>, po4a non metterà a capo nel testo del file po. L'andare a capo nei commenti di riferimento viene controllato dall'opzione B<--porefs>.

Si noti che questa opzione non ha alcun impatto sul modo in cui msgstr e msgstr vanno a capo, ovvero su come i caratteri di a capo vengono aggiunti al contenuto di queste stringhe.

=back

=head1 Aggiungere contenuti (oltre alle traduzioni) ai file generati

Per inserire dei contenuti aggiuntivi nel documento generato (come il nome del traduttore e altre informazioni sulla traduzione), usare l'opzione B<--addendum>. 

La prima riga dell'addendum deve contenere un header, che indica la posizione in cui va inserito (può essere prima o dopo una determinata parte del documento). Il resto del file viene copiato testualmente nel documento, senza ulteriori manipolazioni.

Osservare che, se po4a-translate non riesce ad aggiungere anche uno solo dei file specificati, la traduzione viene scartata completamente: il file mancante potrebbe contenere il nome del traduttore e questo impedirebbe agli utenti di contattarlo per segnalare errori nella traduzione).

L'header deve seguire una sintassi piuttosto rigida. Vedere anche la pagina di manuale L<po4a(7)> per maggiori informazioni sull'uso degli addenda.

=head1 VEDERE ANCHE

L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-updatepo(1)>, L<po4a(7)>

=head1 AUTORI

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)


=head1 TRADUZIONE

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

=head1 COPYRIGHT E LICENZA

Copyright 2002-2020 by SPI, inc.

Questo programma è software libero; è lecito ridistribuirlo o modificarlo secondo i termini della licenza GPL (vedere il file COPYING).

