.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" 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
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "LOCALE::PO4A::DOCBOOK.3PM 1"
.TH LOCALE::PO4A::DOCBOOK.3PM 1 2025-11-22 "perl v5.42.0" "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"
Locale::Po4a::Docbook \- converte documenti DocBook XML da/verso file PO
.SH DESCRIZIONE
.IX Header "DESCRIZIONE"
L\*(Aqobiettivo 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
Locale::Po4a::Docbook è un modulo che aiuta la traduzione in altre lingue
della documentazione in formato DocBook XML.
.SH "STATO DI QUESTO MODULO"
.IX Header "STATO DI QUESTO MODULO"
Questo modulo è perfettamente funzionante, dal momento che si limita a
definire i tag e gli attributi traducibili. Tutto il lavoro viene svolto dal
modulo Locale::Po4a::Xml.
.PP
L\*(Aqunico problema conosciuto è che ancora non gestisce le entità, nemmeno le
«file inclusion entities»; è comunque possibile tradurre separatamente la
maggior parte di questi file (tranne i «typical entity files») e, di solito,
è meglio mantenerli divisi.
.SH "SUPERARE IL COMPORTAMENTO PREDEFINITO CON OPZIONI DA RIGA DI COMANDO"
.IX Header "SUPERARE IL COMPORTAMENTO PREDEFINITO CON OPZIONI DA RIGA DI COMANDO"
Il comportamento predefinito dei moduli forniti dal sistema è impostato
sulla sicurezza.
.PP
Per esempio, l\*(Aqimpostazione predefinita del marcatore \fB<author>\fR è di
apparire sotto \fB<para>\fR.  Ma si potrebbe essere nella condizione di
usarlo solo sotto \fB<bookinfo>\fR.  In questo caso, si potrebbe volerlo
tradurre indipendentemente per ogni autore.
.PP
Se non soddisfa il comportamento predefinito del modulo xml e dei suoi
moduli derivati, si può fornire opzioni sulla riga di comando per cambiare
il loro comportamento. Per esempio, si può aggiungere al file di
configurazione di po4a le seguenti opzioni:
.PP
.Vb 4
\&  opt:"\-k 0 \-o nodefault=\e"<bookinfo> <author>\e" \e
\&            \-o break=\e"<bookinfo> <author>\e" \e
\&            \-o untranslated=\e"<bookinfo>\e" \e
\&            \-o translated=\e"<author>\e""
.Ve
.PP
Questo supera il comportamento predefinito per \fB<bookinfo>\fR e \fB<author>\fR, imposta \fB<bookinfo>\fR e \fB<author>\fR per interrompere il
flusso dati in ingresso su questi marcatori, imposta \fB<bookinfo>\fR a non
tradurre il suo contenuto, e imposta \fB<author>\fR invece per tradurre il
suo contenuto.
.SH "VEDERE ANCHE"
.IX Header "VEDERE ANCHE"
\&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBLocale::Po4a::Xml\fR\|(3pm),
\&\fBpo4a\fR\|(7)
.SH AUTORI
.IX Header "AUTORI"
.Vb 1
\& Jordi Vilalta <jvprat@gmail.com>
.Ve
.SH TRADUZIONE
.IX Header "TRADUZIONE"
.Vb 2
\& Danilo Piazzalunga <danilopiazza@libero.it>
\& Marco Ciampa <ciampix@posteo.net>
.Ve
.SH "COPYRIGHT E LICENZA"
.IX Header "COPYRIGHT E LICENZA"
.Vb 2
\& Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>
\& Copyright © 2007\-2009 Nicolas François <nicolas.francois@centraliens.net>
.Ve
.PP
Questo programma è software libero; è lecito ridistribuirlo o modificarlo
secondo i termini della licenza GPL v2.0 o successive (vedere il file
COPYING).