NOME¶

Locale::Po4a::SimplePod - converte dati POD da/a file PO, tramite Pod::Simple

SINTASSI¶

  [po4a_paths] /percorso/per/pot $lang:/percorso/per/po
  [type:SimplePod] /percorso/per/source.pod $lang:/percorso/per/localized.pod

o

  [po4a_paths] /percorso/per/pot $lang:/path/to/po
  [po4a_alias:pod] SimplePod
  [type:pod] /percorso/per/source.pod $lang:/percorso/per/localized.pod

DESCRIZIONE¶

Questo è un modulo che aiuta la traduzione in altre lingue della documentazione in formato POD (il formato preferito per la documentazione del Perl).

Le principali differenze tra l'attuale formato Pod e il formato SimplePod sono le seguenti:

• Il formato SimplePod non include mai nuove righe aggiuntive nei messaggi da tradurre. L'attuale formato Pod, tuttavia, potrebbe contenere nuove righe aggiuntive, in particolare nelle voci verbatim.
• I paragrafi possono venire resi con il ritorno a capo. Il modulo Pod::Parser potrebbe applicare una gestione speciale per il ritorno a capo, rendendo difficile la replica con Pod::Simple. Tuttavia, Pod::Simple sembra produrre risultati più naturali.
• In SimplePod, il messaggio "=for" (ad esempio, "=for comment text") non include un nome di formato (come "comment"), quindi il messaggio è composto esclusivamente da testo. Al contrario, il formato Pod attuale mantiene il nome del formato, risultando in un messaggio del tipo "comment text". Il primo comportamento è considerato più comodo per i traduttori.
• Voci come quella qui sotto, che indicano "=end comment", non sono più presenti nell'attuale modulo Pod. Poiché non si tratta di messaggi traducibili, la loro assenza rappresenta un miglioramento.

    #. type: =end
    #: sample.pod:10
    msgid "commento"
    msgstr ""
      

• I blocchi di testo la cui validità del formato POD è incerta vengono ora trattati come "no-wrap". Questo vale, ad esempio, per il contenuto all'interno di un blocco "=begin html". Nel modulo Pod, questi non venivano trattati come "no-wrap", il che a volte comportava il ritorno a capo automatico.
• La sezione del parametro "=begin" non è più soggetta a traduzione. È inclusa nell'attuale modulo Pod. Se c'è una richiesta di includerla nella traduzione, vi preghiamo di segnalarcelo.

STATO DI QUESTO MODULO¶

Questo modulo è ancora in fase di sviluppo, quindi è meno stabile di Locale::Po4a::Pod. Continua a evolversi e c'è spazio per ulteriori perfezionamenti. Il suo comportamento potrebbe cambiare nel tempo e potrebbero essere introdotte opzioni aggiuntive per ottimizzare l'esperienza di traduzione per gli utenti. Il feedback e i casi d'uso derivanti da applicazioni reali svolgeranno un ruolo chiave nel guidarne lo sviluppo futuro.

Il codice è completamente coperto dalla nostra suite di test e non siamo a conoscenza di alcun bug esistente. Tuttavia, al 2025, non è stato ancora testato sul campo in flussi di lavoro di traduzione reali da progetti esterni. Detto questo, riteniamo che il modulo sia pronto per l'uso in produzione, anche se alcuni difetti potrebbero inevitabilmente venire rilevati con la sua più ampia adozione.

Questo modulo è destinato a sostituire l'attuale modulo Locale::Po4a::Pod. Il motivo è che Pod::Parser, utilizzato dall'attuale modulo Locale::Po4a::Pod, è ora deprecato e si consiglia di utilizzare Pod::Simple al suo posto. Consultare anche GitHub issue #256 "Consider migrating away from deprecated "Pod::Parser"" <https://github.com/mquinson/po4a/issues/256>.

VEDERE ANCHE¶

Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, po4a(7), Locale::Po4a::SimplePod::Parser.

AUTORI¶

  gemmaro <gemmaro.dev@gmail.com>

TRADUZIONE¶

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

COPYRIGHT E LICENZA¶

  Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.

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