
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

Locale::Po4a::TeX - converte documenti TeX e derivati da/a file PO

=head1 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::TeX è un modulo che aiuta la traduzione in altre lingue della
documentazione in formato TeX. Può anche essere usato come base per scrivere
moduli per documenti basati su TeX.

Gli utenti dovrebbero probabilmente usare il modulo LaTeX, che eredita dal
modulo TeX e contiene le definizioni di tipici comandi LaTeX.

=head1 TRADURRE CON PO4A::TEX

Questo modulo può essere usato direttamente per gestire generici documenti
TeX. Dividerà il documento in blocchi più piccoli (paragrafi, blocchi
verbatim o anche più piccoli come titoli o indici).

There are some options (described in the next section) that can customize
this behavior.  If this doesn't fit to your document format you're
encouraged to write your own derivative module from this, to describe your
format's details.  See the section B<WRITING DERIVATE MODULES> below, for
the process description.

Questo modulo può essere personalizzato anche da righe che comincino con "%
po4a:" nel file TeX. Queste personalizzazioni sono descritte nella sezione
B<PERSONALIZZAZIONE INLINE>.

=head1 OPZIONI ACCETTATE DA QUESTO MODULO

Queste sono le opzioni speciali per questo modulo:

=over 4

=item B<debug>

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

=item B<no_wrap>

Elenco separato da virgole di ambienti che non dovrebbero essere mandati a
capo.

Si noti che c'è una differenza tra ambienti verbatim e no_wrap. Non c'è
analisi comandi e commenti nei blocchi verbatim.

Se questo ambiente non fosse già registrato, po4a considererà che questo
ambiente non usi nessun parametro.

=item B<exclude_include>

Elenco di file separato da simboli di due punti che non dovrebbero essere
inclusi da \input e \include.

=item B<definitions>

Il nome del file contenente le definizioni per po4a, come definito nella
sezione B<PERSONALIZZAZIONE INLINE>.  Si può usare questa opzione se non è
possibile mettere le definizioni nel documento che si sta traducendo.

=item B<verbatim>

Elenco separato da virgole di ambienti che devono essere lasciati
inalterati.

Se questo ambiente non fosse già registrato, po4a considererà che questo
ambiente non usi nessun parametro.

=back

L'uso di queste opzioni permette di scavalcare il comportamento predefinito
dei comandi definiti.

=head1 PERSONALIZZAZIONE INLINE

Il modulo TeX può essere personalizzato con righe che cominciano con B<%
po4a:>.  Queste righe vengono interpretate come comandi passati al parser. I
comandi seguenti sono riconosciuti:

=over 4

=item B<% po4a: command> I<comando1> B<alias> I<comando2>

Indica che gli argomenti del comando I<comando1> devono essere trattati come
argomenti del comando I<comando2>.

=item B<% po4a: command> I<comando1> I<parametri>

Questo descrivere in dettaglio i parametri del comando I<comando1>.  Questa
informazione verrà usata per controllare il numero di argomenti ed i loro
tipi.

Si può precedere il comando I<comando1> da

=over 4

=item un asterisco (B<*>)

po4a estrarrà questo comando dai paragrafi (se è posizionato all'inizio o
alla fine del paragrafo).  I traduttori dovranno allora tradurre i parametri
marcati come traducibili.

=item un segno più (B<+>)

Come per un asterisco, il comando verrà estratto se appare ad un'estremità
di un blocco, ma i parametri non saranno tradotti separatamente.  Il
traduttore dovrà tradurre il comando concatenato a tutti i suoi parametri.
Ciò mantiene più contesto, ed è utile per comandi con piccole parole nei
parametri, che possono avere significati (e traduzioni) multipli.

Nota: in questo caso non è necessario specificare quali parametri sono
traducibili, ma po4a deve sapere il tipo e numero di parametri.

=item un segno meno (B<->)

In questo caso, il comando non sarà estratto da nessun blocco. Ma se
apparirà da solo in un blocco, allora solo i parametri marcati come
traducibili saranno presentati al traduttore.  Ciò è utile per i comandi sui
font.  Questi comandi generalmente non dovrebbero essere separati dai loro
paragrafi (per mantenere il contesto), ma non c'è ragione di infastidire il
traduttore con essi se un'intera stringa è racchiusa in un tale comando.

=back

The I<parameters> argument is a set of [] (to indicate an optional
argument) or {} (to indicate a mandatory argument).
You can place an underscore (_) between these brackets to indicate that
the parameter must be translated. For example:
 % po4a: command *chapter [_]{_}

This indicates that the chapter command has two parameters: an optional
(short title) and a mandatory one, which must both be translated.
If you want to specify that the href command has two mandatory parameters,
that you don't want to translate the URL (first parameter), and that you
don't want this command to be separated from its paragraph (which allow
the translator to move the link in the sentence), you can use:
 % po4a: command -href {}{_}

In questo caso, l'informazione indicante quali argomenti devono essere
tradotti viene usata solo se un paragrafo è composto solo da questo comando
href.

=item B<% po4a: environment> I<env> I<parametri>

This defines the parameters accepted by the I<env> environment and specifies the ones to be translated.
This information is later used to check the number of arguments of the
\begin command.
The syntax of the I<parameters> argument is the same as described for the
others commands.
The first parameter of the \begin command is the name of the environment.
This parameter must not be specified in the list of parameters. Here are
some examples:
 % po4a: environment multicols {}
 % po4a: environment equation

Come per i comandi, I<env> può essere preceduto da un più (+) per indicare
che il comando \begin deve essere tradotto con tutti i suoi argomenti.

=item B<% po4a: separator> I<ambiente> B<">I<regex>B<">

Indica che un ambiente dovrebbe essere diviso secondo la data espressione
regolare.

L'espressione regolare è delimitata da virgolette.  Non si dovrebbe creare
nessun riferimento all'indietro. Si dovrebbe usare (?:) se serve un gruppo.
Potrebbero servire anche qualche carattere di escape.

Ad esempio, il modulo LaTeX utilizza l'espressione regolare "(?:&|\\\\)" per
tradurre separatamente ogni cella di una tabella (le righe sono separate da
'\\' e le celle da '&').

La nozione di ambiente viene estesa al tipo visualizzato nel file PO. Ciò
può essere usato per dividere su "\\\\" nel primo argomento obbligatorio del
comando title. In questo caso, l'ambiente è title{#1}.

=item B<% po4a: verbatim environment> I<ambiente>

Indica che I<env> è un ambiente verbatim.  Commenti e comandi verranno
ignorati in questo ambiente.

Se questo ambiente non fosse già registrato, po4a considererà che questo
ambiente non usi nessun parametro.

=back

=head1 SCRIVERE MODULI DERIVATI

=over 4

=item B<pre_trans>

=item B<post_trans>

=item B<add_comment>

Aggiunge una stringa come commento da aggiungere accanto al prossimo
elemento tradotto. Utile principalmente per il modulo texinfo, visto che in
questo modo i commenti possono essere gestiti automaticamente in TeX.

=item B<translate>

Wrapper attorno alla traduzione del Transtractor, con filtri pre- e
post-elaborazione.

I commenti di un paragrafo vengono inseriti come commenti PO per la prima
stringa tradotta di questo paragrafo.

=item B<get_leading_command>($buffer)

Questa funzione restituisce:

=over 4

=item Un nome comando

Se non si trova il comando all'inizio del buffer dato, questa stringa sarà
vuota.  Vengono tenuti in considerazione solo comandi che possono essere
separati.  L'hash %separated_command contiene l'elenco di questi comandi.

=item Una variante

Indica se viene utilizzata una variante. Ad esempio, è possibile aggiungere
un asterisco (*) alla fine del comando delle sezioni per specificare che non
devono essere numerate. In questo caso, questo campo conterrà "*". Se non ci
sono varianti, il campo è una stringa vuota.

=item Un'array di tuple (tipo di argomento, argomento)

Il tipo di argomento può essere '{' (per argomenti obbligatori) o '[' (per
argomenti facoltativi).

=item Il buffer rimanente

Il resto del buffer dopo la rimozione di questo comando principale e dei
suoi argomenti. Se non viene trovato alcun comando, il buffer originale non
viene toccato e restituito in questo campo.

=back

=item B<get_trailing_command>($buffer)

Come B<get_leading_command>, ma per comandi alla fine di un buffer.

=item B<translate_buffer>

Tradurre ricorsivamente un buffer separando i comandi iniziali e finali
(quelli che dovrebbero essere tradotti separatamente) dal buffer.

Se viene definita una funzione in %translate_buffer_env per l'ambiente
corrente, questa funzione verrà utilizzata per tradurre il buffer invece di
translate_buffer().

=item B<read>

Fa l'overload della funzione read() di Transtractor.

=item B<read_file>

Legge ricorsivamente un file, aggiungendo i file inclusi che non siano
elencati nell'array @exclude_include. I file inclusi vengono cercati usando
il comando B<kpsewhich> dalla libreria Kpathsea.

Fatta eccezione per la parte di inclusione del file, è un taglia e incolla
della funzione read di Transtractor.

=back

=over 4

=item B<parse_definition_file>

Subroutine per l'analisi di un file con direttive po4a (definizioni per
nuovi comandi).

=item B<parse_definition_line>

Elabora una riga di definizione nella forma "% po4a: ".

Consultare la sezione B<PERSONALIZZAZIONE INLINE> per ulteriori dettagli.

=item B<is_closed>

=item B<parse>

=item B<docheader>

=back

=head1 FUNZIONI INTERNE usate per scrivere parser derivati

Comando e funzioni ambiente prendono i seguenti argomenti (oltre all'oggetto
$self):

=over

=item Un nome comando

=item Una variante

=item Un array di tuple (tipo, argomento)

=item L'ambiente corrente

=back

I primi 3 argomenti vengono estratti da get_leading_command o
get_trailing_command.

Comando e funzioni ambiente restituiscono la traduzione del comando con i
suoi argomenti e un nuovo ambiente.

Le funzioni ambiente vengono chiamate quando viene trovato un comando \begin
. Vengono chiamate con il comando \begin ed i suoi argomenti.

Il modulo TeX propone solo una funzione comando e una funzione ambiente:
generic_command e generic_environment.

generic_command uses the information specified by
register_generic_command or by adding definition to the TeX file:
 % po4a: command I<command1> I<parameters>

generic_environment uses the information specified by
register_generic_environment or by adding definition to the TeX file:
 % po4a: environment I<env> I<parameters>

Entrambe le funzioni tradurranno solo i parametri che sono stati specificati
come traducibili (con un '_'). generic_environment aggiungerà il nome
dell'ambiente allo stack dell'ambiente e generic_command aggiungerà il nome
del comando seguito da un identificatore del parametro (come {#7} o [#2]).

=head1 STATO DI QUESTO MODULO

Questo modulo necessita di più controlli.

È stato testato su un libro e con la documentazione Python.

=head1 ELENCO DEI DAFARE

=over 4

=item Rilevamento automatico di nuovi comandi

Il modulo TeX potrebbe analizzare gli argomenti del nuovo comando e provare
a indovinare il numero di argomenti, il loro tipo e se devono essere
tradotti o meno.

=item Traduzione del separatore d'ambiente

Quando \item è usato come separatore d'ambiente, l'argomento item è allegato
alla stringa seguente.

=item Alcuni comandi dovrebbero essere aggiunti alla pila dell'ambiente

Questi comandi dovrebbero essere specificati da coppie.  Ciò può essere
usato per specificare i comandi che iniziano o terminano un ambiente
letterale.

=item Altri

Vari altri punti sono marcato come TODO (DAFARE) nel sorgente.

=back

=head1 BUG CONOSCIUTI

Vari punti sono marcati come FIXME (AGGIUSTAMI) nel sorgente.

=head1 VEDERE ANCHE

L<Locale::Po4a::LaTeX(3pm)|Locale::Po4a::LaTeX>,
L<Locale::Po4a::TransTractor(3pm)|Locale::Po4a::TransTractor>,
L<po4a(7)|po4a.7>

=head1 AUTORI

 Nicolas François <nicolas.francois@centraliens.net>


=head1 TRADUZIONE

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

=head1 COPYRIGHT E LICENZA

Copyright © 2004, 2005 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.

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