
        *****************************************************
        *           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::AsciiDoc - converte documenti AsciiDoc 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.

Locale::Po4a::AsciiDoc è un modulo che serve ad aiutare la traduzione di
documentazione nel formato AsciiDoc.

=head1 OPZIONI ACCETTATE DA QUESTO MODULO

Queste sono le opzioni speciali per questo modulo:

=over

=item B<definitions>

Il nome del file contenente le definizioni per po4a, come definito nella
sezione B<PERSONALIZZAZIONE INLINE>.  Si può usare questa opzione se non è
possibile mettere le definizioni nel documento che si sta traducendo.

Nel file delle definizioni, le righe non devono cominciare con due caratteri
di slash, ma direttamente con B<po4a:>.

=item B<entry>

Elenco separato da spazi di voci di attributi che si desidera tradurre. Come
impostaione predefinita, nessuna voce di attributo è traducibile.

=item B<macro>

Elenco separato da spazi di definizioni di macro.

=item B<style>

Elenco separato da spazi di definizioni di stile.

=item B<forcewrap>

Abilita il ritorno a capo automatico nei blocchi non-verbatim, anche se il
risultato potrebbe essere mal interpretato dai compilatori AsciiDoc.

Per impostazione predefinita, po4a non manderà a capo i file AsciiDoc
prodotti perché ciò rende necessaria un'ispezione manuale per controllare
che ciò non cambi la formattazione. Si consideri per esempio il seguente
elenco puntato:

 * a long sentence that is ending with a number 1. A second sentence.

Se l'andare a capo porta alla seguente rappresentazione, l'elenco viene
spezzato in un sotto elenco numerato. A peggiorare le cose, solo i parlanti
della lingua usata nella traduzione possono controllare la situazione.

 * a long sentence that is ending with a number
   1. A second sentence.

Si noti che il non andare a capo dei file prodotti da po4a non dovrebbe
essere un problema dato che questi file sono stati fatti per essere
elaborati automaticamente.  Non dovrebbero comunque essere considerati come
file sorgenti.

Con questa opzione, po4a produrrà file AsciiDoc esteticamente più belli, ma
che possono portare a risultati formattati erroneamente.

=item B<noimagetargets>

Per impostazione predefinita, gli obiettivi dei blocchi immagini sono
traducibili, ciò per fare in modo che il contenuto punti a immagini
tradotte. Questo comportamento può essere evitato impostando questa opzione.

=item B<tablecells>

Questa opzione abilita la segmentazione delle subtabelle in contenuto
cella.  La segmentazione è limitata al contenuto della cella, senza analisi
dell'interno di essa.

=item B<compat>

Commuta le regole di analisi alla compatibilità con diversi strumenti. Le
opzioni disponibili sono "asciidoc" o "asciidoctor". Asciidoctor ha delle
regole più stringenti, come uguale lunghezza dei marcatori di apertura e
chiusura blocchi.

=item B<nolinting>

Disabilita i messaggi di linting. Quando il codice sorgente non può essere
sistemato per mantenere una struttura documentale più chiara, questi
messaggi sono inutili.

=item B<cleanspaces>

Rimuove gli spazi extra dai segmenti sorgenti in modalità no-wrap (non a
capo). Utile quando gli strumenti di traduzione sono sensibili al numero di
spazi.

=item B<yfm_keys>

Elenco di chiavi separate da virgole da elaborare per la traduzione nella
sezione Front Matter YAML. Tutte le altre chiavi vengono saltate. Le chiavi
vengono confrontate distinguendo tra maiuscole e minuscole. Se B<yfm_paths>
e B<yfm_keys> vengono utilizzati insieme, i valori vengono inclusi se
corrispondono ad almeno una delle opzioni. I valori dell'array vengono
sempre tradotti, a meno che non venga fornita l'opzione B<yfm_skip_array>.

=item B<yfm_skip_array>

Indica di non tradurre il valori array nella sezione Front Matter di YAML.

=item B<yfm_paths>

Elenco separato da virgole di percorsi hash da elaborare per l'estrazione
nella sezione Front Matter YAML, tutti gli altri percorsi vengono
ignorati. I percorsi vengono confrontati con distinzione tra maiuscole e
minuscole. Se B<yfm_paths> e B<yfm_keys> vengono utilizzati insieme, i
valori vengono inclusi se corrispondono ad almeno una delle opzioni. I
valori degli array vengono sempre restituiti a meno che non venga fornita
l'opzione B<yfm_skip_array>.

=back

=head1 PERSONALIZZAZIONE INLINE

Il modulo AsciiDoc può essere personalizzato con righe che cominciano con
B<//po4a:>.  Queste righe vengono interpretate come comandi dal parser.
Sono riconosciuti i seguenti comandi:

=over 4

=item B<//po4a: macro >I<nome>B<[>I<elenco attributi>B<]>

Questo descrive in dettaglio i parametri di una B<macro>; I<nome> deve
essere un nome macro valido, e finisce con un carattere di sottolineatura
(underscore) se l'obiettivo va tradotto.

L'argomento I<elenco attributi> è un elenco separato da virgole che contiene
informazioni sugli argomenti traducibili.  Questo elenco contiene numeri,
per definire parametri posizionali, o attributi con nome.

Se un segno più (B<+>) viene preposto a I<nome>, allora la macro ed i suoi
argomenti vengono tradotti come un tutt'uno.  In questo caso non è
necessaria la definizione dell'elenco attributi, ma le parentesi (quadre)
devono essere presenti.

=item B<//po4a: stile >B<[>I<elenco attributi>B<]>

Questo descrivere in dettaglio quali attributi di uno stile devono essere
tradotti.

L'argomento I<elenco attributi> è un elenco separato da virgole che contiene
informazioni sugli argomenti traducibili.  Questo elenco contiene numeri,
per definire parametri posizionali, o attributi con nome.  Il primo
attributo, il nome dello stile, non verrà tradotto.

Se un segno più (B<+>) viene preposto al nome dello stile, allora l'elenco
attributi viene tradotto tutto insieme.  Non c'è necessità di definire
attributi traducibili.

Se un segno meno (B<->) viene preposto al nome dello stile, allora questo
attributo non viene tradotto.

Se al nome dello stile viene posposto un segno di percentuale (B<%>), lo
stile viene elaborato alla lettera. Le righe nel paragrafo o nel blocco di
tale stile vengono conservate nei file po e le voci corrispondenti vengono
contrassegnate come no-wrap.

=item B<//po4a: voce >I<nome>

Questo dichiara una voce attributo come traducibile.  Per impostazione
predefinita, non vengono tradotte.

=back

=head1 STATO DI QUESTO MODULO

Testato con successo su semplici file AsciiDoc.

=head1 AUTORI

 Nicolas François <nicolas.francois@centraliens.net>
 Denis Barbier <barbier@linuxfr.org>


=head1 TRADUZIONE

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

=head1 COPYRIGHT E LICENZA

 Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
 Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
 Copyright © 2017 Martin Quinson <mquinson#debian.org>.

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