
        *****************************************************
        *           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 NOMBRE

Locale::Po4a::TeX - Convierte documentos TeX y derivados desde/a ficheros PO

=head1 DESCRIPCIÓN

El objetivo del proyecto po4a («PO for anything», PO para todo) es facilitar
la traducción (y más interesante, el mantenimiento de las traducciones)
usando las herramientas de gettext en ámbitos dónde no previstos, como la
documentación.

Locale::Po4a::TeX es un módulo que asiste en la traducción de documentos TeX
a otros lenguajes (humanos). También se puede usar como base para construir
módulos para documentos basados en TeX.

Probablemente, los usuarios deberían usar el módulo LaTeX, que hereda del
módulo TeX y contiene las definiciones de las órdenes más comunes de LaTeX.

=head1 TRADUCIR CON PO4A::TEX

Este módulo se puede usar directamente para tratar documentos TeX
genéricos. Esto dividirá el documento en bloques más pequeños (párrafos,
bloques literales, o incluso más pequeños, como títulos o índices).

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.

Este módulo se puede personalizar con lineas que empiecen con «% po4a:» en
el fichero TeX. Este proceso se describe en la sección B<PERSONALIZACIÓN DE
OBJETOS EN LÍNEA>.

=head1 OPCIONES ACEPTADAS POR ESTE MODULO

Estas son las opciones particulares de este módulo:

=over 4

=item B<debug>

Activa la depuración de fallos para algunos mecanismos internos del
módulo. Use el código fuente para ver qué partes se pueden depurar.

=item B<no_wrap>

Lista separada por comas de los entornos que no se deben reajustar.

Tenga en cuenta que los entornos literales (verbatim) y no_wrap son
diferentes. En los bloques literales no se analizan las órdenes ni los
comentarios.

Si este entorno no se registró ya, po4a considerará que este entorno no
acepta ningún argumento.

=item B<exclude_include>

Lista separada por dos puntos de los ficheros que no se deben incluir
mediante «\input» e «\include».

=item B<definitions>

El nombre de un fichero que contiene definiciones para po4a, tal y como se
define en la sección B<PERSONALIZACIÓN DE OBJETOS EN LÍNEA>. Puede usar esta
opción si no es posible introducir definiciones en el documento que está
traduciendo.

=item B<verbatim>

Lista separada por comas de los entornos que se deben interpretar
literalmente.

Si este entorno no se registró ya, po4a considerará que este entorno no
acepta ningún argumento.

=back

Utilice estas opciones para modificar el comportamiento predeterminado de
las órdenes definidas.

=head1 PERSONALIZACIÓN DE OBJETOS EN LÍNEA

El módulo TeX se puede personalizar mediante lineas que empiecen con B<%
po4a:>. Estas lineas se interpretan como órdenes para el analizador. Se
reconocen las siguientes órdenes:

=over 4

=item B<% po4a: command> I<orden1> B<alias> I<orden2>

Indica que los argumentos de la orden I<orden1> se deben tratar como los
argumentos de la orden I<orden2>.

=item B<% po4a: command> I<orden1> I<parámetros>

Esto describe en detalle los parámetros de la orden I<orden1>. Esta
información se usará para revisar el número de argumentos y su tipo.

Puede preceder la orden I<orden1> con

=over 4

=item un asterisco (B<*>)

po4a extraerá esta orden de los párrafos (si está ubicada al principio o
final de un párrafo). Los traductores tendrán que traducir los argumentos
marcados como traducibles.

=item un signo de suma (B<+>)

En cuanto al asterisco, la orden se extraerá en caso de aparecer en el
extremo de un bloque, pero los argumentos no se traducirán separadamente. El
traductor tendrá que traducir la orden unida a todos sus argumentos. Esto
mantiene un contexto más completo, y es útil para aquellas órdenes con
palabras cortas en sus parámetros, los cuales pueden tener varios
significados (y traducciones).

Nota: En este caso, no necesita especificar qué argumentos son traducibles,
pero po4a debe conocer el tipo y número de argumentos.

=item un signo de resta (B<->)

En este caso, no se extraerá la orden de ningún bloque. Pero si aparece solo
en un bloque, sólo los argumentos marcados como traducibles se entregarán al
traductor. Esto es de utilidad para las órdenes de tipo de letra. Por lo
general, estas órdenes no se deberían separar de su párrafo, (para mantener
el contexto), pero no hay ninguna razón para molestar al traductor con ellas
de aparecer una cadena completa dentro de una orden dada.

=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 {}{_}

En este caso, la información que indica qué argumentos se deben traducir
sólo se emplea si un párrafo está enteramente compuesto de la orden «href».

=item B<% po4a: environment> I<entorno> I<parámetros>

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

La igual que con las órdenes, puede preceder I<entorno> de un signo de suma
(+) para indicar que la orden «\begin» se debe traducir con todos sus
argumentos.

=item B<% po4a: separator> I<entorno> B<">I<expresión_regular>B<">

Indica que un entorno se debería dividir de acuerdo a la expresión regular
dada.

La expresión regular está delimitada por comillas. No debería crear ninguna
referencia de apoyo. Debería usar (?:) si necesita un grupo. Puede precisar
también algunos escapes.

Por ejemplo, el módulo LaTeX usa la expresión regular "(?:&|\\\\)" para
traducir cada célula de la tabla por separado (las líneas separan con '\\' y
las células con '&').

La noción de entorno depende del tipo mostrado en el fichero PO. Puede usar
esto para dividirse con "\\\\" en el primer argumento obligatorio del nombre
de la orden. En este caso, el entorno es «title{#1}».

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

Indica que I<entorno> es un entorno literal. Los comentarios y órdenes se
ignorarán en este entorno.

Si este entorno no se registró ya, po4a considerará que este entorno no
acepta ningún argumento.

=back

=head1 ESCRIBIR MÓDULOS DERIVADOS

=over 4

=item B<pre_trans>

=item B<post_trans>

=item B<add_comment>

Agrega una cadena como un comentario para ser agregado alrededor del
siguiente elemento traducido.  Esto es mayormente para el módulo texinfo,
como comentarios son manipulados automáticamente en TeX.

=item B<translate>

Un «wrapper» (envoltorio) al translate del Transtractor, con filtros de pre-
y post-procesado.

Los comentarios de un párrafo se insertan como comentarios del PO en la
primera cadena traducida del párrafo.

=item B<get_leading_command>($buffer)

Esta función devuelve:

=over 4

=item El nombre de la orden

Si no se encuentra ninguna orden al principio del búfer dado, esta cadena
estará vacía. Sólo se consideran las órdenes que se pueden separar. La serie
asociativa (hash) «$separated_commands» contiene la lista separada por
espacios de estas órdenes.

=item Una variante

Indica si se utiliza una variante. Por ejemplo, se puede añadir un asterisco
(*) al final de la orden de secciones para especificar que no se deben
enumerar. En ese caso, este campo contendría "*". Si no hay ninguna
variante, el campo contiene una cadena vacía.

=item Una arreglo de tuplas (tipo de argumento, argumento)

El tipo de argumento puede ser «{» (para argumentos obligatorios) o «[»
(para argumentos opcionales).

=item El resto del búfer

El resto del búfer después de la eliminación de la orden inicial y sus
parámetros. Si no se encuentra ninguna orden, se devuelve a este campo el
búfer original intacto.

=back

=item B<get_trailing_command>($buffer)

Lo mismo que B<get_leading_command>, pero para las órdenes al final de la
memoria intermedia.

=item B<translate_buffer>

Traduce recursivamente una memoria intermedia separando de la misma la orden
inicial y la final (los que se deben traducir por separado).

Si una función se define en «%translate_buffer_env» para el entorno actual,
esta función se usará para traducir el búfer en lugar de
«translate_buffer()».

=item B<read>

Sobrecarga read() de Transtractor.

=item B<read_file>

Lee un fichero recursivamente, añadiendo los ficheros incluidos que no están
listados en la lista «@exclude_include». Los ficheros incluidos se buscan
con la orden B<kpsewhich> de la biblioteca Kpathsea.

Exceptuando la parte de inclusión de ficheros, es una copia del «read» de
Transtractor.

=back

=over 4

=item B<parse_definition_file>

Subrutina para analizar un fichero con directivas po4a (definiciones de
órdenes nuevas).

=item B<parse_definition_line>

Analiza una linea de definición con la forma «% po4a: ».

Consulte la sección B<PERSONALIZACIÓN DE OBJETOS EN LÍNEA> para más
detalles.

=item B<is_closed>

=item B<parse>

=item B<docheader>

=back

=head1 FUNCIONES INTERNAS utilizadas para escribir analizadores derivados

Las funciones de orden y entorno toman los siguientes argumentos (además del
objeto «$self»):

=over

=item El nombre de la orden

=item Una variante

=item Una serie de tuplas (tipo, argumento)

=item El entorno actual

=back

Los primeros 3 parámetros se extraen con «get_leading_command» o
«get_trailing_command».

Las funciones de orden y de entorno devuelven la traducción de la orden con
sus argumentos y un nuevo entorno.

Las funciones de entorno se invocan cuando se encuentra una orden
«\begin». Se invocan con la orden «\begin» y sus argumentos.

El módulo TeX sólo propone una orden de función y una orden de entorno:
«generic_command» y «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>

Ambas funciones sólo traducen los parámetros especificados como traducibles
(con una '_'). «generic_environment» afijará el nombre del entorno a la pila
del entorno, y «generic_command» afijará el nombre de la orden seguida por
un identificador del parámetro (como {#7} o [#2]).

=head1 ESTADO DE ESTE MODULO

Este módulo necesita más pruebas.

Se ha probado con un libro y con la documentación de Python.

=head1 LISTA DE TAREAS PENDIENTES

=over 4

=item Detección automática de órdenes nuevas

El módulo TeX podría analizar los argumentos de la orden nueva e intentar
determinar el número de argumentos, su tipo y si se deberían traducir.

=item Traducción del separador de entorno

Cuando usa «\item» como un separador de entorno, el elemento argumento se
añade a la siguiente cadena.

=item Algunas órdenes se deberían añadir a la pila («stack») del entorno

Estas órdenes se deben especificar por parejas. Esto se puede usar para
especificar órdenes que inician o finalizan un entorno literal.

=item Otros

Hay varios puntos etiquetados con TODO en el código.

=back

=head1 FALLOS CONOCIDOS

Hay varios puntos etiquetados con FIXME en el código.

=head1 VÉASE TAMBIÉN

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

=head1 AUTORES

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


=head1 TRADUCCION

 Jordi Vilalta <jvprat@gmail.com>
 Omar Campagne <ocampagne@gmail.com>

=head1 DERECHO DE COPIA Y LICENCIA

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

Este programa es software libre; puede redistribuirlo y/o modificarlo bajo
los términos de la GPL v2.0 o posterior (consulte el archivo COPYING).
