.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "PO4A-TRANSLATE.1P 1" .TH PO4A-TRANSLATE.1P 1 2024-06-26 "perl v5.38.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOME .IX Header "NOME" po4a\-translate \- converte un file PO in un documento nel formato originario .SH SINTASSI .IX Header "SINTASSI" \&\fBpo4a\-translate\fR \fB\-f\fR \fIformato\fR \fB\-m\fR \fIoriginale.doc\fR \fB\-p\fR \fIXX.po\fR \fB\-l\fR \fIXX.doc\fR .PP dove \fIXX.doc\fR è l'output e tutti gli altri sono input. .SH DESCRIZIONE .IX Header "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. .PP Il programma \fBpo4a\-translate\fR si occupa di riconvertire la traduzione (che si trova in un file PO) nel formato d'origine. Il file PO fornito deve essere la traduzione del file POT prodotto da \fBpo4a\-gettextize\fR\|(1). .SH OPZIONI .IX Header "OPZIONI" .IP "\fB\-f\fR, \fB\-\-format\fR" 4 .IX Item "-f, --format" Formato del documento in questione. L'opzione \fB\-\-help\-format\fR mostra l'elenco dei formati disponibili. .IP "\fB\-a\fR, \fB\-\-addendum\fR" 4 .IX Item "-a, --addendum" Aggiunge un file al documento risultante; utile per inserire, ad esempio, il nome del traduttore e altre informazioni sulla traduzione. La prima riga del file da inserire deve contenere l'header PO4A, che indica dove aggiungere il file; vedere anche la sezione \fBCome si aggiunge del testo extra\fR in \fBpo4a\fR\|(7). .IP "\fB\-A\fR, \fB\-\-addendum\-charset\fR" 4 .IX Item "-A, --addendum-charset" Set di caratteri degli addenda. Tutti gli addenda devono usare la stessa codifica. .IP "\fB\-m\fR, \fB\-\-master\fR" 4 .IX Item "-m, --master" File contenente il documento originale da tradurre. .IP "\fB\-M\fR, \fB\-\-master\-charset\fR" 4 .IX Item "-M, --master-charset" Set di caratteri del file contenente il documento da tradurre. .IP "\fB\-l\fR, \fB\-\-localized\fR" 4 .IX Item "-l, --localized" File su cui scrivere il documento tradotto. .IP "\fB\-L\fR, \fB\-\-localized\-charset\fR" 4 .IX Item "-L, --localized-charset" Set di caratteri del file contenente il documento tradotto. .IP "\fB\-p\fR, \fB\-\-po\fR" 4 .IX Item "-p, --po" File da cui leggere il catalogo messaggi. .IP "\fB\-o\fR, \fB\-\-option\fR" 4 .IX Item "-o, --option" Opzioni extra da passare al plugin di formato. Vedere la documentazione per ogni plugin per ulteriori informazioni sulle opzioni valide e sul loro significato. Per esempio si può passare "\-o tablecells" al parser AsciiDoc mentre il parser di testo semplice accetta "\-o tabs=split". .IP "\fB\-k\fR, \fB\-\-keep\fR" 4 .IX Item "-k, --keep" Minima percentuale di traduzione richiesta affinché il file generato sia conservato e scritto su disco. Il valore predefinito è 80, vale a dire che una traduzione viene accettata solo se è completa almeno per l'80%. .IP "\fB\-w\fR, \fB\-\-width\fR" 4 .IX Item "-w, --width" Colonna a cui mandare a capo il file risultante se il formato lo supporta (predefinita: 76). .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Mostra un breve messaggio di aiuto. .IP \fB\-\-help\-format\fR 4 .IX Item "--help-format" Elenca i formati di documento gestiti da po4a. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Mostra la versione del programma ed esce. .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Rende il programma più prolisso. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Mostra delle informazioni di debug .IP "\fB\-\-porefs\fR \fItype\fR[,\fBwrap\fR|\fBnowrap\fR]" 4 .IX Item "--porefs type[,wrap|nowrap]" Specifica il formato di riferimento. L'argomento \fItype\fR può essere un valore qualsiasi tra: \fBnever\fR per non produrre nessun riferimento, \fBfile\fR per specificare solo il file senza il numero di riga, \fBcounter\fR per rimpiazzare il numero di riga con un contatore incrementale, e \fBfull\fR per includere il riferimento completo (valore predefinito: full). .Sp L'argomento può essere seguito da una virgola e da una delle due parole chiave \fBwrap\fR o \fBnowrap\fR. I riferimenti, come impostazione predefinita, vengono scritti su una singola riga. L'opzione \fBwrap\fR manda a capo i riferimento su più righe, per emulare il comportamento degli strumenti di \fBgettext\fR (\fBxgettext\fR e \fBmsgmerge\fR). Questa opzione diventerà predefinita in una versione futura, perchè è il comportamento più logico. L'opzione \fBnowrap\fR è disponibile per permettere agli utenti che lo desiderassero, di mantenere il vecchio comportamento. .SH "Aggiungere contenuti (oltre alle traduzioni) ai file generati" .IX Header "Aggiungere contenuti (oltre alle traduzioni) ai file generati" Per inserire dei contenuti aggiuntivi nel documento generato (come il nome del traduttore e altre informazioni sulla traduzione), usare l'opzione \fB\-\-addendum\fR. .PP La prima riga dell'addendum deve contenere un header, che indica la posizione in cui va inserito (può essere prima o dopo una determinata parte del documento). Il resto del file viene copiato testualmente nel documento, senza ulteriori manipolazioni. .PP Osservare che, se po4a\-translate non riesce ad aggiungere anche uno solo dei file specificati, la traduzione viene scartata completamente: il file mancante potrebbe contenere il nome del traduttore e questo impedirebbe agli utenti di contattarlo per segnalare errori nella traduzione). .PP L'header deve seguire una sintassi piuttosto rigida. Vedere anche la pagina di manuale \fBpo4a\fR\|(7) per maggiori informazioni sull'uso degli addenda. .SH "VEDERE ANCHE" .IX Header "VEDERE ANCHE" \&\fBpo4a\-gettextize\fR\|(1), \fBpo4a\-normalize\fR\|(1), \fBpo4a\-updatepo\fR\|(1), \fBpo4a\fR\|(7) .SH AUTORI .IX Header "AUTORI" .Vb 3 \& Denis Barbier \& Nicolas François \& Martin Quinson (mquinson#debian.org) .Ve .SH TRADUZIONE .IX Header "TRADUZIONE" .Vb 2 \& Danilo Piazzalunga \& Marco Ciampa .Ve .SH "COPYRIGHT E LICENZA" .IX Header "COPYRIGHT E LICENZA" Copyright 2002\-2023 by SPI, inc. .PP Questo programma è software libero; è lecito ridistribuirlo o modificarlo secondo i termini della licenza GPL v2.0 o successive (vedere il file COPYING).