NOME¶

Locale::Po4a::Man - converte pagine di manuale 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::Man è un modulo che aiuta la traduzione in altre lingue della documentazione in formato nroff (il linguaggio delle pagine di manuale).

TRADURRE CON PO4A::MAN¶

Questo modulo prova fortemente a facilitare la vita ai traduttori. Per far ciò, il testo presentato ai traduttori non è una fotocopia del testo trovato nella pagina man. Infatti, le parti più grezze del formato nroff vengono nascoste, in modo che i traduttori non possano rovinarle.

OPZIONI ACCETTATE DA QUESTO MODULO¶

Queste sono le opzioni speciali per questo modulo:

debug

Attiva il debug per alcuni meccanismi interni di questo modulo. Usare i sorgenti per vedere quali parti possono essere controllate.

verbose

Rende il programma più prolisso.

groff_code

Questa opzione controlla il comportamento del modulo quando questo incontra una sezione un .de, .ie o .if . Può prendere i seguenti valori:

generated

Questa opzione specifica che il file è un file generato, e che quindi po4a non dovrebbe cercare di rilevare se le pagine man siano state generate da un altro formato. Questa opzione è necessaria per usare po4a su pagine man generate. Si noti che tradurre pagine generate invece di quelle sorgenti è spesso più fragile (N.d.T: è più facile fare errori), e quindi una cattiva idea.

mdoc

Questa opzione è utile solo per le pagine mdoc.

Seleziona un supporto più stringente del formato mdoc indicando a po4a di non tradurre la sezione 'NAME'. Le pagine mdoc la cui sezione 'NAME' è tradotta non genereranno alcuna intestazione o piè di pagina.

Secondo la pagina groff_mdoc, le sezioni NOME, SINTASSI e DESCRIZIONE sono obbligatorie. Non sembrano esserci problemi conosciuti nel tradurre le sezioni SINTASSI o DESCRIZIONE, ma si può specificare queste sezioni anche in questo modo:
-o mdoc=NOME,SINTASSI,DESCRIZIONE

Questo problema di mdoc può essere risolto anche con un addendum come questo:
PO4A-HEADER:mode=before;position=^.Dd
.TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"

Le opzioni seguenti specificano il comportamento di una macro personalizzata (definita con una richiesta .de), o di una macro classica non supportata da po4a. Prendono come argomento un elenco separato da virgole di macro. Per esempio:

 -o noarg=FO,OB,AR -o translate_joined=BA,ZQ,UX

Nota: se una macro macro non è supportata da po4a e si ritiene che sia una macro standard roff, sarebbe desiderabile comunicarlo al team di sviluppo di po4a (N.d.T. per un'eventuale inclusione in una prossima versione di po4a).

untranslated

untranslated indica che questa macro (ed i suoi argomenti) non deve essere tradotta.

noarg

noarg è come untranslated, eccetto per il fatto che po4a verificherà che non venga aggiunto nessun argomento a questa macro.

translate_joined

translate_joined indica che po4a deve proporre di tradurre gli argomenti della macro.

translate_each

Anche con translate_each, gli argomenti verranno proposti per la traduzione, ma ognuno verrà tradotto separatamente.

no_wrap

Questa opzione prende come argomento un elenco di coppie separate da virgole begin:end, dove begin e end sono comandi che delimitano rispettivamente l'inizio e la fine di una sezione che non dovrebbe essere riformattata.

Nota: non viene effettuata nessuna prova per assicurare che il comando end corrisponda al suo comando begin; qualunque comando di fine interrompe la modalità no_wrap. Se si ha una macro begin (o rispettivamente end) che non ha un end (o rispettivamente begin), si può specificare un end esistente (come fi) o begin (come nf) come controparte. Queste macro (ed i loro argomenti) non verranno tradotte.

inline

Questa opzione specifica un elenco separato da virgole di macro che non devono spezzare il paragrafo corrente. La stringa da tradurre conterrà perciò foo <.bar baz qux> quux, dove bar è il comando che dovrebbe essere messo sulla stessa riga, e baz qux i suoi argomenti.

unknown_macros

Questa opzione indica come po4a dovrebbe comportarsi quando trova una macro sconosciuta. Per impostazione predefinita, po4a fallisce con un avvertimento. Può prendere i seguenti valori: failed (il valore predefinito), untranslated, noarg, translate_joined, o translate_each (vedere sopra per una spiegazione di questi valori).

CREAZIONE DI PAGINE COMPATIBILI MAN CON PO4A::MAN¶

Questo modulo è ancora molto limitato, e lo sarà sempre, perché non è un vero interprete nroff. Sarebbe possibile fare un vero interprete nroff, per consentire agli autori di utilizzare tutte le macro esistenti, o anche definirne di nuove nelle loro pagine, ma non abbiamo voluto. Sarebbe stato troppo difficile, e pensavamo che non fosse necessario. Pensiamo che se gli autori delle manpage vogliono vedere le loro produzioni tradotte, potrebbero doversi adattare per facilitare il lavoro dei traduttori.

Perciò, il parser man implementato in po4a ha alcune limitazioni note, che non abbiamo intenzione di correggere, e che potranno presentare dei problemi che sarà necessario evitare se si vuole che i traduttori si prendano cura della propria documentazione.

 ..               ."              .AT             .b              .bank
 .BE              ..br            .Bu             .BUGS           .BY
 .ce              .dbmmanage      .do                             .En
 .EP              .EX             .Fi             .hw             .i
 .Id              .l              .LO             .mf
 .N               .na             .NF             .nh             .nl
 .Nm              .ns             .NXR            .OPTIONS        .PB
 .pp              .PR             .PRE            .PU             .REq
 .RH              .rn             .S<             .sh             .SI
 .splitfont       .Sx             .T              .TF             .The
 .TT              .UC             .ul             .Vb             .zZ

 .if !'po4a'hide' .B other

 .IR_untranslated \-q ", " \-\-quiet

 .IR_untranslated \-q ", " \-\-quiet

STATO DI QUESTO MODULO¶

Questo modulo può essere usato per la maggior parte delle pagine man esistenti.

Alcuni test vengono effettuati con regolarità su macchine Linux:

• un terzo delle pagine vengono rifiutate perché sono state generate da un altro formato supportato da po4a (per es. POD o SGML).
• il 10% delle pagine rimanenti vengono rifiutate con un errore (perché per es. una macro groff non è supportata).
• Poi, meno dell'1% delle pagine vengono accettate da po4a silenziosamente (N.d.T. ovvero senza segnalazioni), ma con problemi significativi (cioè parole mancanti, o nuove parole inserite)
• Le altre pagine vengono solitamente gestite senza differenze più rilevanti delle differenze di spaziatura o dell'andare a capo delle righe (problemi relativi ai font in meno del 10% delle pagine elaborate).

VEDERE ANCHE¶

Locale::Po4a::Pod(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)

AUTORI¶

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

TRADUZIONE¶

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

COPYRIGHT E LICENZA¶

Copyright © 2002-2008 by SPI, inc.

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