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.

       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_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  yfm_paths  e  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 yfm_skip_array.

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

       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 yfm_paths e 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 yfm_skip_array.

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  descrive  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
           con nome.

           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 descrivere in dettaglio quali attributi di uno stile devono essere tradotti.

           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
           con nome. Il primo attributo, il nome dello stile, non verrà tradotto.

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

       __END__

       # LocalWords: Charset charset AsciiDoc tablecells po UTF gettext msgid nostrip

Strumenti Po4a                                     2023-01-03                        Locale::Po4a::AsciiDoc(3pm)