Ubuntu Manpage: Locale::Po4a::AsciiDoc - converte documenti AsciiDoc da/a file PO

NOME

       Locale::Po4a::AsciiDoc - converte documenti AsciiDoc da/a file PO

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.

OPZIONI ACCETTATE DA QUESTO MODULO

Queste sono le opzioni speciali per questo modulo:

definitions
Il nome del file contenente le definizioni per po4a, come definito nella sezione 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 po4a:.

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

macro
Elenco separato da spazi di definizioni di macro.

style
Elenco separato da spazi di definizioni di stile.

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:

* una lunga frase che finisce con un numero 1. Una seconda frase.

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.

* una lunga frase che finisce con un numero
1. Una seconda frase.

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 sorgenti più esteticamente belli, ma che possono portare a
risultati formattati erroneamente.

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.

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

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.

yfm_keys
Elenco separato da virgole di chiavi da elaborare per la traduzione nella sezione Front Matter di
YAML. Tutte le altre chiavi vengono ignorate. Le chiavi vengono confrontate senza differenziare tra
maiuscolo e minuscolo. I valori degli array vengono sempre tradotti, a meno che non si usi l'opzione
yfm_skip_array.

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.

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

PERSONALIZZAZIONE INLINE

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

//po4a: macro nome[elenco attributi]
Questo permette di descrivere in dettaglio i parametri di una macro; nome deve essere un nome macro
valido, e finisce con un carattere di sottolineatura (underscore) se l'obiettivo va tradotto.

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

Se un segno più (+) viene preposto a 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.

//po4a: stile [elenco attributi]
Questo permette di descrivere in dettaglio quali attributi di uno stile devono essere tradotti.

Se un segno più (+) 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 (-) viene preposto al nome dello stile, allora questo attributo non viene tradotto.

//po4a: voce nome
Questo dichiara una voce attributo come traducibile. Per impostazione predefinita, non vengono
tradotte.

STATO DI QUESTO MODULO

       Testato con successo su semplici file AsciiDoc.

AUTORI

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

TRADUZIONE

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

COPYRIGHT E LICENZA

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

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

Strumenti Po4a                                     2022-01-02                        Locale::Po4a::AsciiDoc(3pm)