po4a pod 0.43 - en to es translation catalogue (902 entries)

note: type: Attribute 'xml:lang' of: <refentry>
en: en
es: es

note: type: Content of: <refentry><refentryinfo>
en: <date>2006-04-08</date>
es: <date>08/04/2006</date>

note: type: Content of: <refentry><refmeta><refmiscinfo>
en: 2020-04-19
es: 19/04/2020

note: type: Content of: <refentry><refmeta><refmiscinfo>
en: Po4a Tools
es: Herramientas de po4a

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display a translated man page according to a PO
es: Muestra una página de manual traducida de acuerdo a un fichero PO

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>po4a-display-man</command> <arg choice='plain'><option>-p</option> </arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg choice='plain'><replaceable>MASTER_FILE</replaceable></arg></arg> <arg choice='opt'><arg choice='plain'><option>-o</option> </arg><arg choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>
es: <command>po4a-display-man</command> <arg choice='plain'><option>-p</option> </arg> <arg choice='plain'><replaceable>FICHERO_PO</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg choice='plain'><replaceable>FICHERO_PRINCIPAL</replaceable></arg></arg> <arg choice='opt'><arg choice='plain'><option>-o</option> </arg><arg choice='plain'><replaceable>OPC_PO4A</replaceable></arg></arg>

note: type: =head1
en: DESCRIPTION
es: DESCRIPCIÓN

note: type: Content of: <refentry><refsect1><para>
en: Translators can use <command>po4a-display-man</command> to see how their translation of a man page will be rendered to the end users, without recompiling and reinstalling the whole project.
es: Los traductores pueden utilizar <command>po4a-display-man</command> para observar cómo se mostrará la página man traducida al usuario, sin necesidad de recompilar y reinstalar el proyecto completo.

note: type: Content of: <refentry><refsect1><para>
en: This script only works with man pages written directly in <emphasis remap='I'>nroff</emphasis> and handled by the po4a's <emphasis remap='I'>man</emphasis> module.  Manual pages generated from other formats, like DocBook or POD, are not supported.  See <citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> for an equivalent supporting <emphasis remap='I'>POD</emphasis> documents.
es: Este script solo opera con páginas man escritas directamente en <emphasis remap='I'>nroff</emphasis> y manejadas por el módulo <emphasis remap='I'>man</emphasis> de po4a. No son compatibles aquellas páginas de manual en otro formato, como DocBook o POD. Consulte <citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> para una orden similar compatible con documentos <emphasis remap='I'>POD</emphasis>.

note: type: =head1
en: OPTIONS
es: OPCIONES

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-p </option><replaceable>PO_FILE</replaceable>
es: <option>-p </option><replaceable>fichero_PO</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The PO file containing the translations.
es: El fichero PO que contiene las traducciones.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>MASTER_FILE</replaceable>
es: <option>-m </option><replaceable>fichero_original</replaceable>

note: .br type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The original man page.  It can be the absolute or relative path to the original man page (gzipped or not), the name of the man page or the name and section of the man page (using the man.section format).  When the master document is not provided with the <option>-m</option> option, <command>po4a-display-man</command> tries to find the original man page based on the line reference of the first string in the PO.
es: La página de manual original. Puede usar la ruta absoluta o relativa a la página de manual original (en un fichero «.gz» o no comprimido ), el nombre de la página de manual o el nombre y la sección de la página de manual (usando el formato «man.section»). Si no se introduce la página de manual con la opción <option>-m</option>, <command>po4a-display-man</command> intentará encontrar la página de manual original a través de la línea de referencia presente en la primera cadena del fichero PO.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-o </option><replaceable>PO4A_OPT</replaceable>
es: <option>-o </option><replaceable>opciones_de_po4a</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Some options to pass to <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
es: Algunas opciones a introducir a <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

note: type: =head1
en: SEE ALSO
es: VÉASE TAMBIÉN

note: type: Content of: <refentry><refsect1><title>
en: AUTHOR
es: AUTOR

note: type: Content of: <refentry><refentryinfo>
en: <date>2009-03-16</date>
es: <date>16/03/2009</date>

note: type: Content of: <refentry><refmeta><refmiscinfo>
en: 2009-03-16
es: 16/03/2009

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display of a translated POD file according to a PO
es: muestra un fichero POD traducido de acuerdo a un PO

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>po4a-display-pod</command> <arg choice='plain'><option>-p </option></arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> <arg choice='plain'><option>-m </option></arg> <arg choice='plain'><replaceable>POD_FILE</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-o </option></arg><arg choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>
es: <command>po4a-display-pod</command> <arg choice='plain'><option>-p </option></arg> <arg choice='plain'><replaceable>fichero_PO</replaceable></arg> <arg choice='plain'><option>-m </option></arg> <arg choice='plain'><replaceable>fichero_POD</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-o </option></arg><arg choice='plain'><replaceable>opciones_de_po4a</replaceable></arg></arg>

note: type: Content of: <refentry><refsect1><para>
en: Translators can use <command>po4a-display-pod</command> to see how their translation of a man page will be rendered to the end users, without recompiling and reinstalling the whole project.  Most of the time, the POD file is only available in source package or embedded in Perl script.
es: Los traducores pueden usar <command>po4a-display-pod</command> para revisar como el usuario final verá la página del manual, sin necesidad de recompilar y reinstalar el proyecto entero. Habitualmente, el fichero POD sólo está disponible en el paquete de fuentes o integrado en un script de Perl.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>POD_FILE</replaceable>
es: <option>-m </option><replaceable>fichero_POD</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The original POD file used by po4a to generate PO file.
es: El fichero POD original que po4a usará para generar el fichero PO.

note: type: Content of: <refentry><refsect1><para>
en: <citerefentry> <refentrytitle>po4a-display-man</refentrytitle><manvolnum>1</manvolnum> </citerefentry>
es: <citerefentry> <refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum> </citerefentry>

note: type: =head1
en: NAME
es: NOMBRE

note: type: textblock
en: po4a - update both the PO files and translated documents in one shot
es: po4a - Actualiza los ficheros PO y los documentos traducidos a la vez

note: type: =head1
en: SYNOPSIS
es: SINOPSIS

note: type: textblock
en: B<po4a> [I<options>] I<config_file>
es: B<po4a> [I<opciones>] I<fichero_de_configuración>

note: type: textblock
en: po4a (PO for anything) eases the maintenance of documentation translation using the classical gettext tools. The main feature of po4a is that it decouples the translation of content from its document structure.  Please refer to the page L<po4a(7)> for a gentle introduction to this project.
es: po4a (PO para cualquier cosa) facilita el mantenimiento de la traducción de documentación utilizando las herramientas clásicas de gettext. La característica principal de po4a es que desacopla la traducción del contenido de la estructura del documento. Consulte la página L<po4a (7)> para obtener una breve introducción a este proyecto.

note: type: textblock
en: Minimal threshold for translation percentage to keep (i.e. write) the resulting file (default: 80). I.e. by default, files have to be translated at least at 80% to be written on disk.
es: El umbral mínimo del porcentaje de traducción para preservar (es decir, escribir) el fichero resultante (predefinido: 80). Es decir, por omisión los ficheros deben estar traducidos como mínimo en un 80% para que se escriba el fichero resultante en disco.

note: type: textblock
en: Show a short help message.
es: Muestra un mensaje corto de ayuda.

note: type: textblock
en: Charset of the files containing the documents to translate. Note that all master documents must use the same charset.
es: El juego de caracteres de los ficheros que contienen los documentos a traducir. Tenga en cuento que todos los documentos maestros deben usar el mismo juego de caracteres.

note: type: textblock
en: Charset of the files containing the localized documents. Note that all translated documents will use the same charset.
es: El juego de caracteres de los ficheros que contienen los documentos localizados. Tenga en cuentao que todos los documentos traducidos deben usar el mismo juego de caracteres.

note: type: textblock
en: Charset of the addenda. Note that all the addenda should be in the same charset.
es: El juego de caracteres del apéndice. Todos los apéndices deben usar el mismo juego de caracteres.

note: type: textblock
en: Display the version of the script and exit.
es: Muestra la versión del script y cierra.

note: type: textblock
en: Increase the verbosity of the program.
es: Aumenta la cantidad de mensajes informativos del programa.

note: type: textblock
en: Decrease the verbosity of the program.
es: Disminuye la cantidad de mensajes informativos del programa.

note: type: textblock
en: Output some debugging information.
es: Devuelve por la salida información de depuración de fallos.

note: type: textblock
en: Extra option(s) to pass to the format plugin. See the documentation of each plugin for more information about the valid options and their meanings. For example, you could pass '-o tablecells' to the AsciiDoc parser, while the text parser would accept '-o tabs=split'.
es: Opción(es) adicionales a introducir a la extensión del formato. Consulte la documentación de cada extensión para más información acerca de las opciones aceptadas y su significado. Por ejemplo, puede pasar '-o tablecells' al intérprete AsciiDoc, mientras que el intérprete de texto aceptaría '-o tabs=split'.

note: type: textblock
en: Always generate the POT and PO files, even if B<po4a> considers it is not necessary.
es: Siempre genera los ficheros POT y PO, incluso si B<po4a> no lo considera necesario.

note: type: textblock
en: The default behavior (when B<--force> is not specified) is the following:
es: El comportamiento predefinido (cuando no se especifica B<--force>) es el siguiente:

note: type: textblock
en: If the POT file already exists, it is regenerated if a master document or the configuration file is more recent (unless B<--no-update> is provided).  The POT file is also written in a temporary document and B<po4a> verifies that the changes are really needed.
es: Si ya existe el fichero POT, se generará otra vez si el documento original o el fichero de configuración es más reciente (a menos que se de B<--no-update>). El fichero POT se escribe también en un documento temporal y B<po4a> comprueba si los cambios son realmente necesarios.

note: type: textblock
en: Also, a translation is regenerated only if its master document, the PO file, one of its addenda or the configuration file is more recent.  To avoid trying to regenerate translations which do not pass the threshold test (see B<--keep>), a file with the F<.po4a-stamp> extension can be created (see B<--stamp>).
es: Así mismo, una traducción se genera otra vez sólo si el documento original, el fichero PO, uno de sus apéndices o el fichero de configuración son más recientes. Para evitar generar otra vez las traducciones que no pasan el análisis  del umbral (consulte B<--keep>), puede crear un fichero con la extensión F<.po4a-stamp> (consulte <B--stamp>).

note: type: textblock
en: If a master document includes files, you should use the B<--force> flag because the modification time of these included files are not taken into account.
es: Debería usar la marca B<--force> si el documento original incluye ficheros, ya que no se toma en cuenta la fecha de modificación de estos ficheros incluidos.

note: type: textblock
en: The PO files are always re-generated based on the POT with B<msgmerge -U>.
es: Los ficheros PO siempre se regeneran en base al POT con B<msgmerge -U>.

note: type: textblock
en: Tells B<po4a> to create stamp files when a translation is not generated because it does not reach the threshold. These stamp files are named according to the expected translated document, with the F<.po4a-stamp> extension.
es: Activa la creación de ficheros de marcas («stamp files») cuando no se ha generado una traducción al no alcanzar éste el umbral. Estos ficheros de marcas se nombran de acuerdo al documento traducido esperado, con la extensión F<.po4a-stamp>.

note: type: textblock
en: Note: This only activates the creation of the F<.po4a-stamp> files. The stamp files are always used if they exist, and they are removed with B<--rm-translations> or when the file is finally translated.
es: Nota: Esto sólo activa la creación de ficheros F<.po4a-stamp>. En caso de existir siempre se usarán estos ficheros, y se eliminan con B<--rm-translations> o cuando el fichero está completamente traducido.

note: type: textblock
en: Do not generate the translated documents, only update the POT and PO files.
es: No genera los documentos traducidos, sólo actualiza los ficheros POT y PO.

note: type: textblock
en: Do not change the POT and PO files, only the translation may be updated.
es: Impide modificar los ficheros POT y PO, solo se actualiza la traducción.

note: type: textblock
en: Keeps the existing translation files even if the translation doesn't meet the threshold specified by B<--keep>.  This option does not create new translation files with few content, but it will save existing translations which decay because of changes to the master files.
es: Preserva los ficheros traducidos existentes incluso si la traducción no satisface el umbral especificado por B<--keep>. Esta opción no crea ficheros traducidos nuevos con escaso contenido, pero guarda las traducciones existentes incompletas debido a cambios en los ficheros originales.

note: type: textblock
en: WARNING: This flag changes the po4a behavior in a rather drastic way: your translated files will not get updated at all until the translation improves. Only use this flag if you prefer shipping an outdated translated documentation rather than only shipping an accurate untranslated documentation.
es: ADVERTENCIA: Esta opción modifica el comportamiento de po4a de forma muy notable: los ficheros traducidos no se actualizan en absoluto hasta mejorar la traducción. Utilice esta opción solo en caso de preferir la distribución de documentación traducida anticuada en lugar de distribuir una documentación no traducida precisa.

note: type: textblock
en: Remove the translated files (implies B<--no-translations>).
es: Elimina los ficheros traducidos (implica B<--no-translations>).

note: type: textblock
en: This flag does nothing since 0.41, and may be removed in later releases.
es: A partir de la versión 0.41, esta opción no tiene ningún efecto. Puede que se elimine en alguna futura publicación.

note: type: =item
en: B<--translate-only> I<translated-file>
es: B<--translate-only> I<fichero-traducido>

note: type: textblock
en: Translate only the specified file.  It may be useful to speed up processing if a configuration file contains a lot of files.  Note that this option does not update PO and POT files.  This option can be used multiple times.
es: Traduce sólo el fichero especificado. Puede ser útil para agilizar el proceso si el fichero de configuración contiene muchos ficheros. Tenga en cuenta que esta opción no actualiza los ficheros PO y POT. Puede usar esta opción varias veces.

note: type: =item
en: B<--variable> I<var>B<=>I<value>
es: B<--variable> I<var>B<=>I<valor>

note: type: textblock
en: Define a variable that will be expanded in the B<po4a> configuration file.  Every occurrence of I<$(var)> will be replaced by I<value>.  This option can be used multiple times.
es: Define una variable que se expandirá en el fichero de configuración de B<po4a>. Cada aparición de I<$(var)> se reemplazará por I<valor>. Puede introducir está opción varias veces.

note: type: textblock
en: Set the base directory for all input documents specified in the B<po4a> configuration file.
es: Define el directorio base de todos los documentos de entrada especificados en el fichero de configuración de B<po4a>.

note: type: textblock
en: If both I<destdir> and I<srcdir> are specified, input files are searched in the following directories, in order: I<destdir>, the current directory and I<srcdir>. Output files are written to I<destdir> if specified, or to the current directory.
es: Si se especifican tanto I<destdir> como I<srcdir>, los archivos de entrada se buscan en los siguientes directorios, en orden: I<destdir>, el directorio actual y I<srcdir>. Los archivos de salida se escriben en I<destdir> si se especifica, o en el directorio actual.

note: type: textblock
en: Set the base directory for all the output documents specified in the B<po4a> configuration file (see B<--srcdir> above).
es: Define el directorio base de todos los documentos de salida especificados en el fichero de configuración de B<po4a> (ver B<--srcdir>).

note: type: =head2
en: Options modifying the POT header
es: Opciones que modifican el encabezado POT

note: type: textblock
en: Specify the reference format. Argument I<type> can be one of B<never> to not produce any reference, B<file> to only specify the file without the line number, B<counter> to replace line number by an increasing counter, and B<full> to include complete references (default: full).
es: Define el forma de referencia: El argumento I<type> puede ser B<never> para no generar ninguna referencia, B<file> para solo especificar el fichero el número de línea, B<counter> para sustituir el número de línea con un recuento ascendente, y B<full> para incluir referencias completas (predefinido: full).

note: type: =item
en: B<--wrap-po> B<no>|B<newlines>|I<number> (default: 76)
es: B<--wrap-po> B<no>|B<newlines>|I<number> (por omisión: 76)

note: type: textblock
en: Specify how the po file should be wrapped. This gives the choice between either files that are nicely wrapped but could lead to git conflicts, or files that are easier to handle automatically, but harder to read for humans.
es: Especifique cómo se debe ajustar el archivo po. Esto permite elegir entre archivos que están bien ajustados pero que podrían generar conflictos de git o archivos que son más fáciles de manejar automáticamente, pero más difíciles de leer para los humanos.

note: type: textblock
en: Historically, the gettext suite has reformatted the po files at the 77th column for cosmetics. This option specifies the behavior of po4a. If set to a numerical value, po4a will wrap the po file after this column and after newlines in the content. If set to B<newlines>, po4a will only split the msgid and msgstr after newlines in the content. If set to B<no>, po4a will not wrap the po file at all.  The reference comments are always wrapped by the gettext tools that we use internally.
es: Históricamente, la suite gettext ha reformateado los archivos po en la columna 77 por razones cosméticas. Esta opción especifica el comportamiento de po4a. Si se establece en un valor numérico, po4a ajustará el archivo po después de esta columna y después de nuevas líneas en el contenido. Si se establece en B<newlines>, po4a solo dividirá los msgid y msgstr después de nuevas líneas en el contenido. Si se establece en B<no>, po4a no ajustará el archivo po en absoluto. Los comentarios de referencia siempre son ajustados por las herramientas gettext que usamos internamente.

note: type: textblock
en: Note that this option has no impact on how the msgid and msgstr are wrapped, i.e.  on how newlines are added to the content of these strings.
es: Tenga en cuenta que esta opción no tiene ningún impacto en cómo se ajustan msgid y msgstr, es decir, en cómo se agregan nuevas líneas al contenido de estas cadenas.

note: type: textblock
en: Language of the source files containing the documents to translate. Note that all master documents must use the same language.
es: El idioma de los ficheros que contienen el documento a traducir. Todos los documentos maestros deben utilizar el mismo idioma.

note: type: =item
en: B<--msgid-bugs-address> I<email@address>
es: B<--msgid-bugs-address> I<correo-e@direccion>

note: type: textblock
en: Set the report address for msgid bugs. By default, the created POT files have no Report-Msgid-Bugs-To fields.
es: Define el destinatario de los informes de fallo en los msgid. Por omisión, los ficheros POT creados no tienen el campo «Report-Msgid-Bugs-To».

note: type: =item
en: B<--copyright-holder> I<string>
es: B<--copyright-holder> I<cadena>

note: type: textblock
en: Set the copyright holder in the POT header. The default value is "Free Software Foundation, Inc."
es: Define el titula de los derechos de reproducción en la cabecera del POT. El valor predefinido es «Free Software Foundation, Inc.»

note: type: textblock
en: Set the package name for the POT header. The default is "PACKAGE".
es: Define el nombre del paquete en la cabecera del POT. El valor por omisión es «PACKAGE».

note: type: textblock
en: Set the package version for the POT header. The default is "VERSION".
es: Define la versión del paquete en la cabecera del POT. El valor por omisión es «VERSION».

note: type: =head2
en: Options to modify the PO files
es: Opciones para modificar los archivos PO

note: type: =item
en: B<--msgmerge-opt> I<options>
es: B<--msgmerge-opt> I<opciones>

note: type: textblock
en: Extra options for B<msgmerge>(1).
es: Opciones adicionales para B<msgmerge>(1).

note: type: textblock
en: Note: B<$lang> will be extended to the current language.
es: Nota: B<$lang> se expandirá al idioma actual.

note: type: textblock
en: This option removes B<--previous> from the options passed to B<msgmerge>.  This is necessary to support versions of B<gettext> earlier than 0.16.
es: Esta opción retira B<--previous> desde las opciones aprobadas a B<msgmerge>.  Esto es necesarios para admitir versiones de B<gettext> anteriores a 0.16.

note: type: textblock
en: This option adds B<--previous> to the options passed to B<msgmerge>.  It requires B<gettext> 0.16 or later, and is activated by default.
es: Esta opción añade B<--previous> a las opciones introducidas a B<msgmerge>. Requiere B<gettext> 0.16 o posterior, y está activada por omisión.

note: type: =head1
en: CONFIGURATION FILE
es: ARCHIVO DE CONFIGURACIÓN

note: type: textblock
en: po4a expects a configuration file as argument. This file must contain the following elements:
es: po4a espera un archivo de configuraicón como argumento. Este archivo de contener los siguientes elementos:

note: type: textblock
en: The path to the PO files and the list of languages existing in the project;
es: La ruta a los archivos PO y la lista de idiomas en el proyecto;

note: type: textblock
en: Optionally, some global options and so-called configuration aliases that are used as templates to configure individual master files;
es: Opcionalmente, algunas opciones globales y los denominados alias de configuración que se utilizan como plantillas para configurar archivos maestros individuales;

note: type: textblock
en: The list of each master file to translate, along with specific parameters.
es: La lista con cada archivo maestro a traducir, junto con parámetros específicos.

note: type: textblock
en: All lines contain a command between square braces, followed by its parameters.  Comments begin with the char '#' and run until the end of the line. You can escape the end of line to spread a command over several lines.
es: Todas las líneas contienen una orden entre paréntesis cuadrados, seguido de sus parámetros. Los comentarios comienzan con el carácter '#' y van hasta el final de la línea. Puede escapar el final de la línea para extender una orden en varias líneas.

note: type: textblock
en: Some full examples are presented on this page, while other examples can be found in the C<t/cfg> directory of the source distribution.
es: En esta página se presentan algunos ejemplos completos, mientras que otros ejemplos se pueden encontrar en el directorio C<t/cfg> de la distribución fuente.

note: type: =head2
en: Finding the PO and POT files
es: Encontrar los archivos PO y POT

note: type: textblock
en: The simplest solution is to explicitly give the path to POT and PO files, as follows:
es: La solución más simple es proporcionar explicitamente la ruta a los archivos POT y PO, así:

note: type: textblock
en: This specifies the path to the POT file first, and then the paths to the German and French PO files.
es: Este especifíca la ruta al archivo POT primero, y después las rutas a los archivos PO en alemán y frncés.

note: type: textblock
en: The same information can be written as follows to reduce the risk of copy/paste errors:
es: La misma información puede escribirse como sigue para reducir el riesgo de errores de copiar/pegar:

note: type: textblock
en: The C<$lang> component is automatically expanded using the provided languages list, reducing the risk of copy/paste error when a new language is added.
es: El componente C<$lang> se expande automaticamente al usar la lista de idiomas proveida, reduciendo así el riesgo de errores de copiar/pegar cuando se añade un nuevo idioma.

note: type: textblock
en: You can further compact the same information by only providing the path to the directory containing your translation project, as follows.
es: Puede compactar más la misma información al proporcionalr solamente la ruta al directorio que contiene su proyecto de traducción, como se describe a continuación.

note: type: textblock
en: The provided directory must contain a set of PO files, each named F<XX.po> with C<XX> the ISO 639-1 of the language used in this file. The directory must also contain a single POT file, with the C<.pot> file extension. For the first run, this file can be empty but it must exist (po4a cannot guess the name to use before the extension).
es: El directorio proporcionado debe contener un juego de archivo PO, cada uno con un nombre de la forma F<XX.po> siendo C<XX> el código ISO 639-1 del idioma usado en ese archivo. El directorio también debe contener un sólo archivo POT, con la extensión C<.pot>. En la primera ejecución, este archivo debe estar vacío pero debe existir (por4a no puee adivinar el nombre por usar antes de la extensión).

note: type: textblock
en: Note that you must choose only one between C<po_directory> and C<po4a_paths>. The first one (C<po_directory>) is more compact, further reduces the risk of copy/paste error, but forces you to use the expected project structure and file names. The second one (C<po4a_paths>), is more explicit, probably more readable, and advised when you setup your first project with po4a.
es: Note que usted debe elegir sólo uno entre C<directorio_po> y C<rutas_po4a>. El primero (C<directorio_po>) es más compacto, reduciendo más el riesgo de errores de copiar7pegar, pero forzandolo a usar la estructura y nombres de archivos esperados del prooyecto. La segunda (C<rutas_po4a>), es más explicita, probablemente más legible y se recomienda cuando esté montando su primer proyecto con po4a.

note: type: =head3
en: Centralized or split PO files?
es: ¿Archivos PO centralizados o divididos?

note: type: textblock
en: By default, po4a produces one single PO file per target language, containing the whole content of your translation project. As your project grows, the size of these files may become problematic. When using weblate, it is possible to specify priorities for each translation segment (i.e., msgid) so that the important ones get translated first. Still, some translation teams prefer to split the content in several files.
es: De manera predeterminada, po4a produce un sólo archivo PO por idioma objetivo, que contiene el contenido completo de su proyecto de traducción. A medida que su proyecto crezca, el tamaño de estos archivos puede volverse problemático. Al usar weblate, es posible especificar prioridades para cada segmento de traducción (i.e, msgid) de forma que los importante son traducidos primero. Aún así, algunos equipos de traducción prefieren dividir el contenido en varios archivos.

note: type: textblock
en: To have one PO file per master file, you simply have to use the string C<$master> in the name of your PO files on the C<[po4a_paths]> line, as follows.
es: Para tener un archivo PO por cada archivo maestro, usted sólo tiene que usar la cadena C<$master> en el nombre de sus archivos PO y la línea C<[rutas_po4a]>, como sigue.

note: type: textblock
en: In split mode, B<po4a> builds a temporary compendium during the PO update, to share the translations between all the PO files. If two PO files have different translations for the same string, B<po4a> will mark this string as fuzzy and will submit both translations in all the PO files containing this string. When unfuzzied by the translator, the translation is automatically used in every PO files.
es: En modo despliegue, B<po4a> compila un compendio temporal durante la actualización de PO, para compartir las traducciones entre todos los ficheros PO. Si dos PO tienen diferentes traducciones de la misma cadena, B<po4a> marcará esta cadena como difusa («fuzzy») y mandará ambas traducciones a todos los ficheros PO que contengan está cadena. Cuando no quede difuso por el traductor, la traducción es utilizada automáticamente en cada fichero PO.

note: type: =head2
en: Specifying the documents to translate
es: Especificar los documentos a traducir

note: type: textblock
en: You must also list the documents that should be translated. For each master file, you must specify the format parser to use, the location of the translated document to produce, and optionally some configuration. Here is an example:
es: Además debe alistar los documentos que serían traducidos. Por cada fichero maestro, debe especificar el formato del intérprete a utilizar, la ubicación de documento traducido para producir, y opcionalmente alguna configuración. Aquí hay un ejemplo:

note: type: verbatim
en:  [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \
                  de:doc/de/mein_kram.sgml
     [type: man] script fr:doc/fr/script.1 de:doc/de/script.1
     [type: docbook] doc/script.xml fr:doc/fr/script.xml \
                 de:doc/de/script.xml
es:  [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \
                  de:doc/de/mein_kram.sgml
    [type: man] script fr:doc/fr/script.1 de:doc/de/script.1
     [type: docbook] doc/script.xml fr:doc/fr/script.xml \
                 de:doc/de/script.xml

note: type: textblock
en: But again, these complex lines are difficult to read and modify, e.g. when adding a new language. It is much simpler to reorganize things using the C<$lang> template as follows:
es: Pero de nuevo, estas líneas complejas son difíciles para leer y modificar, p. ej. cuando agregue un idioma nuevo. Es mucho más fácil reorganizar cosas empleando la plantilla C<$lang> como sigue:

note: type: verbatim
en:  [type: sgml]    doc/my_stuff.sgml $lang:doc/$lang/my_stuff.sgml
     [type: man]     script.1          $lang:po/$lang/script.1
     [type: docbook] doc/script.xml    $lang:doc/$lang/script.xml
es:  [type: sgml]    doc/mi_material.sgml $lang:doc/$lang/mi_material.sgml
     [type: man]     script.1          $lang:po/$lang/script.1
     [type: docbook] doc/script.xml    $lang:doc/$lang/script.xml

note: type: =head2
en: Specifying options
es: Especificar opciones

note: type: textblock
en: There is two types of options: I<po4a options> are default values to the po4a command line options while I<format options> are used to change the behavior of the format parsers. As a I<po4a options>, you could for example specify in your configuration file that the default value of the B<--keep> command line parameter is 50% instead of 80%. I<Format options> are documented on the specific page of each parsing module, e.g. L<Locale::Po4a::Xml(3pm)>. You could for example pass B<nostrip> to the XML parser to not strip the spaces around the extracted strings.
es: Hay dos tipos de opciones: I<opciones po4a> son valores predeterminados para las opciones de línea de orden po4a mientras que I<opciones de formato> son utilizadas para cambiar el comportamiento de los intérpretes del formato. Como una I<opciones de po4a>, pudo por ejemplo especificar en su fichero de configuración que el valor predeterminado del parámetro de línea de orden B<--keep> es un 50% en vez de un 80%. Las I<opciones de formato> están documentadas en una página específica de cada módulo de intérprete, p.ej. L<Locale::Po4a::Xml(3pm)>. Pudo por ejemplo aprobar B<nostrip> al intérprete XML para no recortar los espacios alrededor de las cadenas extraídas.

note: type: textblock
en: You can pass these options for a specific master file, or even for a specific translation of that file, using C<opt:> and C<opt_XX:> for the C<XX> language.  In the following example, the B<nostrip> option is passed to the XML parser (for all languages), while the threshold will be reduced to 0% for the French translation (that is thus always kept).
es: Puede pasar estas opciones para un fichero maestro específico, o incluso para una traducción específica de ese fichero, utilizando C<opt:> y C<opt_XX:> para el idioma C<XX>.  En el ejemplo siguiente, la opción B<nostrip> es pasada al intérprete XML (para todos los idiomas), mientras que el umbral será reducido a 0% para la traducción francesa (que es por lo tanto siempre conservada).

note: type: verbatim
en:  [type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_fr:"--keep 0"
es:  [type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_es:"--keep 0"

note: type: textblock
en: In any case, these configuration chunks must be located at the end of the line.  The declaration of files must come first, then the addendum if any (see below), and then only the options. The grouping of configuration chunks is not very important, since elements are internally concatenated as strings. The following examples are all equivalent:
es: En cualquier caso, estos segmentos de configuración deben estar ubicados al final de la línea.  La declaración de ficheros deben primero venir, después el adjunto si hay alguno (vea debajo), y después solamente las opciones. El agrupamiento de configuración de segmentos no es muy importante, debido a que los elementos están concatenados internamente como cadenas. Los siguientes ejemplos son todos equivalentes:

note: type: verbatim
en:   [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_fr:"--keep 0"
      [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_fr:"--keep 0"
      [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0
es:   [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_es:"--keep 0"
      [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_es:"--keep 0"
      [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_es:--keep opt_es:0

note: type: textblock
en: Note that language specific options are not used when building the POT file. It is for example impossible to pass B<nostrip> to the parser only when building the French translation, because the same POT file is used to update every languages. So the only options that can be language-specific are the ones that are used when producing the translation, as the C<--keep> option.
es: Anote que las opciones específicas del idioma no son utilizadas cuando crea el fichero POT. Es por ejemplo imposible aprobar B<nostrip> al intérprete solamente cuando construya la traducción francesa, porque el mismo fichero POT es utilizado para actualizar cada idioma. Por tanto las opciones solamente que pueda ser específicas del idioma son las que son utilizadas cuando produce la traducción, como la opción C<--keep>.

note: type: =head3
en: Configuration aliases
es: Configuración de aliases

note: type: textblock
en: To pass the same options to several files, the best is to define a type alias as follows. In the next example, C<--keep 0> is passed to every Italian translation using this C<test> type, that is an extension of the C<man> type.
es: Para aprobar las mismas opciones a varios ficheros, lo mejor es definir un tipo alias como sigue. En el ejemplo siguiente, C<--keep 0> es pasado a cada traducción italiana utilizando este tipo C<test>, que es una extensión del tipo C<man>.

note: type: textblock
en: You can also extend an existing type reusing the same name for the alias as follows. This is not interpreted as as an erroneous recursive definition.
es: También puede extender un tipo existente reutilizando el mismo nombre para el alias tal como sigue. Esto no es interpretado como una definición recursiva errónea.

note: type: =head3
en: Global default options
es: Opciones predeterminadas globales

note: type: textblock
en: You can also use C<[options]> lines to define options that must be used for all files, regardless of their type.
es: Además puede utilizar líneas de C<[opciones]> para definir opciones que deben ser empleadas para todos los ficheros, independientemente de su tipo.

note: type: verbatim
en:   [options] --keep 20 --option nostrip
es:   [opciones] --keep 20 --option sin-tira

note: type: textblock
en: As with the command line options, you can abbreviate the parameters passed in the configuration file:
es: Como con las opciones de línea de orden, puede abreviar los parámetros pasados dentro del fichero de configuración:

note: type: verbatim
en:   [options] -k 20 -o nostrip
es:   [opciones] -k 20 -o nostrip

note: type: =head3
en: Option priorities
es: Opciones prioritarias

note: type: textblock
en: The options of every sources are concatenated, ensuring that the default values can easily be overridden by more specific options. The order is as follows:
es: Las opciones de cada fuente están concatenadas, asegurando que los valores predeterminados puedan ser fácilmente anulados por opciones más específicas. El pedido es como sigue:

note: type: textblock
en: C<[options]> lines provide default values that can be overridden by any other source.
es: Las C<[opciones]> de líneas proporciona valores predeterminados que pueden ser anuladas por cualquier otro origen.

note: type: textblock
en: Type aliases are then used. Language specific settings override the ones applicable to all languages.
es: Tipo de aliases estarán cuando necesite. Parámetros específicos del idioma anula los aplicables a todos los idiomas.

note: type: textblock
en: Settings that are specific to a given master file override both the default ones and the ones coming from the type alias. In this case also, language specific settings override the global ones.
es: Los parámetros que son específicos a un fichero maestro dado anula ambos predeterminados y los que vengan desde el tipo alias. En este caso también, los parámetros específicos del idioma anulan los globales.

note: type: textblock
en: Finally, parameters provided on the B<po4a> command line override any settings from the configuration file.
es: Finalmente, los parámetros proporcionado en la línea de orden B<po4a> supera cualquiera de los parámetros desde el fichero de configuración.

note: type: =head3
en: Example
es: Ejemplo

note: type: textblock
en: Here is an example showing how to quote the spaces and quotes:
es: Aquí hay un ejemplo mostrando como entrecomillas los espacios y entrecomillados:

note: type: verbatim
en:  [options] --master-charset UTF-8
es:  [opciones] --master-charset UTF-8

note: type: verbatim
en:  [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
     [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
                opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose
es:  [po4a_alias:man] man opt:"-o \"mdoc=NOMBRE,VEA ADEMÁS\""
     [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
                opt:"-k 75" opt_es:"-L UTF-8" opt_es:--verbose

note: type: =head2
en: Addendum: Adding extra content in the translation
es: Apéndice: Añadiendo contenido adicional en la traducción

note: type: textblock
en: If you want to add an extra section to the translation, for example to give credit to the translator, then you need to define an addendum to the line defining your master file. Please refer to the page L<po4a(7)> for more details on the syntax of addendum files.
es: Si desea agregar una sección adicional a la traducción, por ejemplo para proporcionar reconocimiento a los traductores, entonces necesita definir un addendum a la línea definiendo su fichero maestro. Refiérase a la página L<po4a(7)> para más detalles en la sintaxis de ficheros addendum.

note: type: verbatim
en:  [type: pod] script fr:doc/fr/script.1 \
                 add_fr:doc/l10n/script.fr.add
es:  [type: pod] script es:doc/es/script.1 \
                 add_es:doc/l10n/script.es.add

note: type: textblock
en: You can also use language templates as follow:
es: Además puede emplear plantillas del idioma como sigue:

note: type: textblock
en: If an addendum fails to apply, the translation is discarded.
es: Si falla un addendum al aplicar, la traducción es descartada.

note: type: =head3
en: Modifiers for the addendum declaration
es: Modificadores para declaración de addendum

note: type: textblock
en: Addendum modifiers can simplify the configuration file in the case where not all languages provide an addendum, or when the list of addenda changes from one language to the other. The modifier is a single char located before the file name.
es: Modificadores de adjuntos pueden simplificar la configuración del fichero dentro del caso donde ninguno de los idioma proporciona un adjunto o cuando el listado de los adjuntos cambia desde un idioma al otro. El modificador es un carácter único localizado antes del nombre del fichero.

note: type: textblock
en: Include I<addendum_path> if this file does exist, otherwise do nothing.
es: Incluye I<ruta_al_apéndice> si el fichero sí existe, y no hace nada de lo contrario.

note: type: textblock
en: I<addendum_path> is not a regular addendum but a file containing a list of addenda, one by line.  Each addendum may be preceded by modifiers.
es: I<ruta_al_apéndice> no es un apéndice normal, sino un fichero que contiene una lista de apéndices, uno por línea. Cada apéndice puede ir precedido de argumentos.

note: type: textblock
en: I<addendum_path> is discarded, it is not loaded and will not be loaded by any further addendum specification.
es: Si I<ruta_al_apéndice> se descarta, no se cargará, independientemente de cualquier especificación adicional referida al apéndice.

note: type: textblock
en: The following includes an addendum in any language, but if only it exists. No error is reported if the addendum does not exist.
es: Lo siguiente incluye un adjunto dentro de cualquier idioma, pero si solamente existe. No se comunica un error si el adjunto no existe.

note: type: verbatim
en:  [type: pod] script $lang:doc/$lang/script.1  add_$lang:?doc/l10n/script.$lang.add
es:  [type: pod] script $lang:doc/$lang/script.1   add_$lang:?doc/l10n/script.$lang.add

note: type: textblock
en: The following includes a list of addendum for every language:
es: Lo siguiente incluye un listado de adjuntos por cada idioma:

note: type: verbatim
en:  [type: pod] script $lang:doc/$lang/script.1  add_$lang:@doc/l10n/script.$lang.add
es:  [type: pod] script $lang:doc/$lang/script.1 add_$lang:@doc/l10n/script.$lang.add

note: type: =head2
en: Filtering the translated strings
es: Filtrar las cadenas traducidas

note: type: textblock
en: Sometimes, you want to hide some strings from the translation process. To that extend, you can give a C<pot_in> parameter to your master file to specify the name of the file to use instead of the real master when building the POT file. Here is an example:
es: A veces, desea ocultar algunos segmentos desde el proceso de traducción. Para eso extender, puede proporcionar un parámetro C<pot_in> a su fichero maestro para especificar el nombre del fichero a utilizar en lugar del maestro real cuando compile el fichero POT. Aquí hay un ejemplo:

note: type: verbatim
en:   [type:docbook] book.xml          \
              pot_in:book-filtered.xml \
              $lang:book.$lang.xml
es:   [type:docbook] libro.xml          \
              pot_in:book-filtered.xml \
              $lang:book.$lang.xml

note: type: textblock
en: With this setting, the strings to translate will be extracted from the F<book-filtered.xml> (that must be produced before calling B<po4a>) while the translated files will be built from F<book.xml>. As a result, any string that is part of F<book.xml> but not in F<book-filtered.xml> will not be included in the PO files, preventing the translators from providing a translation for them. So these strings will be left unmodified when producing the translated documents.  This naturally decreases the level of translation, so you may need the C<--keep> option to ensure that the document is produced anyway.
es: Con este parámetro, los segmentos a traducir serán extraídos desde el F<libro.filtrado.xml> (ese debe ser generado antes de invocar B<po4a>) mientras los ficheros traducidos serán compilados desde F<libro.xml>. Como un resultado, cualquier segmento que es parte de F<libro.xml> pero no está dentro del F<libro-filtrado.xml> no será incluido dentro de los ficheros PO, impidiendo a los traductores desde proporionar una traducción para ellos. Por tanto estos segmentos serán dejados sin modificar cuando produzca los documentos traducidos.  Esto naturalmente decrementa el nivel de traducción, por lo que quizá necesita la opción C<--keep> para asegurar que el documento es generado a pesar de todo.

note: type: =head1
en: AUTHORS
es: AUTORES

note: type: =head1
en: COPYRIGHT AND LICENSE
es: DERECHO DE COPIA Y LICENCIA

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL (see the COPYING file).
es: Esto es software libre; puede redistribuirlo y/o modificarlo bajo las condiciones de la licencia GPL (consulte el fichero COPYING).

note: type: textblock
en: po4a-gettextize - convert an original file (and its translation) to a PO file
es: po4a-gettextize - Convierte un fichero original (y su traducción) a un fichero PO

note: type: textblock
en: (I<XX.po> is the output, all others are inputs)
es: (I<XX.po> es la salida, todos los otros son entrada)

note: type: textblock
en: Format of the documentation you want to handle. Use the B<--help-format> option to see the list of available formats.
es: El formato de la documentación que desea tratar. Use la opción B<--help-format> para ver la lista de los formatos disponibles.

note: type: textblock
en: File containing the master document to translate. You can use this option multiple times if you want to gettextize multiple documents.
es: El fichero que contiene el documento original o principal a traducir. Puede usar esta opción varias veces si desea gettextizar varios documentos.

note: type: textblock
en: Charset of the file containing the document to translate.
es: El juego de caracteres del fichero que contiene el documento a traducir.

note: type: textblock
en: File containing the localized (translated) document. If you provided multiple master files, you may wish to provide multiple localized file by using this option more than once.
es: El fichero que contiene el documento localizado (traducido). Si introdujo varios documentos originales, puede que desee introducir varios documentos localizados usando esta opción más de una vez.

note: type: textblock
en: Charset of the file containing the localized document.
es: El juego de caracteres del fichero que contiene la versión localizada del documento.

note: type: textblock
en: File where the message catalog should be written. If not given, the message catalog will be written to the standard output.
es: El fichero dónde se debería escribir el catálogo de mensajes. Si no se proporciona, el catálogo de mensajes se escribirá por la salida estándar.

note: type: textblock
en: List the documentation formats understood by po4a.
es: Listado de formatos de documentación reconocidos por po4a.

note: type: =head2
en: Converting a manual translation to po4a
es: Convertir una traducción manual a po4a

note: type: verbatim
en:     Original         Translation
es:     Original         Traducción

note: type: verbatim
en:   chapter            chapter
        paragraph          paragraph
        paragraph          paragraph
        paragraph        chapter
      chapter              paragraph
        paragraph          paragraph
es:   capítulo           capítulo
        párrafo            párrafo
        párrafo            párrafo
        párrafo          capítulo
      capítulo             párrafo
        párrafo            párrafo

note: type: =head3
en: Hints and tricks for the gettextization process
es: Consejos y trucos para el proceso de gettextización

note: type: textblock
en: Do not hesitate to kill any original content that would not exist in the translated version. This content will be automatically reintroduced afterward, when synchronizing the PO file with the document.
es: No dude en eliminar cualquier contenido original que no existiese dentro de la versión traducida. Este contenido será reintroducido automáticamente después, cuando sincronice el fichero PO con el documento.

note: type: textblock
en: Sometimes, the paragraph content does match, but not their types. Fixing it is rather format-dependent. In POD and man, it often comes from the fact that one of them contains a line beginning with a white space while the other does not.  In those formats, such paragraph cannot be wrapped and thus become a different type. Just remove the space and you are fine. It may also be a typo in the tag name in XML.
es: A veces el contenido del párrafo encaja, pero no sus tipos. Arreglar eso depende más bien del formato. En POD y man, a menudo es culpa de que una de las líneas empieza con un espacio y la otra no.  En estos formatos, este párrafo no se podría justificar y su tipo cambiaría. Simplemente elimine el espacio y ya está. También puede tratarse de un error tipográfico en el nombre de la etiqueta en XML.

note: type: textblock
en: Likewise, two paragraphs may get merged together in POD when the separating line contains some spaces, or when there is no empty line between the B<=item> line and the content of the item.
es: De manera parecida, dos párrafos se podrían fusionar en un POD cuando la línea de separación contiene algunos espacios, o cuando no hay una línea de separación entre la línea B<=item> y el contenido del elemento («item»).

note: type: textblock
en: po4a-normalize - normalize a documentation file by parsing it in po4a, and writing it back
es: po4a-normalize - Normaliza un archivo de documentación analizándolo con po4a, y vuelve a escribirlo

note: type: textblock
en: B<po4a-normalize> B<-f> I<fmt> I<master.doc>
es: B<po4a-normalize> B<-f> I<formatoE> I<original.doc>

note: type: textblock
en: The po4a (PO for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation.
es: 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.

note: type: textblock
en: The B<po4a-normalize> script is a debugging tool used to make sure that po4a don't change the document when it's not supposed to. Only use it if you're developing a new module, or if you doubt the sanity of the tools.
es: El script B<po4a-normalize> es una herramienta de depuración usada para comprobar que po4a no cambia el documento cuando no debe. Sólo debe usarlo si está desarrollando un módulo nuevo, o si duda de la corrección de las herramientas.

note: type: textblock
en: The generated document will be written to F<po4a-normalize.output> while the generated POT file will be written to F<po4a-normalize.po> by default, but you can use the B<--localized> and B<--pot> options to change that.
es: El documento generado se escribirá en F<po4a-normalize.output> mientras que el fichero POT generado se escribirá en F<po4a-normalize.po> por omisión, pero usted puede usar las opciones B<--localized> y B<--pot> para cambiar esto.

note: type: textblock
en: Create an blank translated document.  The generated translated document will be generated assuming all messages are translated by a space or new line.
es: Crea un documento traducido en blanco. El documento traducido generado se procesará como si la traducción de todos los mensajes fuese un espacio o una línea nueva.

note: type: textblock
en: This is useful to check what parts of the document cannot be translated.
es: Esto es de utilidad para revisar qué partes del documento no se pueden traducir.

note: type: textblock
en: Name of the normalized file to produce (I<po4a-normalize.output> by default).
es: Nombre del fichero normalizado para producir (I<po4a-normalize.output> por defecto).

note: type: textblock
en: Pot file to produce (I<po4a-normalize.po> by default).
es: Fichero POT para producir (I<po4a-normalize.po> por defecto).

note: type: textblock
en: po4a-translate - convert a PO file back to documentation format
es: po4a-translate - Convierte un fichero PO al formato de la documentación

note: type: textblock
en: B<po4a-translate> B<-f> I<fmt> B<-m> I<master.doc> B<-p> I<XX.po> B<-l> I<XX.doc>
es: B<po4a-translate> B<-f> I<formato> B<-m> I<original.doc> B<-p> I<XX.po> B<-l> I<XX.doc>

note: type: textblock
en: (I<XX.doc> is the output, all others are inputs)
es: (I<XX.doc> es la salida, todos los otros son entrada)

note: type: textblock
en: The B<po4a-translate> script is in charge of converting the translation (which was done in a PO file) back into the documentation format. The provided PO file should be the translation of the POT file which was produced by L<po4a-gettextize(1)>.
es: El script B<po4a-translate> se encarga de convertir la traducción (que se hizo en un fichero PO) de vuelta al formato de la documentación. El fichero PO proporcionado debe ser la traducción del fichero POT que se produjo con F<po4a-gettextize(1)>.

note: type: textblock
en: Add a file to the resulting file (to put translator's name or a section "About this translation", for example). The first line of the file to insert should be a PO4A header indicating where it should be added (see section B<HOWTO add extra text to translations> in L<po4a(7)>).
es: Añade un fichero al fichero resultante (para poner el nombre del traductor o una sección «Acerca de esta traducción», por ejemplo). La primera línea del fichero a insertar debe ser la cabecera PO4A indicando dónde se debe insertar (consulte la sección B<Cómo añadir texto adicional a las traducciones> en L<po4a(7)>).

note: type: textblock
en: File containing the master document to translate.
es: El fichero que contiene el documento original a traducir.

note: type: textblock
en: File where the localized (translated) document should be written.
es: El fichero donde se debe escribir el documento localizado (traducido).

note: type: textblock
en: File from which the message catalog should be read.
es: El fichero del que se debe leer el catálogo de mensajes.

note: type: textblock
en: Minimal threshold for translation percentage to keep (i.e. write) the resulting file (default: 80). I.e. by default, files have to be translated at least at 80% to get written.
es: El umbral mínimo del porcentaje de traducción para preservar (es decir, escribir) el fichero resultante (predefinido: 80). Es decir, por omisión los ficheros deben estar traducidos como mínimo en un 80% para que se escriba el fichero resultante.

note: type: textblock
en: Column at which we should wrap the resulting file.
es: La columna en la que se debe justificar el fichero resultante.

note: type: textblock
en: Argument can be followed by a comma and either B<wrap> or B<nowrap> keyword.  References are written by default on a single line.  The B<wrap> option wraps references on several lines, to mimic B<gettext> tools (B<xgettext> and B<msgmerge>).  This option will become the default in a future release, because it is more sensible.  The B<nowrap> option is available so that users who want to keep the old behavior can do so.
es: El argumento puede preceder a una coma y a la palabra clave B<wrap> o B<nowrap>. Las referencias se escriben en una sola línea por omisión. La opción B<wrap> justifica las referencias en varias líneas, para imitar a las herramientas B<gettext> (B<xgettext> y B<msgmerge>). Esta opción será el comportamiento predefinido en el futuro, ya que es más inteligente. La opción B<nowrap> está disponible para aquellos usuarios que deseen mantener el comportamiento antiguo.

note: type: textblock
en: Note that this option has no impact on how the msgid and msgstr are wrapped, ie on how newlines are added to the content of these strings.
es: Tenga en cuenta que esta opción no tiene ningún impacto en cómo se ajustan msgid y msgstr, es decir, en cómo se agregan nuevas líneas al contenido de estas cadenas.

note: type: =head1
en: Adding content (beside translations) to generated files
es: Añadir contenido (aparte de las traducciones) a los ficheros generados

note: type: textblock
en: To add some extra content to the generated document beside what you translated (like the name of the translator, or an "About this translation" section), you should use the B<--addendum> option.
es: Para añadir algún contenido adicional al documento generado además de lo traducido (como el nombre del traductor, o una sección «Sobre ésta traducción»), debe usar la opción B<--addendum>.

note: type: textblock
en: The first line of the addendum must be a header indicating where to put it in the document (it can be before or after a given part of the document).  The rest of the file will be added verbatim to the resulting file without further processing.
es: La primera línea de un apéndice («addendum») debe ser una cabecera indicando en qué parte del documento se debe insertar (puede ser antes o después de una parte del documento). El resto del fichero se insertará tal cual al fichero resultante sin ningún procesado adicional.

note: type: textblock
en: Note that if po4a-translate fails to add one of the given files, it discards the whole translation (because the missing file could be the one indicating the author, what would prevent the users to contact him to report bugs in the translation).
es: Tenga en cuenta que si po4a-translate no puede añadir uno de los ficheros dados, descarta la traducción entera (porque el fichero que falta puede ser el que contenía los datos del autor, lo que impediría a los usuarios contactar con él para informarle de errores en la traducción).

note: type: textblock
en: The header has a pretty rigid syntax. For more information on how to use this feature and how it works, please refer to the L<po4a(7)> man page.
es: La cabecera tiene una sintaxis bastante rígida. Para más información sobre cómo usar esta característica y su funcionamiento, consulte la página de manual L<po4a(7)>.

note: type: textblock
en: po4a-updatepo - update the translation (in PO format) of documentation
es: po4a-updatepo - Actualiza la traducción (en formato PO) de la documentación

note: type: textblock
en: B<po4a-updatepo> B<-f> I<fmt> (B<-m> I<master.doc>)+ (B<-p> I<XX.po>)+
es: B<po4a-updatepo> B<-f> I<formatoE> (B<-m> I<original.doc>)+ (B<-p> I<XX.po>)+

note: type: textblock
en: (I<XX.po> are the outputs, all others are inputs)
es: (I<XX.po> son la salida, todos los otros son entrada)

note: type: textblock
en: The B<po4a-updatepo> script is in charge of updating PO files to make them reflect the changes made to the original documentation file. For that, it converts the documentation file to a POT file, and call L<msgmerge(1)> on this new POT and on the provided PO files.
es: El script B<po4a-updatepo> se encarga de la actualización de los ficheros PO para que reflejen los cambios realizados en los ficheros de documentación originales. Para eso, convierte el fichero de documentación a un fichero POT, e invoca L<msgmerge(1)> sobre este nuevo POT y los ficheros PO proporcionados.

note: type: textblock
en: It is possible to give more than one PO file (if you want to update several languages at once), and several documentation files (if you want to store the translations of several documents in the same PO file).
es: Es posible proporcionar más de un fichero PO (si quiere actualizar varios idiomas a la vez), y varios ficheros de documentación (si quiere guardar la traducción de varios documentos en un mismo fichero PO).

note: type: textblock
en: If the master document has non-ASCII characters, this script will convert the PO files to UTF-8 (if they weren't already), for a transparent handling of non-standard characters.
es: Si el documento original contiene caracteres no ASCII, este guion convertirá los ficheros PO a UTF-8 (si no lo usaban ya), para una manipulación transparente de caracteres no estandarizados.

note: type: textblock
en: File(s) containing the master document to translate.
es: Los fichero(s) que contienen el documento original a traducir.

note: type: textblock
en: Charset of the files containing the document to translate. Note that all files must have the same charset.
es: El juego de caracteres de los ficheros que contienen el documento a traducir. Todos los ficheros deben tener el mismo juego de caracteres.

note: type: textblock
en: PO file(s) to update. If these files do not exist, they are created by B<po4a-updatepo>.
es: Fichero(s) PO a actualizar. Si no existen los ficheros se generaran con B<po4a-updatepo>.

note: type: textblock
en: msguntypot - update PO files when a typo is fixed in POT file
es: msguntypot - Actualiza ficheros PO cuando se corrige un error tipográfico en el fichero POT

note: type: textblock
en: B<msguntypot> B<-o> I<old_pot> B<-n> I<new_pot> I<pofiles> ...
es: B<msguntypot> B<-o> I<POT_antiguo> B<-n> I<POT_nuevoE> I<ficheros_PO> ...

note: type: textblock
en: When you fix a trivial error which surely doesn't affect translations (e.g.  a typo) in a POT file, you should unfuzzy the corresponding msgstr in the translated PO files to avoid so extra work to the translators.
es: Cuando arregla un error trivial que con seguridad no afecta a las traducciones (por ejemplo, un error tipográfico) en un fichero POT, debería quitar la condición de cadena difusa («unfuzzy») al correspondiente msgstr en los ficheros PO para así evitar trabajo adicional a los traductores.

note: type: textblock
en: This task is difficult and error prone when done manually, and this tool is there to help doing so correctly. You just need to provide the two versions of the POT file: before the edition and after as marked in the above synopsis, and it all becomes automatic.
es: Esta tarea es difícil y proclive a fallos si se hace manualmente, y esta herramienta existe para ayudarle a que lo haga correctamente. Sólo necesita proporcionar las dos versiones del fichero POT: antes de la edición y después, como se refleja en el anterior resumen, y el proceso pasará a ser automático.

note: type: =head1
en: HOW TO USE IT
es: MODO DE EMPLEO

note: type: textblock
en: In short, when you discover a typo in one of your [english] message, do the following:
es: Resumiendo, cuando descubre un error tipográfico en uno de sus mensajes (en inglés), haga lo siguiente:

note: type: =item
en: - Regenerate your POT and PO files.
es: - Regenere sus ficheros PO y POT.

note: type: verbatim
en:   make -C po/ update-po # for message program translations
      debconf-updatepo      # for debconf translations
      po4a po4a.conf        # for po4a based documentation translations
es:   make -C po/ update-po # para traducciones de mensajes del programa
      debconf-updatepo      # para traducciones de debconf
      po4a po4a.conf        # para traducciones de documentación basadas en po4a

note: type: textblock
en: or something else, depending on your project's building settings. You know how to make sure your POT and PO files are uptodate, don't you??
es: u otra cosa, dependiendo de la configuración de los ajustes de compilación de su proyecto. Ya sabe como asegurarse de que sus ficheros PO y POT están al día, ¿no?

note: type: =item
en: - Make a copy of your POT file.
es: - Crea una copia de su fichero POT.

note: type: verbatim
en:   cp myfile.pot myfile.pot.orig
es:   cp mi_fichero.pot mi_fichero.pot.orig

note: type: =item
en: - Make a copy of all your PO files.
es: - Crea una copia de todos sus ficheros PO.

note: type: verbatim
en:   mkdir po_fridge; cp *.po po_fridge
es:   mkdir po_baúl; cp *.po po_baúl

note: type: =item
en: - Fix your typo.
es: - Arregla el error tipográfico.

note: type: textblock
en: $EDITOR the_file_in_which_there_is_a_typo
es: $EDITOR el_fichero_en_el_que_hay_un_error

note: type: textblock
en: See above.
es: Véase arriba.

note: type: textblock
en: At this point, the typo fix fuzzied all the translations, and this unfortunate change is the only one between the PO files of your main directory and the one from the fridge. Here is how to solve this.
es: En este punto, el error corregido ha convertido en difusas traducciones presentes en todos los ficheros PO, y este desafortunado cambio es el único entre los ficheros PO de su directorio principal y aquellos en el baúl. Aquí tiene la solución.

note: type: =item
en: - Discard fuzzy translation, restore the ones from the fridge.
es: - Descarte las traducciones difusas, restaurando aquellas en el baúl.

note: type: verbatim
en:   cp po_fridge/*.po .
es:   cp po_baúl/*.po .

note: type: =item
en: - Manually merge the PO files with the new POT file, but taking the useless fuzzy into account.
es: - Fusione manualmente los ficheros PO con el nuevo fichero POT, pero teniendo en cuenta la cadena difusa inútil.

note: type: verbatim
en:   msguntypot -o myfile.pot.orig -n myfile.pot *.po
es:   msguntypot -o mi_fichero.pot.orig -n mi_fichero.pot *.po

note: type: =item
en: - Cleanups.
es: - Limpieza.

note: type: verbatim
en:   rm -rf myfile.pot.orig po_fridge
es:   rm -rf mi_fichero.pot.orig po_baúl

note: type: textblock
en: You're done. The typo was eradicated from msgstr of both your POT and PO files, and the PO files were not fuzzyied in the process. Your translators love you already.
es: Y ya está. El error se eliminó de los msgstr de los ficheros POT y PO, y los ficheros PO no añadieron cadenas difusas en el proceso. Sus traductores ya le aman.

note: type: textblock
en: Despite its name, this tool is not part of the gettext tool suite. It is instead part of po4a. More precisely, it's a random Perl script using the fine po4a modules. For more information about po4a, please see:
es: A pesar de su nombre, esta herramienta no forma parte del conjunto de herramientas de gettext. En lugar de ello, forma parte de po4a. Más exactamente, es un script aleatorio de Perl que usa los módulos de po4a. Para más información acerca de po4a consulte:

note: type: textblock
en: Copyright 2005 by SPI, inc.
es: Copyright 2005 por SPI, inc.

note: type: textblock
en: po4a - framework to translate documentation and other materials
es: po4a - Un marco de trabajo para traducir documentación y otro material

note: type: =head1
en: Introduction
es: Introducción

note: type: textblock
en: po4a (PO for anything) eases the maintenance of documentation translation using the classical gettext tools. The main feature of po4a is that it decouples the translation of content from its document structure.
es: po4a (PO para todo) facilita el mantenimiento de traducción de documentación utilizando las clásicas herramientas gettext. La característica de po4a principal es que desacopla la traducción del contenido desde su estructura documental.

note: type: textblock
en: This document serves as an introduction to the po4a project with a focus on potential users considering whether to use this tool and on the curious wanting to understand why things are the way they are.
es: Este documento sirve como una introducción para el proyecto po4a con un enfoque en usuarios potenciales considerando si utiliza esta herramienta y en la curioso deseo de entender por qué las cosas son de la manera que son.

note: type: =head1
en: Why po4a?
es: ¿Por qué po4a?

note: type: textblock
en: The philosophy of Free Software is to make the technology truly available to everyone. But licensing is not the only consideration: untranslated free software is useless for non-English speakers. Therefore, we still have some work to do to make software available to everybody.
es: La filosofía de Free Software , es hacer que la tecnología está disponible a cada uno. Pero la licencia no es la única consideración: el software libre no traducido es inútil para los hablantes no ingleses. Por lo tanto, aún hay tarea que hacer para crear software disponible para todos.

note: type: textblock
en: This situation is well understood by most projects and everybody is now convinced of the necessity to translate everything. Yet, the actual translations represent a huge effort of many individuals, crippled by small technical difficulties.
es: Esta situación es bien entendida por muchos proyectos y cada uno ahora está convencido de la necesidad de traducir todo. Aún, las traducciones actuales representan un enorme esfuerzo de muchos individuales, heridos por pequeñas dificultades técnicas.

note: type: textblock
en: Thankfully, Open Source software is actually very well translated using the gettext tool suite. These tools are used to extract the strings to translate from a program and present the strings to translate in a standardized format (called PO files, or translation catalogs). A whole ecosystem of tools has emerged to help the translators actually translate these PO files. The result is then used by gettext at run time to display translated messages to the end users.
es: Agradecidamente, el software libre se beneficia de un nivel decente de traducción gracias al maravilloso conjunto de herramientas gettext. Éste puede extraer las cadenas a traducir de un programa, presentarlas en un formato uniforme a los traductores, y luego usar el resultado de su trabajo durante la ejecución para mostrar los mensajes traducidos al usuario.

note: type: textblock
en: B<The goal of the po4a project is to ease the work of documentation translators>.  In particular, it makes documentation translations I<maintainable>.
es: B<La ambición del proyecto po4a es facilitar el trabajo de los traductores de la documentación>.  En particular, crea traducciones de documentación I<mantenibles>.

note: type: textblock
en: Please also see the B<FAQ> below in this document for a more complete list of the advantages and disadvantages of this approach.
es: Por favor, lea también las B<Preguntas frecuentes>, más abajo en éste documento, para una lista más completa de las ventajas y desventajas de este enfoque al problema.

note: type: =head2
en: Supported formats
es: Formatos compatibles

note: type: textblock
en: Currently, this approach has been successfully implemented to several kinds of text formatting formats:
es: Actualmente se han implementado satisfactoriamente algunos tipos de formato de texto:

note: type: =item
en: man (mature parser)
es: man (intérprete maduro)

note: type: textblock
en: The good old manual pages' format, used by so many programs out there. po4a support is very welcome here since this format is somewhat difficult to use and not really friendly to newbies.
es: El clásico formato de las páginas de manual, usado por muchos programas fuera de allí. La compatibilidad con po4a es bienvenida ya que el formato es algo difícil de usar, y no muy amistoso para los principiantes.

note: type: textblock
en: The L<Locale::Po4a::Man(3pm)|Man> module also supports the mdoc format, used by the BSD man pages (they are also quite common on Linux).
es: El módulo L<Locale::Po4a::Man(3pm)|Man> además admite el formato mdoc, utilizado por las páginas man BSD (no son muy comunes en Linux).

note: type: =item
en: AsciiDoc (mature parser)
es: AsciiDoc (intérprete maduro)

note: type: textblock
en: This format is a lightweight markup format intended to ease the authoring of documentation. It is for example used to document the git system. Those manpages are translated using po4a.
es: Este formato es un formato de margen ligero entendido para facilitar la autoría de documentación. Es utilizado por ejemplo para documentación del sistema git. Esas páginas man son traducidas utilizando po4a.

note: type: textblock
en: See L<Locale::Po4a::AsciiDoc> for details.
es: Vea L<Locale::Po4a::AsciiDoc> para detalles.

note: type: =item
en: pod (mature parser)
es: pod (intérprete maduro)

note: type: textblock
en: This is the Perl Online Documentation format. The language and extensions themselves are documented using this format in addition to most existing Perl scripts. It makes easy to keep the documentation close to the actual code by embedding them both in the same file. It makes programmer's life easier, but unfortunately, not the translator's, until you use po4a.
es: Este es el formato «Perl Online Documentation» (Documentación en línea de Perl). El lenguaje y sus mismas extensiones están documentados utilizando este formato junto la suma de muchos guiones Perl existentes. Hace muy fácil mantener la documentación cerca del código al integrarlos en el mismo fichero. Facilita la vida del programador, pero por desgracia, no la del traductor, hasta que utilice po4a.

note: type: textblock
en: See L<Locale::Po4a::Pod> for details.
es: Vea L<Locale::Po4a::Pod> para detalles.

note: type: =item
en: sgml (mature parser)
es: sgml (intérprete maduro)

note: type: textblock
en: Currently, only DebianDoc and DocBook DTD are supported, but adding support for a new one is really easy. It is even possible to use po4a on an unknown SGML DTD without changing the code by providing the needed information on the command line. See L<Locale::Po4a::Sgml(3pm)> for details.
es: Actualmente, sólo son compatibles los DTD de DebianDoc y de DocBook, pero añadir compatibilidad con uno nuevo es realmente fácil. Incluso es posible usar po4a con un DTD desconocido de SGML sin cambiar el código introduciendo la información necesaria en la línea de órdenes. Consulte L<Locale::Po4a::Sgml(3pm)> para más detalles.

note: type: =item
en: TeX / LaTeX (mature parser)
es: TeX / LaTeX (intérprete maduro)

note: type: textblock
en: The LaTeX format is a major documentation format used in the Free Software world and for publications.
es: El formato LaTeX es un formato de documentación usado principalmente en el mundo del Software Libre y para publicaciones.

note: type: textblock
en: The L<Locale::Po4a::LaTeX(3pm)|LaTeX> module was tested with the Python documentation, a book and some presentations.
es: Se probó el módulo L<Locale::Po4a::LaTeX(3pm)|LaTeX> con la documentación de Python, un libro y algunas presentaciones.

note: type: =item
en: text (mature parser)
es: texto (intérprete maduro)

note: type: textblock
en: The Text format is the base format for many formats that include long blocks of text, including Markdown, fortunes, YAML front matter section, debian/changelog, and debian/control.
es: El formato Texto es el formato base para muchos formatos que incluyen bloques grandes de texto, incluyendo Markdown, fortunes, sección matter de frente YAML, debian/changelog, y debian/control.

note: type: textblock
en: This supports the common format used in Static Site Generators, READMEs, and other documentation systems. See L<Locale::Po4a::Text(3pm)|Text> for details.
es: Esto admite el formato común utilizado en Generadores de Sitio Estático, README, y otros sistemas de documentación. Vea L<Locale::Po4a::Text(3pm)|Texto> para detalles.

note: type: =item
en: xml and XHMTL (probably mature parser)
es: xml y XHML (intérprete probablemente maduro)

note: type: textblock
en: The XML format is a base format for many documentation formats.
es: El formato XML sirve de base para muchos formatos de documentación.

note: type: textblock
en: Currently, the DocBook DTD (see L<Locale::Po4a::Docbook(3pm)> for details) and XHTML are supported by po4a.
es: Actualmente, el formato DTD de DocBook (vea L>Locale::Po4a::DocBook(3pm)> para detalles) y XHTML están admitidos por po4a.

note: type: =item
en: BibTex (probably mature parser)
es: BibTex (intérprete probablemente maduro)

note: type: textblock
en: The BibTex format is used alongside LaTex for formatting lists of references (bibliographies).
es: El formato BibTex es utilizado a lo largo de LaTeX para listados de formato de referencias (bibliográficos).

note: type: textblock
en: See L<Locale::Po4a::BibTex> for details.
es: Vea L<Locale::Po4a::BibTex> para detalles.

note: type: =item
en: Docbook (probably mature parser)
es: Docbook (intérprete probablemente maduro)

note: type: textblock
en: A XML-based markup language that uses semantic tags to describe documents.
es: Un lenguaje añadido basado en XML que utiliza etiquetados semánticos para describir documentos.

note: type: textblock
en: See L<Locale::Po4a:Docbook> for greater details.
es: Vea L<Locale::Po4a:Docbook> para detalles mayores.

note: type: =item
en: Guide XML (probably mature parser)
es: Guide XML (intérprete probablemente maduro)

note: type: textblock
en: A XML documentation format. This module was developed specifically to help with supporting and maintaining translations of Gentoo Linux documentation up until at least March 2016 (Based on the Wayback Machine). Gentoo have since moved to the DevBook XML format.
es: Un formato de documentación XML. Este módulo fue desarrollado específicamente para ayudar con apoyo y mantenimiento de traducciones de documentación de Linux Gentoo hasta al menos en marzo de 2016 (basado en la Máquina Wayback). Gentoo desde entonces se ha migrado al formato XML DevBook.

note: type: textblock
en: See L<Locale::Po4a:Guide> for greater details.
es: Vea L<Locale::Po4a:Guide> para detalles mayores.

note: type: =item
en: Wml (probably mature parser)
es: Wml (probablemente intérprete maduro)

note: type: textblock
en: The Web Markup Language, do not mixup WML with the WAP stuff used on cell phones.  This module relies on the Xhtml module, which itself relies on the XmL module.
es: El XML (Web Markup Language), no mezcla WML con la materia WAP utilizada en celdas de teléfonos.  Este módulo depende del módulo XHTML, el mismo que dependo del módulo XML.

note: type: textblock
en: See L<Locale::Po4a::Wml> for greater details.
es: Vea L<Locale::Po4a::Wml> para detalles mayores.

note: type: =item
en: Yaml (probably mature parser)
es: Yaml (probablemente intérprete maduro)

note: type: textblock
en: See L<Locale::Po4a::Yaml> for greater details.
es: Vea L<Locale::Po4a::Yaml> para más detalles.

note: type: textblock
en: See L<Locale::Po4a::RubyDoc> for greater details.
es: Vea L<Locale::Po4a::RubyDoc> para detalles mayores.

note: type: textblock
en: A documentation production system, with elements similar to TeX, debiandoc-sgml, TeXinfo, and others, developed by Simon Tatham, the developer of PuTTY.
es: Un sistema de producción de documentación, con elementos similares a TeX, debiandoc-sgml, TeXinfo, y otros, desarrollados por Simon Tatham, el desarrollador de PuTTY.

note: type: textblock
en: See L<Locale::Po4a:Halibut> for greater details.
es: Vea L<Locale::Po4a:Halibut> para detalles mayores.

note: type: =item
en: Ini (probably experimental parser)
es: Ini (probablemente intérprete experimental)

note: type: textblock
en: Configuration file format popularized by MS-DOS.
es: Formado del archivo de configuración popularizado por MS-DOS.

note: type: textblock
en: See L<Locale::Po4a::Ini> for greater details.
es: Vea L<Locale::Po4a::Ini> para detalles más grandes.

note: type: =item
en: texinfo (very highly experimental parser)
es: texinfo (intérprete altamente experimental)

note: type: textblock
en: All of the GNU documentation is written in this format (it's even one of the requirements to become an official GNU project). The support for L<Locale::Po4a::Texinfo(3pm)|Texinfo> in po4a is still at the beginning.  Please report bugs and feature requests.
es: Toda la documentación de GNU está escrita en este formato (es incluso un requisito para ser un proyecto oficial de GNU). La compatibilidad de L<Locale::Po4a::Texinfo(3pm)|Texinfo> en po4a está en sus inicios. Por favor, remita informes de fallo y peticiones de funcionalidades.

note: type: =item
en: Others supported formats
es: Otros formatos admitidos

note: type: textblock
en: Po4a can also handle some more rare or specialized formats, such as the documentation of compilation options for the 2.4+ Linux kernels (L<Locale::Po4a::KernelHelp>) or the diagrams produced by the dia tool (L<Locale::Po4a:Dia>). Adding a new format is often very easy and the main task is to come up with a parser for your target format. See L<Locale::Po4a::TransTractor(3pm)> for more information about this.
es: Po4a también puede tratar algunos formatos raros o específicos, tales como la documentación de las opciones de compilación de núcleos 2.4+ (L<Locale::Po4a::KernelHelp>) o los diagramas producidos por la herramienta (L<Locale::Po4a:Dia>). Añadir un formato nuevo es a menudo una tarea muy sencilla, y la tarea principal es conseguir un intérprete para el formato escogido. Consulte L<Locale::Po4a::TransTractor(3pm)> para más información.

note: type: =item
en: Unsupported formats
es: Formatos no compatibles

note: type: textblock
en: Unfortunately, po4a still lacks support for several documentation formats. Many of them would be easy to support in po4a. This includes formats not just used for documentation, such as, package descriptions (deb and rpm), package installation scripts questions, package changelogs, and all the specialized file formats used by programs such as game scenarios or wine resource files.
es: Desafortunadamente, po4a aún le falta compatibilidad para formatos de documentación. Muchos de ellos serían sencillos de mantener en po4a. Esto incluye formatos no tan solo utilizados para documentación, como descripciones de paquetes (deb y rpm), guiones de instalación de paquetes , boletines del paquete, y todos los formatos de archivos especializados utilizados por los programas tales como escenarios de juegos o los archivos de recursos de wine.

note: type: =head1
en: Using po4a
es: Cómo utilizar po4a

note: type: =head2
en: Graphical overview of the po4a scripts
es: Visión gráfica esquemática de los script po4a

note: type: verbatim
en:                                    master.doc
                                           |
                                           V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :           |                     |                        :
    {translation}    |         { update of master.doc }             :
         :           |                     |                        :
       XX.doc        |                     V                        V
     (optional)      |                 master.doc ->-------->------>+
         :           |                   (new)                      |
         V           V                     |                        |
      [po4a-gettextize]   doc.XX.po -->+   |                        |
              |            (old)       |   |                        |
              |              ^         V   V                        |
              |              |     [po4a-updatepo]                  |
              V              |           |                          V
       translation.pot       ^           V                          |
              |              |        doc.XX.po                     |
              |              |         (fuzzy)                      |
       { translation }       |           |                          |
              |              ^           V                          V
              |              |     {manual editing}                 |
              |              |           |                          |
              V              |           V                          V
          doc.XX.po --->---->+<---<-- doc.XX.po    addendum     master.doc
          (initial)                 (up-to-date)  (optional)   (up-to-date)
              :                          |            |             |
              :                          V            |             |
              +----->----->----->------> +            |             |
                                         |            |             |
                                         V            V             V
                                         +------>-----+------<------+
                                                      |
                                                      V
                                               [po4a-translate]
                                                      |
                                                      V
                                                    XX.doc
                                                 (up-to-date)
es:                                    maestro.doc
                                                   |
                                                   V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :                                 |                        |                                         :
    {traducción}              |    { actualizar maestro.doc }         :
         :                   |                     |                                                          :
       XX.doc        |                     V                                     V
     (opcional)   |                 maestro.doc ->------->----->+
         :                   |                   (nuevo)                                      |
         V                 V                           |                                            |
      [po4a-gettextize]          doc.XX.po-->+   |                   |
          |  (antiguo)                      |                            |                  |
          |                 ^                       V                          V                  |
              |              |                        [po4a-updatepo]             |
              V             |               |                          V
        traducción.pot       ^                         V                            |
              |                               |                 doc.XX.po                   |
              |              |               («fuzzy» (difusa))                        |
       { traducción }                      |               |                              |
              |          ^                         V             V                                 |
              |          |                    {edición manual}                      |
              |          |                             |                            |                  |
              V         |                            V                          V                  |
          doc.XX.po -------->---->+<---<---- doc.XX.po  apéndice    maestro.doc
          (inicial)                                               (actualizado) (opcional)  (actualizado) 
              :                                        |                         |                        |
              :                                       V                        |                         |
              +----->----->--->------ +                        |                         |
                                                       |                         |                         |
                                                       V                      V                         V
                                                       +------>------+------<---------+
                                                                               |
                                                                              V
                                                                [po4a-translate]
                                                                              |
                                                                              V
                                                                      XX.doc
                                                                   (actualizado)

note: type: textblock
en: This schema is complicated, but in practice only the right part (involving L<po4a-updatepo(1)> and L<po4a-translate(1)>) is used once the project is setup and configured.
es: Este esquema es complicado, pero en la práctica solo la parte derecha (relacionando L<po4a-updatepo(1)> y L<po4a-transalte(1)>) es utilizado una vez que el proyecto está instalado y configurado.

note: type: textblock
en: As noted before, the L<po4a(1)> program combines the effects of the separated scripts, updating the PO files and the translated document in one invocation.  The underlying logic remains the same.
es: Como notificado antes, el programa L<po4a(1)> combina los resultados de los script separados, actualizando los archivos PO y el documento traducido en una invocación.  La lógica por la que se trata permanece igual.

note: type: =head2
en: Starting a new translation
es: Iniciar una nueva traducción

note: type: verbatim
en:   $ po4a-gettextize --format <format> --master <master.doc> --po <translation.pot>
es:   $ po4a-gettextize --format <formato> --master <maestro.doc> --po <traducción.pot>

note: type: textblock
en: The master document is used in input, while the POT file is the output of this process.
es: El documento maestro es utilizado en la entrada, mientras que el fichero POT es la salida de este proceso.

note: type: =head2
en: Integrating changes to the original document
es: Integrando cambios al documento original

note: type: textblock
en: The script to use for that is L<po4a-updatepo(1)> (please refer to its documentation for details):
es: El guion a utilizar para que es L<po4a-upgradepo(1)> (refiera a su documentación para detalles):

note: type: verbatim
en:   $ po4a-updatepo --format <format> --master <new_master.doc> --po <old_doc.XX.po>
es:   $ po4a-updatepo --format <formato> --master <nuevo_original.doc> --po <doc_antiguo.XX.po>

note: type: textblock
en: The master document is used in input, while the PO file is updated: it is used both in input and output.
es: El documento maestro es utilizado en la entrada, mientras que el archivo PO está actualizado: es utilizado en entrada y salida.

note: type: =head2
en: Generating a translated document
es: Generando un documento traducido

note: type: textblock
en: Once you're done with the translation, you want to get the translated documentation and distribute it to users along with the original one.  For that, use the L<po4a-translate(1)> program as follows:
es: Una vez que ha terminado la traducción, querrá obtener la documentación traducida para distribuirla a los usuarios junto con el original.  Para ello, utilice el programa L<po4a-translate(1)> tal como sigue:

note: type: verbatim
en:   $ po4a-translate --format <format> --master <master.doc> --po <doc.XX.po> --localized <XX.doc>
es:   $ po4a-translate --format <formato> --master <maestro.doc> --po <doc.XX.po> --localized <XX.doc>

note: type: textblock
en: Both the master and PO files are used in input, while the localized file is the output of this process.
es: Ambos el maestro y los archivos PO son utilizados en entrada, mientras que el fichero localizado es la salida de este proceso.

note: type: =head2
en: Using addenda to add extra text to translations
es: Al utilizar adenda para agregar texto adicional para traducciones

note: type: textblock
en: Adding new text to the translation is probably the only thing that is easier in the long run when you translate files manually :). This happens when you want to add an extra section to the translated document, not corresponding to any content in the original document. The classical use case is to give credits to the translation team, and to indicate how to report translation-specific issues.
es: Agregando texto nuevo para la traducción es probablemente la única cosa que es más fácil en la dirección larga cuando traduzca archivos manualmente :). Esto ocurre cuando desea añadir una sección adicional para el documento traducido, no correspondiente a ningún contenido dentro del documento original. La utilización clásica de caso es dar reconocimientos al equipo de traducción, y para indicar como informar problemas específicos de traducción.

note: type: textblock
en: Although this context search may be considered to operate roughly on each line of the B<translated> document, it actually operates on the internal data string of the translated document. This internal data string may be a text spanning a paragraph containing multiple lines or may be a XML tag itself alone. The exact I<insertion point> of the addendum must be before or after the internal data string and can not be within the internal data string.
es: Aunque se puede considerar que esta búsqueda de contexto funciona básicamente en cada línea del documento B<traducido>, en realidad funcionan a partir de la cadena de datos interna del documento traducido. Esta cadena de datos interna puede ser un texto que comprende un párrafo de varias líneas, o una etiqueta XML individual. El I<punto de inserción> preciso del apéndice se debe encontrar antes o después de la cadena de datos interna, y no puede encontrarse dentro de la cadena de datos interna.

note: type: textblock
en: If you want to add something after the following nroff section:
es: Si desea añadir algo después de la siguiente sección de nroff:

note: type: verbatim
en:   .SH "AUTHORS"
es:   .SH "AUTORES"

note: type: textblock
en: You should select a two step approach by setting B<mode=after>. Then you should narrow down search to the line after B<AUTHORS> with the B<position> argument regex. Then, you should match the beginning of the next section (i.e., B<^\.SH>) with the B<beginboundary> argument regex. That is to say:
es: Debería seleccionar un método de dos pasos definiendo B<mode=after>. A continuación debe reducir la búsqueda a la línea posterior a B<AUTHORS> con la expresión regular de argumento de B<position>. Después, debe hacer coincidir el principio de la sección a continuación (esto es, B<^\.SH>) con la expresión regular de argumento B<beginboundary>. Esto es:

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=AUTHORS;beginboundary=\.SH
es:  PO4A-HEADER:mode=after;position=AUTORES;beginboundary=\.SH

note: type: textblock
en: If you want to add something at the end of the document, give a B<position> matching any line of your document (but only one line. Po4a won't proceed if it's not unique), and give an B<endboundary> matching nothing. Don't use simple strings here like B<"EOF">, but prefer those which have less chance to be in your document.
es: Si desea añadir algo al final del documento, especifique un B<position> que encaje con cualquier linea del documento (pero sólo una línea. po4a no procederá si no es única), y ponga un B<endboundary> que no encaje con nada. No utilice cadenas simples como B<"EOF">, sino las que tengan menos probabilidad de salir en el documento.

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=About this document;beginboundary=FakePo4aBoundary
es:  PO4A-HEADER:mode=after;position=Acerca de este documento;beginboundary=FakePo4aBoundary

note: type: =head3
en: More detailed example
es: Ejemplo más detallado

note: type: textblock
en: Original document (POD formatted):
es: Documento original (en formato POD):

note: type: verbatim
en:  |=head1 NAME
     |
     |dummy - a dummy program
     |
     |=head1 AUTHOR
     |
     |me
es:  |=head1 NOMBRE
     |
     |relleno - un programa de relleno
     |
     |=head1 AUTOR
     |
     |yo

note: type: textblock
en: Then, the following addendum will ensure that a section (in French) about the translator is added at the end of the file (in French, "TRADUCTEUR" means "TRANSLATOR", and "moi" means "me").
es: Luego, el siguiente apéndice asegurará que se añade una sección (en español) sobre el traductor al final del fichero.

note: type: verbatim
en:  |PO4A-HEADER:mode=after;position=AUTEUR;beginboundary=^=head
     |
     |=head1 TRADUCTEUR
     |
     |moi
     |
es:  |PO4A-HEADER:mode=after;position=AUTOR;beginboundary=^=head
     |
     |=head1 TRADUCTOR
     |
     |yo
     |

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=NOM;beginboundary=^=head1
es:  PO4A-HEADER:mode=after;position=NOMBRE;beginboundary=^=head1

note: type: textblock
en: This works because the next line matching the B<beginboundary> /^=head1/ after the section "NAME" (translated to "NOM" in French), is the one declaring the authors. So, the addendum will be put between both sections. Note that if another section is added between NAME and AUTHOR sections later, po4a will wrongfully put the addenda before the new section.
es: Esto funciona porque la siguiente linea que encaja con B<beginboundary> «/^=head1/» después de la sección «NOMBRE», es la que declara los autores. Por lo tanto, se colocará el apéndice entre ambas secciones. Tenga en cuenta que si se añade posteriormente otra sección entre NAME y AUTHOR, po4a ubicará de forma indebida el apéndice antes de la sección nueva.

note: type: textblock
en: To avoid this you may accomplish the same using B<mode>=I<before>:
es: Para evitarlo, puede lograr el mismo efecto utilizando B<mode>=I<before>:

note: type: verbatim
en:  PO4A-HEADER:mode=before;position=^=head1 AUTEUR
es:  PO4A-HEADER:mode=before;position=^=head1 AUTHOR

note: type: =head1
en: How does it work?
es: ¿Cómo funciona?

note: type: textblock
en: This chapter gives you a brief overview of the po4a internals, so that you may feel more confident to help us maintaining and improving it. It may also help you understanding why it does not do what you expected, and how to solve your problems.
es: Este capítulo ofrece una breve explicación del funcionamiento interno de po4a, de forma que se pueda sentir más seguro para ayudarnos a desarrollar y mejorar el programa. También le puede ayudar a entender porqué no hace lo que esperaba, y cómo solucionar sus problemas.

note: type: textblock
en: More formally, it takes a document to translate plus a PO file containing the translations to use as input while producing two separate outputs: Another PO file (resulting of the extraction of translatable strings from the input document), and a translated document (with the same structure than the input one, but with all translatable strings replaced with content of the input PO). Here is a graphical representation of this:
es: Más formalmente, toma un documento a traducir, además del fichero PO que contiene las traducciones a usar como entrada mientras produce dos salidas separadas: Otro fichero PO (resultado de la extracción de las cadenas traducibles del documento de entrada), y un documento traducido (con la misma estructura que el de entrada, pero con las cadenas traducibles reemplazadas por el contenido del PO de entrada). Esta es una representación gráfica de este proceso:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \      TransTractor::       /       (translated)
                          +-->--   parse()  --------+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
es:    Documento de entrada -\                        /---> Documento de salida
                              \    TransTractor::    /         (traducido)
                               +-->-- parse()  ------+
                              /                       \ 
       PO de entrada --------/                         \---> PO de salida
                                                               (extraído)

note: type: =head1
en: FAQ
es: Preguntas frecuentes

note: type: =head2
en: What about the other translation tools for documentation using gettext?
es: ¿Qué hay de las otras herramientas de traducción de documentación que usan gettext?

note: type: textblock
en: This is the tool developed by KDE people to handle DocBook XML. AFAIK, it was the first program to extract strings to translate from documentation to PO files, and inject them back after translation.
es: Esta es la herramienta desarrollada por la gente de KDE para tratar DocBook XML. Me parece que este fue el primer programa que extrajo cadenas de texto a traducir desde la documentación a ficheros PO, e inyectarlas de vuelta después de la traducción.

note: type: textblock
en: It can only handle XML, and only a particular DTD. I'm quite unhappy with the handling of lists, which end in one big msgid. When the list become big, the chunk becomes harder to swallow.
es: Únicamente puede tratar XML, y solo un DTD en particular. Estoy bastante insatisfecho con el tratamiento que hacen de las listas, que terminan en un único msgid. Cuando la lista crece, el bloque se hace difícil de tratar.

note: type: textblock
en: This program done by Denis Barbier is a sort of precursor of the po4a SGML module, which more or less deprecates it. As the name says, it handles only the DebianDoc DTD, which is more or less a deprecated DTD.
es: Este programa hecho por Denis Barbier es un tipo de precursor del módulo SGML de po4a, que más o menos lo deja obsoleto. Como su nombre indica, únicamente trata el DTD de DebianDoc, que es más o menos un DTD anticuado.

note: type: textblock
en: The main advantages of po4a over them are the ease of extra content addition (which is even worse there) and the ability to achieve gettextization.
es: Las principales ventajas de po4a sobre ellos son la facilidad de adición de contenidos extra (que es aún peor ahí) y la habilidad de realizar la gettextización.

note: type: =head2
en: SUMMARY of the advantages of the gettext based approach
es: RESUMEN de las ventajas de la metodología basada en gettext

note: type: textblock
en: The translations are not stored along with the original, which makes it possible to detect if translations become out of date.
es: Las traducciones no se guardan junto con el original, lo que hace posible la detección de traducciones anticuadas.

note: type: textblock
en: The translations are stored in separate files from each other, which prevents translators of different languages from interfering, both when submitting their patch and at the file encoding level.
es: Las traducciones se guardan en ficheros separados unos de otros, lo que impide que traductores de diferentes idiomas interfieran en su trabajo tanto al enviar parches, como a nivel de codificación de ficheros.

note: type: textblock
en: It is based internally on B<gettext> (but B<po4a> offers a very simple interface so that you don't need to understand the internals to use it).  That way, we don't have to re-implement the wheel, and because of their wide use, we can think that these tools are more or less bug free.
es: Está basado internamente en B<gettext> (pero B<po4a> ofrece una interfaz muy simple de forma que no necesita entender el funcionamiento interno para usarlo). De esa forma no tenemos que reinventar la rueda, y debido a su uso extendido podemos imaginar que estas herramientas están más o menos libres de fallos.

note: type: textblock
en: Nothing changed for the end-user (beside the fact translations will hopefully be better maintained). The resulting documentation file distributed is exactly the same.
es: Para el usuario final nada ha cambiado (aparte de que, probablemente, las traducciones estarían mejor actualizadas :). El fichero de documentación resultante es exactamente el mismo.

note: type: textblock
en: No need for translators to learn a new file syntax and their favorite PO file editor (like Emacs' PO mode, Lokalize or Gtranslator) will work just fine.
es: No hace falta que los traductores aprendan una nueva sintaxis de fichero, y sus editores favoritos de ficheros PO (como el modo PO de Emacs, Lokalize o Gtranslator) servirán a la perfección.

note: type: textblock
en: gettext offers a simple way to get statistics about what is done, what should be reviewed and updated, and what is still to do. Some example can be found at those addresses:
es: gettext ofrece una manera simple de conseguir estadísticas sobre qué está hecho, qué se debería repasar y actualizar, y lo que queda por hacer. Puede encontrar algunos ejemplos en estas direcciones:

note: type: textblock
en: But everything isn't green, and this approach also has some disadvantages we have to deal with.
es: Pero no todo es bonito, y este enfoque también tiene algunas desventajas con las que debemos lidiar.

note: type: textblock
en: Addenda are… strange at the first glance.
es: Los apéndices son… extraños a primera vista.

note: type: textblock
en: You can't adapt the translated text to your preferences, like splitting a paragraph here, and joining two other ones there. But in some sense, if there is an issue with the original, it should be reported as a bug anyway.
es: No puede adaptar el texto traducido a su gusto, como dividir párrafos por aquí, y juntar esos dos allí. Pero por supuesto, si hay algún problema con el original debería remitir un informe de fallo.

note: type: textblock
en: Even with an easy interface, it remains a new tool people have to learn.
es: Incluso con una interfaz fácil, sigue siendo una nueva herramienta que la gente debe aprender.

note: type: textblock
en: One of my dreams would be to integrate somehow po4a to Gtranslator or Lokalize. When a documentation file is opened, the strings are automatically extracted, and a translated file + po file can be written to disk. If we manage to do an MS Word (TM) module (or at least RTF) professional translators may even use it.
es: Uno de mis sueños es integrar de alguna forma po4a con Gtranslator o Lokalize. Cuando se abra un fichero, se extraen las cadenas automáticamente, y se puede escribir en el disco un fichero traducido y un fichero PO. Si consiguiéramos hacer un módulo para MS Word (TM) (o al menos RTF) incluso podrían usarlo traductores profesionales.

note: type: textblock
en: The documentation of the individual po4a scripts: L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, L<po4a-translate(1)>, L<po4a-normalize(1)>.
es: La documentación del script individual po4a: L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, L<po4a-translate(1)>, L<po4a-normalize(1)>.

note: type: textblock
en: The parsers of each formats, in particular to see the options accepted by each of them: L<Locale::Po4a::AsciiDoc(3pm)> L<Locale::Po4a::Dia(3pm)>, L<Locale::Po4a::Guide(3pm)>, L<Locale::Po4a::Ini(3pm)>, L<Locale::Po4a::KernelHelp(3pm)>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, L<Locale::Po4a::Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::Xhtml(3pm)>, L<Locale::Po4a::Yaml(3pm)>, L<Locale::Po4a::BibTeX(3pm)>, L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::Po4a::LaTeX(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::Sgml(3pm)>, L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::Wml(3pm)>, L<Locale::Po4a::Xml(3pm)>.
es: Loa analizadores de cada formato, en particular para ver las opciones aceptadas por cada uno de ellos: L<Locale::Po4a::AsciiDoc(3pm)> L<Locale::Po4a::Dia(3pm)>, L<Locale::Po4a::Guide(3pm)>, L<Locale::Po4a::Ini(3pm)>, L<Locale::Po4a::KernelHelp(3pm)>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, L<Locale::Po4a::Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::Xhtml(3pm)>, L<Locale::Po4a::Yaml(3pm)>, L<Locale::Po4a::BibTeX(3pm)>, L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::Po4a::LaTeX(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::Sgml(3pm)>, L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::Wml(3pm)>, L<Locale::Po4a::Xml(3pm)>.

note: type: textblock
en: Locale::Po4a::AsciiDoc - convert AsciiDoc documents from/to PO files
es: Locale::Po4a::AsciiDoc - Convierte documentos AsciiDoc desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::AsciiDoc is a module to help the translation of documentation in the AsciiDoc format.
es: Locale::Po4a::AsciiDoc es un módulo que asiste en la traducción de documentación en formato AsciiDoc.

note: type: =head1
en: OPTIONS ACCEPTED BY THIS MODULE
es: OPCIONES ACEPTADAS POR ESTE MODULO

note: type: textblock
en: These are this module's particular options:
es: Estas son las opciones particulares de este módulo:

note: type: textblock
en: The name of a file containing definitions for po4a, as defined in the B<INLINE CUSTOMIZATION> section.  You can use this option if it is not possible to put the definitions in the document being translated.
es: 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.

note: type: textblock
en: In a definitions file, lines must not start by two slashes, but directly by B<po4a:>.
es: En un fichero de definiciones, las líneas no se deben preceder con dos barras, sino directamente con B<po4a:>.

note: type: textblock
en: Space-separated list of attribute entries you want to translate.  By default, no attribute entries are translatable.
es: Una lista separada por espacios de entradas de atributo que quiere traducir. Por omisión, ninguna entrada de atributo es traducible.

note: type: textblock
en: Space-separated list of macro definitions.
es: Una lista separada por espacios de definiciones de macros.

note: type: textblock
en: Space-separated list of style definitions.
es: Una lista separada por espacios de definiciones de estilo.

note: type: textblock
en: This option is a flag that enables sub-table segmentation into cell content.  The segmentation is limited to cell content, without any parsing inside of it.
es: Esta opción es un indicador que habilita segmentación de sub-tabla dentro del contenido de celda.  La segmentación está limitada al contenido de la celda, sin ninguna interpretación dentro de ésta.

note: type: =head1
en: INLINE CUSTOMIZATION
es: PERSONALIZACIÓN DE OBJETOS EN LÍNEA

note: type: textblock
en: The AsciiDoc module can be customized with lines starting by B<//po4a:>.  These lines are interpreted as commands to the parser.  The following commands are recognized:
es: El módulo AsciiDoc se puede personalizar mediante lineas que empiecen con B<//po4a:>. Estas lineas se interpretan como órdenes para el analizador. Se reconocen las siguientes órdenes:

note: type: =item
en: B<//po4a: macro >I<name>B<[>I<attribute list>B<]>
es: B<//po4a: macro >I<nombre>B<[>I<lista de atributos>B<]>

note: type: textblock
en: If a plus sign (B<+>) is prepended to I<name>, then the macro and its arguments are translated as a whole.  There is no need to define attribute list in this case, but brackets must be present.
es: Si se prefija el signo de suma (B<+>) a I<nombre>, la macro y sus argumentos se traducen como conjunto. En este caso, no es necesario definir la lista de atributos, pero los paréntesis deben estar presentes.

note: type: =item
en: B<//po4a: style >B<[>I<attribute list>B<]>
es: B<//po4a: style >B<[>I<lista de atributos>B<]>

note: type: textblock
en: If a plus sign (B<+>) is prepended to the style name, then the attribute list is translated as a whole.  There is no need to define translatable attributes.
es: Si se prefija un signo de suma (B<+>) al nombre de estilo, la lista de atributos se traduce en conjunto. No es necesario definir atributos traducibles.

note: type: textblock
en: If a minus sign (B<->) is prepended to the style name, then this attribute is not translated.
es: Si se prefija un signo de suma (B<->) al nombre de estilo, entonces este atributo no es traducible.

note: type: =item
en: B<//po4a: entry >I<name>
es: B<//po4a: entry >I<nombre>

note: type: textblock
en: This declares an attribute entry as being translatable.  By default, they are not translated.
es: Esto declara una entrada de atributo como traducible. Por omisión, no se traducen.

note: type: =head1
en: STATUS OF THIS MODULE
es: ESTADO DE ESTE MODULO

note: type: textblock
en: Tested successfully on simple AsciiDoc files.
es: Probado con éxito en ficheros simples AsciiDoc.

note: type: textblock
en: Locale::Po4a::BibTeX - convert BibTeX documents from/to PO files
es: Locale::Po4a::BibTeX - Convierte documentos BibTeX de/a ficheros PO

note: type: textblock
en: Locale::Po4a::BibTeX is a module to help the translation of bibliographies in the BibTeX format into other [human] languages.
es: Locale::Po4a::BibTeX es un módulo que asiste en la traducción de bibliografías en formato BibTex a otros lenguajes (humanos).

note: type: textblock
en: Fields values are extracted and proposed for translation.
es: Los valores de los campos se extraen y se proponen para su traducción.

note: type: textblock
en: NONE.
es: NINGUNA.

note: type: textblock
en: It is a very simple module, but still young.
es: Es un módulo muy simple, pero aún reciente.

note: type: textblock
en: Locale::Po4a::Chooser - manage po4a modules
es: Locale::Po4a::Chooser - Gestiona módulos de po4a

note: type: textblock
en: Locale::Po4a::Chooser is a module to manage po4a modules. Previously, all po4a binaries used to know all po4a modules (pod, man, sgml, etc). This made the addition of a new module boring, because you had to make sure that the documentation is synchronized in all modules, and that each of them can access the new module.
es: Locale::Po4a::Chooser es un módulo para la gestión de módulos de po4a. Antes, todos los binarios de po4a conocían toda la información acerca de todos los módulos (pod, man, sgml, etc). Esto hacía que añadir un nuevo módulo fuese una tarea pesada, ya que se debía comprobar que la documentación estuviese sincronizada en todos los módulos, y que todos pudiesen acceder al módulo nuevo.

note: type: textblock
en: Now, you just have to call the Locale::Po4a::Chooser::new() function, passing the name of module as argument.
es: Ahora, solamente tiene que invocar la función «Locale::Po4a::Chooser::new()», introduciendo el nombre del módulo como argumento.

note: type: textblock
en: The function Locale::Po4a::Chooser::list() lists the available formats, and exits with the value passed as argument. So, we call Locale::Po4a::Chooser::list(0) when requested for the list of formats, and Locale::Po4a::Chooser::list(1) when passed an invalid format name.
es: La función «Locale::Po4a::Chooser::list()» enumera los formatos disponibles, y cierra con el valor introducido como argumento. De esta forma, se invoca «Locale::Po4a::Chooser::list(0)» cuando se solicita la lista de formatos, y «Locale::Po4a::Chooser::list(1)» cuando se introduce un nombre de formato no válido.

note: type: =item
en: About po4a:
es: Acerca de po4a:

note: type: =item
en: About modules:
es: Acerca de los módulos:

note: type: textblock
en: Locale::Po4a::Common - common parts of the po4a scripts and utils
es: Locale::Po4a::Common - Partes comunes de los scripts de po4a y herramientas

note: type: textblock
en: Locale::Po4a::Common contains common parts of the po4a scripts and some useful functions used along the other modules.
es: Locale::Po4a::Common contiene partes comunes a los scripts de po4a y algunas funciones útiles usadas por los otros módulos.

note: type: textblock
en: If needed, you can disable the use of Text::WrapI18N as such:
es: Si es necesario, puede deshabilitar el uso de Text::WrapI18N tal como:

note: type: textblock
en: instead of:
es: en lugar de:

note: type: textblock
en: The ordering is important here: as most Locale::Po4a modules load themselves Locale::Po4a::Common, the first time this module is loaded determines whether Text::WrapI18N is used.
es: La ordenación es importante aquí: ya que la mayoría de los módulos Locale::Po4a se cargan ellos mismos Locale::Po4a::Common, la primera vez que se carga el módulo determina si se usa Text::WrapI18N.

note: type: =head1
en: FUNCTIONS
es: FUNCIONES

note: type: =head2
en: Showing output messages
es: Muestra mensajes de salida

note: type: textblock
en: Shows the current version of the script, and a short copyright message. It takes the name of the script as an argument.
es: Muestra la versión actual del script, y un breve mensaje de derechos de autor. Toma el nombre del script como argumento.

note: type: textblock
en: This function displays a message the same way as sprintf() does, but wraps the result so that they look nice on the terminal.
es: Esta función muestra un mensaje de la misma manera que lo hace sprintf(), pero justifica el resultado para que se vea bien en la terminal.

note: type: textblock
en: This function works like wrap_msg(), but it takes a module name as the first argument, and leaves a space at the left of the message.
es: Esta función funciona como wrap_msg(), pero toma un nombre de módulo como primer argumento, y deja un espacio a la izquierda del mensaje.

note: type: textblock
en: This function works like wrap_msg(), but it takes a file:line reference as the first argument, a module name as the second one, and leaves a space at the left of the message.
es: Esta función funciona como wrap_msg(), pero toma una referencia fichero:línea como primer argumento, un nombre de módulo como segundo, y deja un espacio a la izquierda del mensaje.

note: type: =head2
en: Wrappers for other modules
es: Patrones de diseño («wrappers») para otros módulos

note: type: textblock
en: When the Locale::Gettext module cannot be loaded, this module provide dummy (empty) implementation of the following functions. In that case, po4a messages won't get translated but the program will continue to work.
es: Este módulo proporciona una integración vacía («dummy») de las siguientes funciones en caso de que no se pueda cargar el módulo Locale::Gettext. De ser así, los mensajes de po4a no se traducirán pero el programa seguirá funcionando.

note: type: textblock
en: If Locale::gettext is present, this wrapper also calls setlocale(LC_MESSAGES, "") so callers don't depend on the POSIX module either.
es: Si Locale::gettext está presente, este «wrapper» también invoca setlocale (LC_MESSAGES, ""), para que aquello que lo invoca tampoco dependa del módulo de POSIX.

note: type: textblock
en: Locale::Po4a::Dia - convert uncompressed Dia diagrams from/to PO files
es: Locale::Po4a::Dia - Convierte diagramas descomprimidos de Dia desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Dia is a module to help the translation of diagrams in the uncompressed Dia format into other [human] languages.
es: Locale::Po4a::Dia es un módulo que asiste en la traducción de diagramas en el formato Dia descomprimido a otros lenguajes (humanos).

note: type: verbatim
en: You can get Dia (the graphical editor for these diagrams) from:
      http://www.gnome.org/projects/dia/
es: Puede obtener Dia (el editor gráfico para éstos diagramas) en:
      http://www.gnome.org/projects/dia/

note: type: =head1
en: TRANSLATING WITH PO4A::DIA
es: TRADUCIR CON PO4A::DIA

note: type: textblock
en: This module only translates uncompressed Dia diagrams.  You can save your uncompressed diagrams with Dia itself, unchecking the "Compress diagram files" at the "Save Diagram" dialog.
es: Este módulo sólo traduce diagramas de Dia descomprimidos. Puede guardar sus diagramas descomprimidos directamente con Dia, desmarcando la opción «Comprimir ficheros del diagrama» en el diálogo «Guardar diagrama».

note: type: verbatim
en: Another way is to uncompress the dia files from command line with:
      gunzip < original.dia > uncompressed.dia
es: Otra manera es descomprimir los ficheros Dia desde la línea de órdenes con:
      gunzip < original.dia > descomprimido.dia

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags (E<lt>dia:stringE<gt>), and filters the internal strings (the content of the E<lt>dia:diagramdataE<gt> tag), not interesting for translation.
es: Este módulo es completamente funcional ya que se basa en el módulo L<Locale::Po4a::Xml>. Únicamente define las etiquetas traducibles (E<lt>dia:stringE<gt>), y filtra las cadenas internas (el contenido de la etiqueta E<lt>dia:diagramdataE<gt>) que no interesa traducir.

note: type: textblock
en: Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files
es: Locale::Po4a::Docbook - Convierte documentos DocBook XML desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Docbook is a module to help the translation of DocBook XML documents into other [human] languages.
es: Locale::Po4a::Docbook es un módulo que asiste en la traducción de documentación en formato DocBook XML a otros lenguajes (humanos).

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags and attributes.
es: Este módulo es completamente funcional, ya que se basa en el módulo L<Locale::Po4a::Xml>. Sólo define las etiquetas y atributos que se pueden traducir.

note: type: textblock
en: The only known issue is that it doesn't handle entities yet, and this includes the file inclusion entities, but you can translate most of those files alone (except the typical entities files), and it's usually better to maintain them separated.
es: El único problema conocido es que aún no trata las entidades, y eso incluye a las entidades de inclusión de ficheros, pero en la mayoría de casos puede traducir esos ficheros por separado (excepto los típicos ficheros de entidades), y generalmente es mejor mantenerlos separados.

note: type: =head2
en: OVERRIDE THE DEFAULT BEHAVIOR WITH COMMAND LINE OPTIONS
es: ANULACIÓN DEL COMPORTAMIENTO PREDEFINIDO CON OPCIONES DE LA LÍNEA DE ÓRDENES

note: type: textblock
en: The default behavior of system provided modules is set to be on the safe side.
es: El comportamiento predefinido de los módulos proporcionados por el sistema está ajustado para ofrecer un comportamiento prudente.

note: type: textblock
en: For example, the default of B<< <author> >> tag is aiming it to appear under B<< <para> >>.  But you may be using it only under B<< <bookinfo> >>.  For this case, you may want to translate it independently for each author.
es: Por ejemplo, el valor predefinido de la etiqueta B<< <author> >> está ajustado para aparecer bajo B<< <para> >>.  Pero puede que lo utilice solo bajo B<< <bookinfo> >>.  Para este caso, puede desear una traducción independiente para cada autor.

note: type: textblock
en: If you don't like the default behavior of the xml module and its derivative modules, you can provide command line options to change their behavior.  For example, you can add the following to the po4a configuration file:
es: Si no le satisface el comportamiento predefinido del módulo xml y sus módulos derivados, puede introducir opciones de la línea de órdenes para modificar su comportamiento. Por ejemplo, puede añadir lo siguiente al archivo de configuración de po4a:

note: type: textblock
en: This overrides the default behavior for B<< <bookinfo> >> and B<< <author> >>, set B<< <bookinfo> >> and B<< <author> >> to break input data stream on these tags, set B<< <bookinfo> >> not to translate its tagged content, and set B<< <author> >> to translate its tagged content.
es: Esto anula el comportamiento predefinido de B<< <bookinfo> >> y B<< <author> >>, define B<< <bookinfo> >> y B<< <author> >> para separar el flujo de datos de entrada en estas etiquetas, define B<< <bookinfo> >> para no traducir su contenido etiquetado, y define B<< <author> >> para traducir su contenido etiquetado.

note: type: textblock
en: Locale::Po4a::Guide - convert Guide XML documents from/to PO files
es: Locale::Po4a::Guide - Convierte documentos Guide XML desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Guide is a module to help in the translation of the Gentoo Linux documentation in the Guide XML format into other [human] languages.
es: Locale::Po4a::Guide es un módulo que asiste en la traducción de la documentación de Gentoo Linux en formato Guide XML a otros lenguajes (humanos).

note: type: textblock
en: This format is documented here: http://www.gentoo.org/doc/en/xml-guide.xml
es: Este formato está documentado en la siguiente dirección: http://www.gentoo.org/doc/en/xml-guide.xml

note: type: textblock
en: The only known issue is that it doesn't include files with the <include href="..."> tag, but you can translate all those files alone, and it's usually better to have them separated.
es: El único problema conocido es que no incluye ficheros con la etiqueta <include href="...">, pero puede traducir esos ficheros por separado, y generalmente es mejor mantenerlos separados.

note: type: textblock
en: Locale::Po4a::Halibut - convert Halibut documents and derivates from/to PO files
es: Locale::Po4a::Halibut - Convierte documentos Halibut y derivados de/a ficheros PO

note: type: textblock
en: Locale::Po4a::Halibut is a module to help the translation of Halibut documents into other [human] languages.
es: Locale::Po4a::Halibut es un módulo que asiste en la traducción de documentos Halibut a otros lenguajes (humanos).

note: type: textblock
en: This module contains the definitions of common Halibut commands and environments.
es: Este módulo contiene las definiciones de las órdenes y los entornos comunes de Halibut.

note: type: textblock
en: This module is still beta.  Please send feedback and feature requests.
es: Este módulo aún esta en un estado de desarrollo. Envíe comentarios y peticiones de características.

note: type: =head1
en: CAVEAT
es: ADVERTENCIA

note: type: textblock
en: Some constructs are badly supported. The known ones are documented below.
es: La compatibilidad con algunas constructos no es de calidad. A continuación están documentados aquellos conocidos.

note: type: =head2
en: Verbatim blocks
es: Grupos de caracteres literales

note: type: textblock
en: The verbatim block is not considered as a whole. Each line will be translated separately.
es: Los grupos de caracteres literales no se toman como un conjunto. Cada línea se traducirá por separado.

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL (see COPYING file).
es: Esto es software libre; puede redistribuirlo y/o modificarlo bajo las condiciones de la GPL (consulte el fichero COPYING).

note: type: textblock
en: Locale::Po4a::Ini - convert INI files from/to PO files
es: Locale::Po4a::Ini - Convierte ficheros INI desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Ini is a module to help the translation of INI files into other [human] languages.
es: Locale::Po4a::Ini es un módulo que asiste en la traducción de ficheros INI a otros lenguajes (humanos).

note: type: textblock
en: The module searches for lines of the following format and extracts the quoted text:
es: Este módulo busca líneas con el siguiente formato y extrae el texto entrecomillado:

note: type: textblock
en: identificator="text than can be translated"
es: identificator="este texto se puede traducir"

note: type: textblock
en: NOTE: If the text is not quoted, it will be ignored.
es: NOTA: Si no hay texto entre comillas, se ignorará.

note: type: textblock
en: Locale::Po4a::KernelHelp - convert kernel configuration help from/to PO files
es: Locale::Po4a::KernelHelp - Convierte la ayuda de configuración del núcleo desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::KernelHelp is a module to help the translation of documentation for the Linux kernel configuration options into other [human] languages.
es: Locale::Po4a::KernelHelp es un módulo que asiste en la traducción de la documentación de las opciones de configuración del núcleo de Linux a otros lenguajes (humanos).

note: type: textblock
en: This module is just written, and needs more tests. Most of the needed work will concern the tools used to parse this file (and configure the kernel), so that they accept to read the documentation from another (translated)  file.
es: Este módulo se escribió recientemente y necesita más pruebas. El trabajo más necesario tiene que ver con las herramientas que se utilizan para analizar estos ficheros (y configurar el núcleo), de forma que acepten la lectura de la documentación de otros ficheros (traducidos).

note: type: textblock
en: Locale::Po4a::LaTeX - convert LaTeX documents and derivates from/to PO files
es: Locale::Po4a::LaTeX - Convierte documentos LaTeX y derivados desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::LaTeX is a module to help the translation of LaTeX documents into other [human] languages. It can also be used as a base to build modules for LaTeX-based documents.
es: Locale::Po4a::LaTeX es un módulo que asiste en la traducción de documentos LaTeX a otros lenguajes (humanos). También se puede usar como base para construir módulos para documentos basados en LaTeX.

note: type: textblock
en: This module contains the definitions of common LaTeX commands and environments.
es: Este módulo contiene las definiciones de las órdenes y los entornos más habituales de LaTeX.

note: type: textblock
en: See the L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> manpage for the list of recognized options.
es: Consulte la página de manual L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> para una lista de las opciones reconocidas.

note: type: textblock
en: Locale::Po4a::Man - convert manual pages from/to PO files
es: Locale::Po4a::Man - Convierte páginas de manual desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Man is a module to help the translation of documentation in the nroff format (the language of manual pages) into other [human] languages.
es: Locale::Po4a::Man es un módulo que asiste en la traducción de documentación en formato nroff (el lenguaje de las páginas de manual) a otros lenguajes (humanos).

note: type: =head1
en: TRANSLATING WITH PO4A::MAN
es: TRADUCIR CON PO4A::MAN

note: type: textblock
en: This module tries pretty hard to make translator's life easier. For that, the text presented to translators isn't a verbatim copy of the text found in the man page. Indeed, the cruder parts of the nroff format are hidden, so that translators can't mess up with them.
es: Este módulo intenta facilitar la vida a los traductores. Para ello, el texto presentado a los traductores no es una copia exacta del texto encontrado en la página de manual. De hecho, las partes más crudas del formato nroff se ocultan de forma que los traductores no se líen con ellas.

note: type: =head2
en: Text wrapping
es: Justificación de texto

note: type: textblock
en: Unindented paragraphs are automatically rewrapped for the translator.  This can lead to some minor difference in the generated output, since the rewrapping rules used by groff aren't very clear. For example, two spaces after a parenthesis are sometimes preserved.
es: Los párrafos sin sangrado se justifican automáticamente para el traductor. Esto puede llevar a pequeñas diferencias en la salida generada, ya que las reglas de justificación usadas por groff no son muy claras. Por ejemplo, dos espacios después de un paréntesis se mantienen a veces.

note: type: textblock
en: Anyway, the difference will only be about the position of the extra spaces in wrapped paragraph, and I think it's worth.
es: De todas formas, la diferencia sólo será sobre la posición de los espacios adicionales en el párrafo justificado, y pienso que vale la pena.

note: type: =head2
en: Font specification
es: Especificación del tipo de letra

note: type: textblock
en: The first change is about font change specifications.  In nroff, there are several ways to specify if a given word should be written in small, bold or italics. In the text to translate, there is only one way, borrowed from the POD (Perl online documentation) format:
es: El primer cambio es sobre los cambios de la especificación del tipo de letra. En nroff hay varias formas de especificar si una palabra dada se debe escribir en pequeño, negrita o cursiva. En el texto a traducir hay solo una forma, tomada del formato POD (documentación en línea de Perl):

note: type: =item
en: IE<lt>textE<gt> -- italic text
es: IE<lt>textoE<gt> -- texto en cursiva

note: type: textblock
en: equivalent to \fItext\fP or ".I text"
es: equivale a \fItexto\fP o ".I text"

note: type: =item
en: BE<lt>textE<gt> -- bold text
es: BE<lt>textoE<gt> -- texto en negrita

note: type: textblock
en: equivalent to \fBtext\fP or ".B text"
es: equivale a \fBtexto\fP o ".B texto"

note: type: =item
en: RE<lt>textE<gt> -- roman text
es: RE<lt>textoE<gt> -- texto estándar

note: type: textblock
en: equivalent to \fRtext\fP
es: equivale a \fRtext\fP

note: type: =item
en: CWE<lt>textE<gt> -- constant width text
es: CWE<lt>textoE<gt> -- texto con ancho constante

note: type: textblock
en: equivalent to \f(CWtext\fP or ".CW text"
es: equivale a \f(CWtexto\fP o ".CW texto"

note: type: textblock
en: Remark: The CW face is not available for all groff devices. It is not recommended to use it. It is provided for your convenience.
es: Comentario: El tipo CW no está disponible en todos los dispositivos groff. Se recomienda no usarla, pero se proporciona para su comodidad.

note: type: =head2
en: Automatic characters transliteration
es: Transliteración automática de caracteres

note: type: textblock
en: Po4a automatically transliterate some characters to ease the translation or the review of the translation.  Here is the list of the transliterations:
es: Po4a realiza una transliteración automática de algunos caracteres para facilitar la traducción o revisión de una. Esta es una lista de los caracteres afectados por el proceso:

note: type: =item
en: hyphens
es: guiones

note: type: textblock
en: Hyphens (-) and minus signs (\-) in man pages are all transliterated as simple dashes (-) in the PO file.  Then all dash are transliterated into roff minus signs (\-) when the translation is inserted into the output document.
es: Los guiones (-) y signos de resta (\-) en las páginas de manual pasan a ser rayas simples (-) en el fichero PO. Entonces, todas las rayas sufren una transliteración, pasando a ser signos de resta (\-) cuando se inserta la traducción en el documento de salida.

note: type: textblock
en: Translators can force an hyphen by using the roff glyph '\[hy]' in their translations.
es: Los traductores pueden forzar el guión usando el glifo de roff '\[hy]' en sus traducciones.

note: type: =item
en: non-breaking spaces
es: espacios duros («non-breaking spaces»)

note: type: textblock
en: Translators can use non-breaking spaces in their translations.  These non-breaking spaces (0xA0 in latin1) will be transliterated into a roff non-breaking space ('\ ').
es: Los traductores pueden usar espacios duros en sus traducciones. Tras la transliteración, estos espacios duros (0xA0 en latin1) se convertirán en un espacio duro de roff ('\ ').

note: type: =item
en: quotes transliterations
es: las comillas en la transliteración

note: type: textblock
en: `` and '' are respectively tranliterated into \*(lq and \*(rq.
es: «``» y «''» pasan a ser «\*(lq» y «\*(rq», respectivamente, después de la transliteración.

note: type: textblock
en: To avoid these transliterations, translators can insert a zero width roff character (i.e., using `\&` or '\&' respectively).
es: Para evitar estas transliteraciones, los traductores pueden insertar un carácter de ancho cero de roff (p. ej., usando «`\&`» o «'\&'» respectivamente.

note: type: =head2
en: Putting 'E<lt>' and 'E<gt>' in translations
es: Introducir «E<lt>» y «E<gt>» en las traducciones

note: type: textblock
en: Since these chars are used to delimit parts under font modification, you can't use them verbatim. Use EE<lt>ltE<gt> and EE<lt>gtE<gt> instead (as in POD, one more time).
es: Ya que estos caracteres se usan para delimitar las partes bajo una modificación de tipo de letra, no puede usarlos literalmente. Use «EE<lt>ltE<gt>» y «EE<lt>gtE<gt>» en su lugar (una vez más, al igual que en POD).

note: type: textblock
en: Activate debugging for some internal mechanisms of this module.  Use the source to see which parts can be debugged.
es: 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.

note: type: textblock
en: Increase verbosity.
es: Aumenta el nivel de verbosidad.

note: type: textblock
en: This is the default value.  The module will fail when a .de, .ie or .if section is encountered.
es: Este es el valor predefinido. El módulo fallará cuando encuentre una sección .de, .ie o .if.

note: type: textblock
en: Indicates that the .de, .ie or .if sections must be copied as is from the original to the translated document.
es: Indica que las secciones .de, .ie y .if se deben copiar tal cual desde el original al documento traducido.

note: type: textblock
en: Indicates that the .de, .ie or .if sections will be proposed for the translation.  You should only use this option if a translatable string is contained in one of these section. Otherwise, I<verbatim> should be preferred.
es: Indica que las secciones .de, .ie y .if se propondrán para su traducción. Solo debería usar esta opción de existir una cadena traducible dentro de una de estas secciones. De no ser así, se debería usar I<verbatim>.

note: type: textblock
en: This option is only useful for mdoc pages.
es: Esta opción sólo es de utilidad con páginas mdoc.

note: type: textblock
en: It selects a stricter support of the mdoc format by telling po4a not to translate the 'NAME' section.  mdoc pages whose 'NAME' section is translated won't generate any header or footer.
es: Selecciona una compatibilidad más estricta del formato mdoc diciendo a po4a que no traduzca la sección «NAME». Las páginas mdoc cuya sección «NAME» está traducida no generarán cabecera ni pié de página alguna.

note: type: verbatim
en: According to the groff_mdoc page, the NAME, SYNOPSIS and DESCRIPTION
    sections are mandatory.
    There are no known issues with translated SYNOPSIS or DESCRIPTION section,
    but you can also specify these sections this way:
     -o mdoc=NAME,SYNOPSIS,DESCRIPTION
es: De acuerdo a la página groff_mdoc, las secciones «NAME», «SYNOPSIS» y
    «DESCRIPTION» son obligatorias.
    No hay problemas conocidos con las secciones «SYNOPSIS» y «DESCRIPTION»
    cuando están traducidas, pero también puede especificar estas secciones así:
    -o mdoc=NAME,SYNOPSIS,DESCRIPTION

note: type: verbatim
en: This mdoc issue can also be solved with an addendum like this one:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"
es: Este problema de mdoc se puede resolver también con un apéndice(«addendum») así:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"

note: type: textblock
en: Note: if a macro is not supported by po4a and if you consider that it is a standard roff macro, you should submit it to the po4a development team.
es: Nota: si una macro no es compatible con po4a, y considera que es una macro de roff estándar, debería enviarlo al equipo de desarrollo de po4a.

note: type: textblock
en: B<untranslated> indicates that this macro (at its arguments) don't have to be translated.
es: B<untranslated> indica que esta macro (en cuanto a sus argumentos) no precisan traducción.

note: type: textblock
en: B<noarg> is like B<untranslated>, except that po4a will verify that no argument is added to this macro.
es: B<noarg> es como B<untranslated>, a excepción de que po4a revisará que no se añada ningún argumento a esta macro.

note: type: textblock
en: B<translate_joined> indicates that po4a must propose to translate the arguments of the macro.
es: B<translate_joined> indica a po4a que proponga la traducción de los argumentos de la macro.

note: type: textblock
en: With B<translate_each>, the arguments will also be proposed for the translation, except that each one will be translated separately.
es: Con B<translate_each>, los argumentos se propondrán también para su traducción, sólo que se traducirá cada uno separadamente.

note: type: textblock
en: This option takes as argument a list of comma-separated couples I<begin>:I<end>, where I<begin> and I<end> are commands that delimit the begin and end of a section that should not be rewrapped.
es: Esta opción toma como argumento una lista de parejas separadas por comas I<begin>:I<end>, donde I<begin> y I<end> son órdenes que delimitan el principio y final de una sección que no se debería justificar.

note: type: textblock
en: This option specifies a list of comma-separated macros that must not split the current paragraph. The string to translate will then contain I<foo E<lt>.bar baz quxE<gt> quux>, where I<bar> is the command that should be inlined, and I<baz qux> its arguments.
es: Esta opción especifica una lista separada por comas de macros que no deben dividir el párrafo actual. La cadena a traducir contendrá I<foo E<lt>.bar baz quxE<gt> quux>, siendo I<bar> la orden que debería ser un elemento en línea, y I<baz qux> sus argumentos.

note: type: textblock
en: This option indicates how po4a should behave when an unknown macro is found.  By default, po4a fails with a warning.  It can take the following values: B<failed> (the default value), B<untranslated>, B<noarg>, B<translate_joined>, or B<translate_each> (see above for an explanation of these values).
es: Esta opción indica a po4a cómo actuar cuando encuentre una macro desconocida. Por omisión, po4a muestra un aviso cuando falla. Puede tomar los siguientes valores: B<failed> (el valor predefinido), B<untranslated>, B<noarg>, B<translate_joined> y B<translate_each> (véase en el punto anterior para una descripción de estos valores).

note: type: =head1
en: AUTHORING MAN PAGES COMPLIANT WITH PO4A::MAN
es: ESCRIBIR PÁGINAS DE MANUAL COMPATIBLES CON PO4A::MAN

note: type: textblock
en: This module is still very limited, and will always be, because it's not a real nroff interpreter. It would be possible to do a real nroff interpreter, to allow authors to use all the existing macros, or even to define new ones in their pages, but we didn't want to. It would be too difficult, and we thought it wasn't necessary. We do think that if manpages' authors want to see their productions translated, they may have to adapt to ease the work of translators.
es: Este módulo es muy limitado, y siempre lo será, debido a que no es un intérprete real de nroff. Sería posible hacer un intérprete real de nroff para permitir a los autores usar las macros existentes, o incluso definir macros nuevas en sus páginas, pero no quisimos. Sería demasiado difícil y no pensamos que fuera necesario. Opinamos que si los autores de las páginas de manual quieren ver su producción traducida, deben adaptarse para facilitar el trabajo de los traductores.

note: type: textblock
en: So, the man parser implemented in po4a have some known limitations we are not really inclined to correct, and which will constitute some pitfalls you'll have to avoid if you want to see translators taking care of your documentation.
es: Por lo tanto, el analizador de man implementado en po4a tiene algunas limitaciones conocidas que no tenemos en mente corregir, y que representan unos puntos débiles que deberá evitar si quiere que los traductores se interesen por su documentación.

note: type: =head2
en: Don't program in nroff
es: No programe en nroff

note: type: textblock
en: nroff is a complete programming language, with macro definition, conditionals and so on. Since this parser isn't a fully featured nroff interpreter, it will fail on pages using these facilities (There are about 200 such pages on my box).
es: nroff es un lenguaje de programación completo, con definiciones de macros, condicionales y todo eso. Como este analizador no es un analizador de nroff completo, fallará en páginas que utilicen esas partes (hay unas 200 páginas así en mi sistema).

note: type: =head2
en: Use the plain macro set
es: Utilice el juego de macros simples

note: type: textblock
en: There are still some macros which are not supported by po4a::man. This is only because I failed to find any documentation about them. Here is the list of unsupported macros used on my box. Note that this list isn't exhaustive since the program fails on the first encountered unsupported macro. If you have any information about some of these macros, I'll happily add support for them. Because of these macros, about 250 pages on my box are inaccessible to po4a::man.
es: Aún hay algunas macros no compatibles con po4a::man. Esto es porque no he conseguido encontrar documentación sobre ellas. Aquí hay una lista de las macros no soportadas usadas en mi máquina. Tenga en cuenta que la lista no es exhaustiva ya que el programa falla en la primera macro no soportada que encuentra. Si tiene alguna información sobre alguna de estas macros, intentaré añadir la compatibilidad. Debido a estas macros, hay unas 250 páginas en mi máquina no accesibles a po4a::man.

note: type: =head2
en: Hiding text from po4a
es: Ocultar texto a po4a

note: type: textblock
en: Sometimes, the author knows that some parts are not translatable, and should not be extracted by po4a. For example, an option may accept an I<other> argument, and I<other> may also appear as the last item of a list. In the first case, I<other> should be not be translatable. And in the second case, I<other> should be translated.
es: A veces, el autor sabe que hay partes no traducibles, las cuales po4a no debería extraer. Por ejemplo, una opción puede aceptar I<otro> argumento, y I<otro> puede también aparecer como el último elemento de una lista. En el primer caso, no se debería traducir I<otro>. Y en el segundo, I<otro> debería traducirse.

note: type: textblock
en: In such case, the author can avoid po4a to extract some strings, using some special groff constructs:
es: En tal caso, el autor puede evitar que po4a extraiga algunas cadenas usando algunos constructos especiales de groff:

note: type: verbatim
en:  .if !'po4a'hide' .B other
es:  .if !'po4a'ocultar' .B otro

note: type: textblock
en: (this will require the B<-o groff_code=verbatim> option)
es: (esto requiere la opción B<-o groff_code=verbatim>)

note: type: verbatim
en: A new macro can also be defined to automate this:
     .de IR_untranslated
     .    IR \\$@
     ..
es: También puede definir una nueva macro para automatizar ésto:
     .de IR_untranslated
     .    IR \\$@
     ..

note: type: textblock
en: (this will require the options B<-o groff_code=verbatim> and B<-o untranslated=IR_untranslated>; with this construct, the B<.if !'po4a'hide'> conditional is not strictly needed since po4a will not parse the internal of the macro definition)
es: (esto requiere las opciones B<-o groff_code=verbatim> y B<-o untranslated=IR_untranslated>; con este constructo, el condicional B<.if !'po4a'hide'> no es estrictamente necesario ya que po4a no analizará el interior de la definición de macro)

note: type: verbatim
en: or using an alias:
     .als IR_untranslated IR
es: o usando un alias
     .als IR_untranslated IR

note: type: textblock
en: This will require the B<-o untranslated=als,IR_untranslated> option.
es: Esto requiere la opción B<-o untranslated=als,IR_untranslated>.

note: type: =head2
en: Conclusion
es: Conclusión

note: type: textblock
en: To summarise this section, keep simple, and don't try to be clever while authoring your man pages. A lot of things are possible in nroff, and not supported by this parser. For example, don't try to mess with \c to interrupt the text processing (like 40 pages on my box do). Or, be sure to put the macro arguments on the same line that the macro itself. I know that it's valid in nroff, but would complicate too much the parser to be handled.
es: Para resumir esta sección, manténgase en lo simple, e intente no ser demasiado listo cuando escriba sus páginas de manual. nroff le permite hacer un montón de cosas que no están soportadas por este analizador. Por ejemplo, intente no trabajar con \c para interrumpir el procesado de texto (como hacen 40 páginas en mi máquina). O asegúrese de poner los parámetros de las macros en la misma línea que la macro en sí. Ya sé que nroff lo acepta, pero tratarlo añadiría complicaciones al analizador.

note: type: textblock
en: Of course, another possibility is to use another format, more translator friendly (like POD using po4a::pod, or one of the XML family like SGML), but thanks to po4a::man it isn't needed anymore. That being said, if the source format of your documentation is POD, or XML, it may be clever to translate the source format and not this generated one. In most cases, po4a::man will detect generated pages and issue a warning. It will even refuse to process POD generated pages, because those pages are perfectly handled by po4a::pod, and because their nroff counterpart defines a lot of new macros I didn't want to write support for. On my box, 1432 of the 4323 pages are generated from POD and will be ignored by po4a::man.
es: Por supuesto, otra posibilidad es usar otro formato, más amigable a los traductores (como POD usando po4a::pod, o uno de la familia de XMl, como SGML), pero gracias a po4a::man ya no los necesita. Una vez dicho esto, si el formato de origen de su documentación es POD o XML, debería interesarle más traducir el formato de origen y no el generado. En muchos casos, po4a::man detectará las páginas generadas y le informará. Incluso rechazará procesar las páginas generadas desde POD, ya que esas páginas se tratan a la perfección con po4a::pod, y porque la versión nroff define un montón de macros para las que no quería escribir la compatibilidad. En mi sistema, 1432 de las 4323 páginas son generadas a partir de POD, y se ignoran por po4a::man.

note: type: textblock
en: In most cases, po4a::man will detect the problem and refuse to process the page, issuing an adapted message. In some rare cases, the program will complete without warning, but the output will be wrong. Such cases are called "bugs" ;) If you encounter such case, be sure to report this, along with a fix when possible…
es: En la mayoría de casos, po4a::man detectará el problema y se negará a procesar la página, mostrando un mensaje adaptado. En algunos casos extraños, el programa terminará sin ningún aviso, pero la salida será mala. Estos casos se llaman fallos («bugs» ;) Si se encuentra con algún caso así, asegúrese de comunicarlo, además de enviar un arreglo cuando sea posible…

note: type: textblock
en: This module can be used for most of the existing man pages.
es: Este módulo se puede usar con la mayoría de páginas de manual existentes.

note: type: textblock
en: Some tests are regularly run on Linux boxes:
es: Algunas pruebas se realizan con regularidad en sistemas Linux:

note: type: textblock
en: one third of the pages are refused because they were generated from another format supported by po4a (e.g. POD or SGML).
es: Una tercera parte de las páginas se rechazan porque se generaron a partir de otro formato compatible con po4a (por ejemplo, POD o SGML).

note: type: textblock
en: 10% of the remaining pages are rejected with an error (e.g. a groff macro is not supported).
es: El 10% de las páginas restantes se rechazan con un error (por ejemplo, una macro de groff no es compatible).

note: type: textblock
en: Then, less than 1% of the pages are accepted silently by po4a, but with significant issues (i.e. missing words, or new words inserted)
es: Por último, po4a acepta sin problema aparentes menos del 1% de las páginas, pero con algunos asuntos de gravedad (por ejemplo, palabras omitidas, o inserción de nuevas palabras)

note: type: textblock
en: The other pages are usually handled without differences more important than spacing differences or line rewrapped (font issues in less than 10% of the processed pages).
es: Las otras páginas se tratan normalmente sin diferencias más importantes que la alteración del espaciado o el retorno automático de línea (con problemas de tipo de letra en menos del 10% de las páginas procesadas).

note: type: textblock
en: Locale::Po4a::Po - PO file manipulation module
es: Locale::Po4a::Po - Módulo para la manipulación de ficheros PO

note: type: verbatim
en:     # Read PO file
        $pofile->read('file.po');
es:     # Leer el fichero PO
        $pofile->read('fichero.po');

note: type: verbatim
en:     # Add an entry
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                      'flags' => "wrap", 'reference'=>'file.c:46');
es:     # Añadir una entrada
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'hola',
                      'flags' => "wrap", 'reference'=>'file.c:46');

note: type: verbatim
en:     # Extract a translation
        $pofile->gettext("Hello"); # returns 'bonjour'
es:     # Extraer una traducción
        $pofile->gettext("Hello"); # devuelve 'Hola'

note: type: verbatim
en:     # Write back to a file
        $pofile->write('otherfile.po');
es:     # Escribir el resultado en un fichero
        $pofile->write('otrofichero.po');

note: type: textblock
en: Locale::Po4a::Po is a module that allows you to manipulate message catalogs. You can load and write from/to a file (which extension is often I<po>), you can build new entries on the fly or request for the translation of a string.
es: Locale::Po4a::Po es un módulo que permite manipular catálogos de mensajes. Con él puede leer y escribir desde/a un fichero (cuya extensión es a menudo I<po>), puede crear nuevas entradas sobre en el momento o pedir la traducción de una cadena.

note: type: textblock
en: For a more complete description of message catalogs in the PO format and their use, please refer to the info documentation of the gettext program (node "`PO Files"').
es: Para una descripción más completa de los catálogos de mensajes en formato PO y su uso, consulte la documentación del programa gettext (nodo "`PO Files"').

note: type: textblock
en: This module is part of the po4a project, which objective is to use PO files (designed at origin to ease the translation of program messages) to translate everything, including documentation (man page, info manual), package description, debconf templates, and everything which may benefit from this.
es: Este módulo es parte del proyecto po4a, cuyo objetivo es usar ficheros PO (diseñados originalmente para facilitar la traducción de mensajes de programa) para traducir de todo, incluyendo documentación (páginas de manual, manuales info), descripciones de paquetes, plantillas debconf, y cualquier cosa que se pueda beneficiar de esto.

note: type: =head1
en: Functions concerning entire message catalogs
es: Funciones pertinentes a todo el catálogo de mensajes

note: type: textblock
en: Creates a new message catalog. If an argument is provided, it's the name of a PO file we should load.
es: Crea un nuevo catálogo de mensajes. Si se introduce un argumento, este será el nombre del fichero PO a cargar.

note: type: textblock
en: Reads a PO file (which name is given as argument).  Previously existing entries in self are not removed, the new ones are added to the end of the catalog.
es: Lee un fichero PO (cuyo nombre se introduce como argumento). Las entradas anteriormente existentes no se eliminan, las nuevas se añaden al final del catálogo.

note: type: textblock
en: Writes the current catalog to the given file.
es: Escribe el catálogo actual al fichero dado.

note: type: textblock
en: Like write, but if the PO or POT file already exists, the object will be written in a temporary file which will be compared with the existing file to check if the update is needed (this avoids to change a POT just to update a line reference or the POT-Creation-Date field).
es: Al igual que «write», pero si el archivo PO o POT ya existe, el objeto se escribirá en un archivo temporal para su comparación con el fichero existente, y así determinar si precisa una actualización (esto evita modificar el POT para sólo actualizar una línea de referencia o el campo «POT-Creation-Date»).

note: type: textblock
en: This function extracts a catalog from an existing one. Only the entries having a reference in the given file will be placed in the resulting catalog.
es: Esta función extrae un catálogo desde uno existente. Sólo se colocan en el catálogo resultante las entradas que tengan una referencia en el fichero dado.

note: type: textblock
en: This function parses its argument, converts it to a Perl function definition, evals this definition and filters the fields for which this function returns true.
es: Esta función analiza su argumento, lo convierte en una definición de una función de Perl, la pasa por «eval» y filtra los campos por los que esta función devuelve verdadero («true»).

note: type: textblock
en: I love Perl sometimes ;)
es: A veces me encanta Perl ;)

note: type: textblock
en: Recodes to UTF-8 the PO's msgstrs. Does nothing if the charset is not specified in the PO file ("CHARSET" value), or if it's already UTF-8 or ASCII.
es: Recodifica los msgtr del PO a UTF-8. No hace nada si el juego de caracteres no está especificado en el fichero PO (valor «CHARSET»), o si ya está en UTF-8 o ASCII.

note: type: =head1
en: Functions to use a message catalog for translations
es: Funciones para usar un catálogo de mensajes para traducciones

note: type: textblock
en: Request the translation of the string given as argument in the current catalog.  The function returns the original (untranslated) string if the string was not found.
es: Solicita la traducción de la cadena dada como argumento en el catálogo actual. La función devuelve la cadena original (sin traducir) si no se ha encontrado la cadena.

note: type: textblock
en: After the string to translate, you can pass a hash of extra arguments. Here are the valid entries:
es: Después de la cadena a traducir, puede pasar una serie asociativa («hash») de argumentos adicionales. Aquí están las entradas válidas:

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation, and wraps the result.
es: Booleano que indica si se puede considerar que los espacios blancos de la cadena son irrelevantes. De ser así, la función canoniza la cadena antes de buscar su traducción, y justifica el resultado.

note: type: textblock
en: the column at which we should wrap (default: 76).
es: La columna en la que se debe hacer el salto de línea (por omisión: 76).

note: type: textblock
en: Returns statistics about the hit ratio of gettext since the last time that stats_clear() was called. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's statistics about recent usage of the PO file, while msgfmt reports the status of the file.  Example of use:
es: Devuelve estadísticas sobre la tasa de aciertos de gettext desde la última vez que se invocó «stats_clear()». Cabe destacar que éstas no son las mismas estadísticas que muestra «msgfmt --statistic». Estas son sobre el uso reciente del fichero PO, mientras que msgfmt informa del estado del fichero. Ejemplo de uso:

note: type: verbatim
en:     [some use of the PO file to translate stuff]
es:     [algún uso del fichero PO para traducir cosas]

note: type: verbatim
en:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "So far, we found translations for $percent\%  ($hit of $queries) of strings.\n";
es:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "Hasta el momento hemos encontrado traducciones para el $percent\%  ($hit of $queries) de cadenas.\n";

note: type: textblock
en: Clears the statistics about gettext hits.
es: Limpia las estadísticas de aciertos de gettext.

note: type: =head1
en: Functions to build a message catalog
es: Funciones para construir un catálogo de mensajes

note: type: textblock
en: Push a new entry at the end of the current catalog. The arguments should form a hash table. The valid keys are:
es: Inserta una nueva entrada al final del catálogo actual. Los argumentos deberían formar una tabla de elementos asociativos («hash»). Las claves válidas son:

note: type: textblock
en: the string in original language.
es: La cadena en el idioma original.

note: type: textblock
en: the translation.
es: La traducción.

note: type: textblock
en: an indication of where this string was found. Example: file.c:46 (meaning in 'file.c' at line 46). It can be a space-separated list in case of multiple occurrences.
es: Una indicación de dónde se encontró la cadena. Ejemplo: «fichero.c:46» (significa en la línea 46 del 'fichero.c'). Puede ser una lista separada por espacios en caso de múltiples apariciones.

note: type: textblock
en: a comment added here manually (by the translators). The format here is free.
es: Un comentario añadido aquí manualmente (por los traductores). El formato aquí es libre.

note: type: textblock
en: a comment which was automatically added by the string extraction program. See the B<--add-comments> option of the B<xgettext> program for more information.
es: Un comentario que añadió automáticamente el programa de extracción de cadenas. Consulte la opción B<--add-comments> del programa B<xgettext> para más información.

note: type: textblock
en: space-separated list of all defined flags for this entry.
es: Lista separada por espacios de todas la marcas («flags») definidas para ésta entrada.

note: type: textblock
en: Valid flags are: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> and B<fuzzy>.
es: Las marcas válidas son: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> y B<fuzzy>.

note: type: textblock
en: See the gettext documentation for their meaning.
es: Consulte la documentación de gettext para conocer sus significados.

note: type: textblock
en: this is mostly an internal argument: it is used while gettextizing documents. The idea here is to parse both the original and the translation into a PO object, and merge them, using one's msgid as msgid and the other's msgid as msgstr. To make sure that things get ok, each msgid in PO objects are given a type, based on their structure (like "chapt", "sect1", "p" and so on in DocBook). If the types of strings are not the same, that means that both files do not share the same structure, and the process reports an error.
es: Este es principalmente un parámetro interno: se usa cuando se gettextizan documentos. La idea aquí es analizar el original y la traducción en un objeto PO, y fusionarlos, usando el msgid de uno como msgid y el msgid del otro como msgstr. Para asegurarnos de que todo va bien, a cada msgid de los objetos PO se le da un tipo, basado en su estructura (como «chapt», «sect1», «p» y demás en DocBook). Si los tipos de las cadenas no coinciden, significa que ambos ficheros no tienen la misma estructura, y el proceso devuelve un error.

note: type: textblock
en: This information is written as automatic comment in the PO file since this gives to translators some context about the strings to translate.
es: Esta información se escribe como un comentario automático en el fichero PO, ya que informa al traductor del contexto de la cadena a traducir.

note: type: textblock
en: boolean indicating whether whitespaces can be mangled in cosmetic reformattings. If true, the string is canonized before use.
es: Booleano que indica si los espacios en blanco se pueden manipular en reformateos cosméticos. Si es verdadero, la cadena se canoniza antes de su uso.

note: type: textblock
en: This information is written to the PO file using the B<wrap> or B<no-wrap> flag.
es: Esta información se escribe en el fichero PO usando las marcas B<wrap> o B<no-wrap>.

note: type: textblock
en: This information is not written to the PO file.
es: Esta información no se escribe en el fichero PO.

note: type: =head1
en: Miscellaneous functions
es: Funciones varias

note: type: textblock
en: Returns the number of entries in the catalog (without the header).
es: Devuelve el número de entradas del catálogo (sin la cabecera).

note: type: textblock
en: Returns the number of entries in document. If a string appears multiple times in the document, it will be counted multiple times.
es: Devuelve el número de entradas del documento. Si una cadena aparece varias veces en el documento, se contará varias veces.

note: type: textblock
en: Returns the msgid of the given number.
es: Devuelve el msgid con el número dado.

note: type: textblock
en: Returns the msgid with the given position in the document.
es: Devuelve el msgid y su posición en el documento.

note: type: textblock
en: Returns the character set specified in the PO header. If it hasn't been set, it will return "UTF-8".
es: Devuelve el juego de caracteres especificado en la cabecera PO. Si no se le ha dado valor, devuelve «UTF-8».

note: type: textblock
en: This sets the character set of the PO header to the value specified in its first argument. If you never call this function (and no file with a specified character set is read), the default value is left to "UTF-8". This value doesn't change the behavior of this module, it's just used to fill that field in the header, and to return it in get_charset().
es: Esto define el juego de caracteres de la cabecera PO con el valor especificado en su primer argumento. Si nunca invoca esta función (y no se carga ningún fichero con un juego de caracteres especificado), el valor predefinido es «UTF-8». Este valor no cambia el comportamiento del módulo, simplemente se usa para llenar el campo de la cabecera, y para devolverlo en «get_charset()».

note: type: textblock
en: Locale::Po4a::Pod - convert POD data from/to PO files
es: Locale::Po4a::Pod - Convierte datos POD desde/a ficheros PO

note: type: verbatim
en:     # Read POD from STDIN and write to STDOUT.
        $parser->parse_from_filehandle;
es:     # Lee el POD por la entrada estándar y escribe por la salida estándar.
        $parser->parse_from_filehandle;

note: type: verbatim
en:     # Read POD from file.pod and write to file.txt.
        $parser->parse_from_file ('file.pod', 'file.txt');
es:     # Lee POD desde «fichero.pod» y escribe en «fichero.txt».
        $parser->parse_from_file ('fichero.pod', 'fichero.txt');

note: type: textblock
en: Locale::Po4a::Pod is a module to help the translation of documentation in the POD format (the preferred language for documenting Perl) into other [human] languages.
es: Locale::Po4a::Pod es un módulo que asiste en la traducción de documentación en formato POD (el lenguaje preferido para documentar Perl) a otros lenguajes (humanos).

note: type: textblock
en: I think that this module is rock stable, and there is only one known bug with F</usr/lib/perl5/Tk/MainWindow.pod> (and some other pages, see below) which contains:
es: Opino que este módulo es muy estable, y sólo hay un fallo conocido con F</usr/lib/perl5/Tk/MainWindow.pod> (y algunas otras páginas, consulte más abajo) que contiene:

note: type: textblock
en: Lack of luck, in the po4a version, this was split on the space by the wrapping. As result, in the original version, the man page contains
es: Mala suerte, en la versión de po4a esto se separó en el espacio debido al justificado. Como resultado, en la versión original la página de manual contiene

note: type: textblock
en: and mine contains
es: y el mio contiene

note: type: textblock
en: which is logic since CE<lt>foobarE<gt> is rewritten "foobar".
es: lo cual es lógico ya que CE<lt>foobarE<gt> se reescribe como "foobar".

note: type: textblock
en: Complete list of pages having this problem on my box (from 564 pages; note that it depends on the chosen wrapping column): /usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod
es: La lista completa de las páginas que dan este problema en mi máquina (de 564 páginas; observe que esto depende de la puntuación elegida para el justificado): /usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod

note: type: =head1
en: INTERNALS
es: FUNCIONAMIENTO INTERNO

note: type: textblock
en: As a derived class from Pod::Parser, Locale::Po4a::Pod supports the same methods and interfaces.  See L<Pod::Parser> for all the details; briefly, one creates a new parser with C<< Locale::Po4a::Pod->new() >> and then calls either parse_from_filehandle() or parse_from_file().
es: Como clase derivada de Pod::Parser, Locale::Po4a::Pod es compatible con los mismos métodos e interfaces. Consulte L<Pod::Parser> para más detalles; brevemente, uno crea un nuevo analizador con C<< Locale::Po4a::Pod->new() >> y luego invoca «parse_from_filehandle()» o bien «parse_from_file()».

note: type: textblock
en: new() can take options, in the form of key/value pairs, that control the behavior of the parser.  The recognized options common to all Pod::Parser children are:
es: new() puede tomar opciones, en forma de pares llave/valor, que controlan el comportamiento del analizador. Las opciones comunes reconocidas por todos los hijos de Pod::Parser son:

note: type: textblock
en: If set to a true value, selects an alternate output format that, among other things, uses a different heading style and marks B<=item> entries with a colon in the left margin.  Defaults to false.
es: Si tiene un valor verdadero («true»), selecciona un formato alternativo de salida que, entre otras cosas, utiliza un estilo de cabecera diferente y marca las entradas B<=item> con dos puntos en el margen izquierdo. Falso por omisión.

note: type: textblock
en: If set to a true value, the non-POD parts of the input file will be included in the output.  Useful for viewing code documented with POD blocks with the POD rendered and the code left intact.
es: Si tiene un valor verdadero, las partes no POD del fichero de entrada se incluirán en la salida. Esto es útil para visualizar código documentado con bloques POD, con el POD tratado y el código dejado intacto.

note: type: textblock
en: The number of spaces to indent regular text, and the default indentation for B<=over> blocks.  Defaults to 4.
es: El número de espacios con el que sangrar texto regular, y el sangrado por omisión de los bloques B<=over>. Por omisión vale 4.

note: type: textblock
en: If set to a true value, a blank line is printed after a B<=head1> heading.  If set to false (the default), no blank line is printed after B<=head1>, although one is still printed after B<=head2>.  This is the default because it's the expected formatting for manual pages; if you're formatting arbitrary text documents, setting this to true may result in more pleasing output.
es: Si toma valor verdadero, se imprime una línea en blanco después de las cabeceras B<=head1>. De ser falso (predefinido), no se imprimen líneas en blanco después de B<=head1>, pero sí después de B<=head2>. Este es el comportamiento predefinido porque éste es el formato esperado para las páginas de manual; si está formateando documentos de texto arbitrario, introducir ésta opción puede resultar en una salida más agradable.

note: type: textblock
en: Sets the quote marks used to surround CE<lt>> text.  If the value is a single character, it is used as both the left and right quote; if it is two characters, the first character is used as the left quote and the second as the right quote; and if it is four characters, the first two are used as the left quote and the second two as the right quote.
es: Ajusta las marcas de cita CE<lt>> alrededor del texto. Si el valor es un único carácter, se utilizará para las marcas izquierda y derecha; si son dos caracteres, se utilizará el primero para la marca izquierda, y el segundo para la derecha; y si son cuatro caracteres, los dos primeros se utilizarán como marca izquierda, y los dos últimos como marca derecha.

note: type: textblock
en: This may also be set to the special value B<none>, in which case no quote marks are added around CE<lt>> text.
es: También se le puede dar el valor especial B<none>, en cuyo caso no se añadirán comillas alrededor del texto CE<lt>>.

note: type: textblock
en: If set to a true value, Locale::Po4a::Pod will assume that each sentence ends in two spaces, and will try to preserve that spacing.  If set to false, all consecutive whitespace in non-verbatim paragraphs is compressed into a single space.  Defaults to true.
es: Si se define como verdadero, Locale::Po4a::Pod asumirá que cada frase termina con dos espacios e intentará preservar éste espaciado. Si se define como falso, todos los espacios consecutivos encontrados en un párrafo que no se deba mantener tal cual se comprimirán a un único espacio. Por omisión tiene valor verdadero.

note: type: textblock
en: The column at which to wrap text on the right-hand side.  Defaults to 76.
es: La columna a la cual se justifica el texto en el lado derecho. Por omisión tiene un valor de 76.

note: type: textblock
en: Locale::Po4a::Sgml - convert SGML documents from/to PO files
es: Locale::Po4a::Sgml - Convierte documentos SGML desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Sgml is a module to help the translation of documentation in the SGML format into other [human] languages.
es: Locale::Po4a::Sgml es un módulo que asiste en la traducción de documentación en formato SGML a otros lenguajes (humanos).

note: type: textblock
en: This module uses B<onsgmls>(1) to parse the SGML files. Make sure it is installed.  Also make sure that the DTD of the SGML files are installed in the system.
es: Este módulo usa B<onsgmls>(1) para analizar los ficheros SGML. Asegúrese de que está instalado. Asegúrese también de que el DTD de los ficheros SGML están instalados en el sistema.

note: type: textblock
en: Space separated list of keywords indicating which part you want to debug. Possible values are: tag, generic, entities and refs.
es: Es una lista de palabras clave separadas por espacios que indican qué partes se quieren depurar. Los valores posibles son: «tag», «generic», «entities» y «refs».

note: type: textblock
en: Give more information about what's going on.
es: Muestra más información sobre qué está pasando.

note: type: textblock
en: Space separated list of extra tags (beside the DTD provided ones) whose content should form an extra msgid.
es: Lista de etiquetas («tags») adicionales separados por espacios (aparte de los proporcionados por DTD) cuyo contenido debe generar un msgid adicional.

note: type: textblock
en: Space separated list of extra tags (beside the DTD provided ones)  containing other tags, some of them being of category B<translate>.
es: Lista separada por espacios de las etiquetas adicionales (aparte de los proporcionados por el DTD) que pueden contener otras etiquetas, algunos de los cuales pueden ser de la categoría B<translate>.

note: type: textblock
en: Space separated list of tags which increase the indentation level.
es: Lista de todas las etiquetas que aumentan el nivel de sangrado, separadas por espacios.

note: type: textblock
en: The layout within those tags should not be changed. The paragraph won't get wrapped, and no extra indentation space or new line will be added for cosmetic purpose.
es: La organización del contenido de estas etiquetas no se debe cambiar. El párrafo no se justificará ni se añadirán espacios de sangrado ni saltos de línea por motivos estéticos.

note: type: textblock
en: Tags not needing to be closed.
es: Etiquetas que no necesitan cierre.

note: type: textblock
en: Tags ignored and considered as plain char data by po4a. That is to say that they can be part of an msgid. For example, E<lt>bE<gt> is a good candidate for this category since putting it in the translate section would create msgids not being whole sentences, which is bad.
es: Las etiquetas ignoradas y consideradas por po4a como datos de caracteres sencillos. Esto significa que pueden ser parte de un msgid. Por ejemplo, E<lt>bE<gt> es un buen candidato para esta categoría ya que añadirlo en la sección «translate» crearía unos msgid que no serían la frase completa, lo cual no es recomendable.

note: type: textblock
en: A space separated list of attributes that need to be translated. You can specify the attributes by their name (for example, "lang"), but you can also prefix it with a tag hierarchy, to specify that this attribute will only be translated when it is into the specified tag. For example: E<lt>bbbE<gt>E<lt>aaaE<gt>lang specifies that the lang attribute will only be translated if it is in an E<lt>aaaE<gt> tag, which is in a E<lt>bbbE<gt> tag.  The tag names are actually regular expressions so you can also write things like E<lt>aaa|bbbbE<gt>lang to only translate lang attributes that are in an E<lt>aaaE<gt> or a E<lt>bbbE<gt> tag.
es: Lista separada por espacios de los atributos que necesita traducir. Puede especificar los atributos por su nombre (por ejemplo, «lang»), pero puede añadirle como prefijo una jerarquía de etiquetas para especificar que esta etiqueta sólo se debe traducir cuando esté dentro de la etiqueta especificada. Por ejemplo: E<lt>bbbE<gt>E<lt>aaaE<gt>lang indica que el atributo «lang» sólo se traducirá cuando esté dentro de la etiqueta E<lt>aaaE<gt>, y éste esté dentro de una etiqueta E<lt>bbbE<gt>. Los nombres de las etiquetas son, generalmente, expresiones regulares que le permiten escribir cosas tales como E<lt>aaa|bbbbE<gt>lang sólo para traducir atributos de «lang» que están dentro de una etiqueta E<lt>aaaE<gt> o E<lt>bbbE<gt>.

note: type: textblock
en: A space separated list of attributes for which the translation must be qualified by the attribute name. Note that this setting automatically adds the given attribute into the 'attributes' list too.
es: Lista de elementos separados por espacios de los atributos, para los que la traducción se debe calificar por el nombre de atributo. Observe que definir esto automáticamente también añade el atributo en la lista de 'attributes'.

note: type: textblock
en: Proceed even if the DTD is unknown or if onsgmls finds errors in the input file.
es: Procede aunque se desconozca el DTD o si onsgmls encuentra errores en el fichero de entrada.

note: type: textblock
en: By default, msgids containing only one entity (like '&version;') are skipped for the translator comfort. Activating this option prevents this optimisation. It can be useful if the document contains a construction like "<title>&Aacute;</title>", even if I doubt such things to ever happen...
es: Por omisión, los msgid que contienen solamente una entidad (por ejemplo '&version;') se obvian, para comodidad de los traductores. Evitará esta optimización si activa ésta opción. Puede ser útil si el documento contiene una construcción como «<title>&Aacute;</title>», aunque dudo que nunca pase algo así...

note: type: textblock
en: Space separated list of entities that won't be inlined.  Use this option with caution: it may cause onsgmls (used internally) to add tags and render the output document invalid.
es: Lista de entidades separadas por espacios que no se tratarán como elementos en línea. Use esta opción con cuidado: puede causar que onsgmls (usado internamente) añada etiquetas, y por ello dejar sin valor el documento de salida.

note: type: textblock
en: The result is perfect. I.e., the generated documents are exactly the same. But there are still some problems:
es: El resultado es perfecto. Es decir, los documentos generados son idénticos. A pesar de todo aún hay algunos problemas:

note: type: textblock
en: The error output of onsgmls is redirected to /dev/null by default, which is clearly bad. I don't know how to avoid that.
es: La salida de error de nsgmls se redirige a «/dev/null» de forma predefinida, lo cual es claramente negativo. No sé como evitarlo.

note: type: textblock
en: The problem is that I have to "protect" the conditional inclusions (i.e. the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) from onsgmls. Otherwise onsgmls eats them, and I don't know how to restore them in the final document. To prevent that, I rewrite them to C<{PO4A-beg-foo}> and C<{PO4A-end}>.
es: El problema es que debo «proteger» la inclusión condicional (p. ej., las cosas como C<E<lt>! [ %blah [> y C<]]E<gt>>) de onsgmls, porque si no, onsgmls se lo come, y no sé como restaurarlo en el documento final. Para evitarlo, lo reescribo como C<{PO4A-beg-blah}> y C<{PO4A-end}>.

note: type: textblock
en: The problem with this is that the C<{PO4A-end}> and such I add are invalid in the document (not in a E<lt>pE<gt> tag or so).
es: El problema con esto es que C<{PO4A-end}> y otros que añado no son válidos en el documento (pero no en una etiqueta E<lt>pE<gt> o similar).

note: type: textblock
en: If you want to view the onsgmls output, just add the following to your command line (or po4a configuration line):
es: Si desea observar la salidad de onsgmls, simplemente añada lo siguiente a la línea de órdenes (o fichero de configuración de po4a):

note: type: textblock
en: It does work only with the DebianDoc and DocBook DTD. Adding support for a new DTD should be very easy. The mechanism is the same for every DTD, you just have to give a list of the existing tags and some of their characteristics.
es: Esto sólo funciona con DebianDoc y DocBook DTD. Añadir compatibilidad para un nuevo DTD debería ser muy fácil. El mecanismo es común para todos los DTD, sólo tiene que dar una lista de las etiquetas existentes y algunas de sus características.

note: type: textblock
en: I agree, this needs some more documentation, but it is still considered as beta, and I hate to document stuff which may/will change.
es: Estoy de acuerdo, esto necesita un poco más de documentación, pero aún se considera beta, y odio documentar cosas que probablemente cambiarán.

note: type: textblock
en: Warning, support for DTDs is quite experimental. I did not read any reference manual to find the definition of every tag. I did add tag definition to the module 'till it works for some documents I found on the net. If your document use more tags than mine, it won't work. But as I said above, fixing that should be quite easy.
es: Advertencia: la compatibilidad con DTD es aún experimental. No leí ningún manual de referencia para mirar la definición de cada etiqueta. Fui añadiendo definiciones de etiquetas al módulo hasta que funcionaba para varios documentos que encontré en la red. Si su documento utiliza más etiquetas que el mío, no funcionará. Pero tal y como he dicho, arreglar esto debe ser muy fácil.

note: type: textblock
en: I did test DocBook against the SAG (System Administrator Guide) only, but this document is quite big, and should use most of the DocBook specificities.
es: Sólo probé DocBook con SAG (System Administrator Guide, Guia del administrador de sistemas), pero este documento es muy grande, y debe usar la mayoría de las características específicas de DocBook.

note: type: textblock
en: For DebianDoc, I tested some of the manuals from the DDP, but not all yet.
es: Para DebianDoc, he probado algunos de los manuales de DDP, pero no todos aún.

note: type: textblock
en: In case of file inclusion, string reference of messages in PO files (i.e. lines like C<#: en/titletoc.sgml:9460>) will be wrong.
es: En el caso de inclusión de ficheros, la cadena de referencia del mensaje del fichero PO (p.e., líneas como C<#: en/titletoc.sgml:9460>) serán incorrectas.

note: type: textblock
en: This is because I preprocess the file to protect the conditional inclusion (i.e. the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) and some entities (like &version;) from onsgmls because I want them verbatim to the generated document. For that, I make a temp copy of the input file and do all the changes I want to this before passing it to onsgmls for parsing.
es: Esto es debido a que proceso el fichero para proteger la inclusión condicional (p. ej., las cosas como C<E<lt>! [ %blah [> y C<]]E<gt>>) y algunas entidades (como &version;) de onsgmls porque lo quiero igual en el documento generado. Por eso hago una copia temporal del fichero de entrada y hago todos los cambios que quiero en éste antes de pasarlo por onsgmls para su análisis.

note: type: textblock
en: So that it works, I replace the entities asking for a file inclusion by the content of the given file (so that I can protect what needs to be in a subfile also). But nothing is done so far to correct the references (i.e., filename and line number) afterward. I'm not sure what the best thing to do is.
es: Para que esto funcione, reemplazo las entidades que incluyen un fichero con el contenido del fichero dado (de forma que puedo proteger lo que convenga del subfichero también). Pero por ahora no se hace nada para corregir las referencias después (p. ej., nombre de fichero y número de línea). No estoy seguro de cuál es la mejor solución.

note: type: textblock
en: This module is an adapted version of sgmlspl (SGML postprocessor for the ONSGMLS parser) which was:
es: Este módulo es una versión adaptada de sgmlspl (postprocesador SGML para los analizadores SGMLS y ONSGMLS) que hizo:

note: type: textblock
en: The adaptation for po4a was done by:
es: La adaptación a po4a la realizó:

note: type: textblock
en: Locale::Po4a::TeX is a module to help the translation of TeX documents into other [human] languages. It can also be used as a base to build modules for TeX-based documents.
es: 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.

note: type: textblock
en: Users should probably use the LaTeX module, which inherits from the TeX module and contains the definitions of common LaTeX commands.
es: 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.

note: type: =head1
en: TRANSLATING WITH PO4A::TEX
es: TRADUCIR CON PO4A::TEX

note: type: textblock
en: This module can be used directly to handle generic TeX documents.  This will split your document in smaller blocks (paragraphs, verbatim blocks, or even smaller like titles or indexes).
es: 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).

note: type: textblock
en: Comma-separated list of environments which should not be re-wrapped.
es: Lista separada por comas de los entornos que no se deben justificar.

note: type: textblock
en: Note that there is a difference between verbatim and no_wrap environments.  There is no command and comments analysis in verbatim blocks.
es: 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.

note: type: textblock
en: If this environment was not already registered, po4a will consider that this environment does not take any parameters.
es: Si este entorno no se registró ya, po4a considerará que este entorno no acepta ningún argumento.

note: type: textblock
en: Colon-separated list of files that should not be included by \input and \include.
es: Lista separada por dos puntos de los ficheros que no se deben incluir mediante «\input» e «\include».

note: type: textblock
en: Comma-separated list of environments which should be taken as verbatim.
es: Lista separada por comas de los entornos que no se deben justificar.

note: type: textblock
en: The TeX module can be customized with lines starting by B<% po4a:>.  These lines are interpreted as commands to the parser.  The following commands are recognized:
es: 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:

note: type: =item
en: B<% po4a: command> I<command1> B<alias> I<command2>
es: B<% po4a: command> I<orden1> B<alias> I<orden2>

note: type: textblock
en: Indicates that the arguments of the I<command1> command should be treated as the arguments of the I<command2> command.
es: Indica que los argumentos de la orden I<orden1> se deben tratar como los argumentos de la orden I<orden2>.

note: type: =item
en: B<% po4a: command> I<command1> I<parameters>
es: B<% po4a: command> I<orden1> I<parámetros>

note: type: textblock
en: You can precede the I<command1> command by
es: Puede preceder la orden I<orden1> con

note: type: =item
en: an asterisk (B<*>)
es: un asterisco (B<*>)

note: type: textblock
en: po4a will extract this command from paragraphs (if it is located at the beginning or the end of a paragraph).  The translators will then have to translate the parameters that are marked as translatable.
es: 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.

note: type: =item
en: a plus (B<+>)
es: un signo de suma (B<+>)

note: type: textblock
en: Note: In this case you don't have to specify which parameters are translatable, but po4a must know the type and number of parameters.
es: Nota: En este caso, no necesita especificar qué argumentos son traducibles, pero po4a debe conocer el tipo y número de argumentos.

note: type: =item
en: a minus (B<->)
es: un signo de resta (B<->)

note: type: textblock
en: In this case, the command won't be extracted from any block.  But if it appears alone on a block, then only the parameters marked as translatable will be presented to the translator.  This is useful for font commands.  These commands should generally not be separated from their paragraph (to keep the context), but there is no reason to annoy the translator with them if a whole string is enclosed in such a command.
es: 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.

note: type: verbatim
en: 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 [_]{_}
es: El argumento I<parámetros> es un conjunto de [] (para indicar un argumento
    opcional) o {} (para indicar un argumento obligatorio).
    Puede colocar un subrayado (_) entre estos corchetes para indicar que el
    parámetro se debe traducir. Por ejemplo:
     % po4a: orden *chapter [_] {_}

note: type: verbatim
en: 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 {}{_}
es: Esto indica que la orden «chapter» tiene dos parámetros: uno opcional
    (título corto) y uno obligatorio, los cuales se deben traducir.
    Si desea especificar que la orden «href» tiene dos parámetros obligatorios,
    que no quiere traducir la dirección URL (primer parámetro), y que no quiere
    que se separe esta orden de su párrafo (lo cual permite al traductor
    desplazar el enlace en la oración), puede usar:
     % po4a: command -href {}{_}

note: type: textblock
en: In this case, the information indicating which arguments must be translated is only used if a paragraph is only composed of this href command.
es: 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».

note: type: =item
en: B<% po4a: environment> I<env> I<parameters>
es: B<% po4a: environment> I<entorno> I<parámetros>

note: type: textblock
en: As for the commands, I<env> can be preceded by a plus (+) to indicate that the \begin command must be translated with all its arguments.
es: 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.

note: type: =item
en: B<% po4a: separator> I<env> B<">I<regex>B<">
es: B<% po4a: separator> I<entorno> B<">I<expresión_regular>B<">

note: type: textblock
en: Indicates that an environment should be split according to the given regular expression.
es: Indica que un entorno se debería dividir de acuerdo a la expresión regular dada.

note: type: textblock
en: For example, the LaTeX module uses the "(?:&|\\\\)" regular expression to translate separately each cell of a table (lines are separated by '\\' and cells by '&').
es: 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 '&').

note: type: =item
en: B<% po4a: verbatim environment> I<env>
es: B<% po4a: verbatim environment> I<entorno>

note: type: textblock
en: Indicate that I<env> is a verbatim environment.  Comments and commands will be ignored in this environment.
es: Indica que I<entorno> es un entorno literal. Los comentarios y órdenes se ignorarán en este entorno.

note: type: =head1
en: WRITING DERIVATE MODULES
es: ESCRIBIR MÓDULOS DERIVADOS

note: type: textblock
en: Add a string as a comment to be added around the next translated element.  This is mostly useful to the texinfo module, as comments are automatically handled in TeX.
es: 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.

note: type: textblock
en: Wrapper around Transtractor's translate, with pre- and post-processing filters.
es: Un «wrapper» (envoltorio) al translate del Transtractor, con filtros de pre- y post-procesado.

note: type: textblock
en: Comments of a paragraph are inserted as a PO comment for the first translated string of this paragraph.
es: Los comentarios de un párrafo se insertan como comentarios del PO en la primera cadena traducida del párrafo.

note: type: textblock
en: This function returns:
es: Esta función devuelve:

note: type: =item
en: A command name
es: El nombre de la orden

note: type: textblock
en: If no command is found at the beginning of the given buffer, this string will be empty.  Only commands that can be separated are considered.  The %separated_command hash contains the list of these commands.
es: 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.

note: type: =item
en: A variant
es: Una variante

note: type: textblock
en: This indicates if a variant is used.  For example, an asterisk (*) can be added at the end of sections command to specify that they should not be numbered.  In this case, this field will contain "*".  If there is no variant, the field is an empty string.
es: 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.

note: type: =item
en: An array of tuples (type of argument, argument)
es: Una arreglo de tuplas (tipo de argumento, argumento)

note: type: textblock
en: The type of argument can be either '{' (for mandatory arguments) or '[' (for optional arguments).
es: El tipo de argumento puede ser «{» (para argumentos obligatorios) o «[» (para argumentos opcionales).

note: type: =item
en: The remaining buffer
es: El resto del búfer

note: type: textblock
en: The rest of the buffer after the removal of this leading command and its arguments.  If no command is found, the original buffer is not touched and returned in this field.
es: 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.

note: type: textblock
en: The same as B<get_leading_command>, but for commands at the end of a buffer.
es: Lo mismo que B<get_leading_command>, pero para las órdenes al final de la memoria intermedia.

note: type: textblock
en: Recursively translate a buffer by separating leading and trailing commands (those which should be translated separately) from the buffer.
es: Traduce recursivamente una memoria intermedia separando de la misma la orden inicial y la final (los que se deben traducir por separado).

note: type: textblock
en: If a function is defined in %translate_buffer_env for the current environment, this function will be used to translate the buffer instead of translate_buffer().
es: 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()».

note: type: textblock
en: Overloads Transtractor's read().
es: Sobrecarga read() de Transtractor.

note: type: textblock
en: Recursively read a file, appending included files which are not listed in the @exclude_include array.  Included files are searched using the B<kpsewhich> command from the Kpathsea library.
es: 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.

note: type: textblock
en: Except from the file inclusion part, it is a cut and paste from Transtractor's read.
es: Exceptuando la parte de inclusión de ficheros, es una copia del «read» de Transtractor.

note: type: textblock
en: Subroutine for parsing a file with po4a directives (definitions for new commands).
es: Subrutina para analizar un fichero con directivas po4a (definiciones de órdenes nuevas).

note: type: textblock
en: Parse a definition line of the form "% po4a: ".
es: Analiza una linea de definición con la forma «% po4a: ».

note: type: textblock
en: See the B<INLINE CUSTOMIZATION> section for more details.
es: Consulte la sección B<PERSONALIZACIÓN DE OBJETOS EN LÍNEA> para más detalles.

note: type: =head1
en: INTERNAL FUNCTIONS used to write derivative parsers
es: FUNCIONES INTERNAS utilizadas para escribir analizadores derivados

note: type: textblock
en: Command and environment functions take the following arguments (in addition to the $self object):
es: Las funciones de orden y entorno toman los siguientes argumentos (además del objeto «$self»):

note: type: =item
en: An array of (type, argument) tuples
es: Una serie de tuplas (tipo, argumento)

note: type: =item
en: The current environment
es: El entorno actual

note: type: textblock
en: The first 3 arguments are extracted by get_leading_command or get_trailing_command.
es: Los primeros 3 parámetros se extraen con «get_leading_command» o «get_trailing_command».

note: type: textblock
en: Command and environment functions return the translation of the command with its arguments and a new environment.
es: Las funciones de orden y de entorno devuelven la traducción de la orden con sus argumentos y un nuevo entorno.

note: type: textblock
en: Environment functions are called when a \begin command is found. They are called with the \begin command and its arguments.
es: Las funciones de entorno se invocan cuando se encuentra una orden «\begin». Se invocan con la orden «\begin» y sus argumentos.

note: type: textblock
en: The TeX module only proposes one command function and one environment function: generic_command and generic_environment.
es: El módulo TeX sólo propone una orden de función y una orden de entorno: «generic_command» y «generic_environment».

note: type: verbatim
en: generic_command uses the information specified by
    register_generic_command or by adding definition to the TeX file:
     % po4a: command I<command1> I<parameters>
es: «generic_command» usa la información especificada
    por «register_generic_command», o añadiendo una
    definición para el fichero TeX:
     % po4a: command I<orden1> I<parámetros>

note: type: verbatim
en: generic_environment uses the information specified by
    register_generic_environment or by adding definition to the TeX file:
     % po4a: environment I<env> I<parameters>
es: «generic_environment» usa la información especificada
    por «register_generic_environment» o añadiendo al archivo TeX:
     % po4a: environment I<entorno> I<parámetros>

note: type: textblock
en: Both functions will only translate the parameters that were specified as translatable (with a '_').  generic_environment will append the name of the environment to the environment stack and generic_command will append the name of the command followed by an identifier of the parameter (like {#7} or [#2]).
es: 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]).

note: type: textblock
en: This module needs more tests.
es: Este módulo necesita más pruebas.

note: type: textblock
en: It was tested on a book and with the Python documentation.
es: Se ha probado con un libro y con la documentación de Python.

note: type: =head1
en: TODO LIST
es: LISTA DE TAREAS PENDIENTES

note: type: =item
en: Automatic detection of new commands
es: Detección automática de órdenes nuevas

note: type: textblock
en: The TeX module could parse the newcommand arguments and try to guess the number of arguments, their type and whether or not they should be translated.
es: 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.

note: type: =item
en: Translation of the environment separator
es: Traducción del separador de entorno

note: type: textblock
en: When \item is used as an environment separator, the item argument is attached to the following string.
es: Cuando usa «\item» como un separador de entorno, el elemento argumento se añade a la siguiente cadena.

note: type: =item
en: Some commands should be added to the environment stack
es: Algunas órdenes se deberían añadir a la pila («stack») del entorno

note: type: =item
en: Others
es: Otros

note: type: textblock
en: Various other points are tagged TODO in the source.
es: Hay varios puntos etiquetados con TODO en el código.

note: type: =head1
en: KNOWN BUGS
es: FALLOS CONOCIDOS

note: type: textblock
en: Various points are tagged FIXME in the source.
es: Hay varios puntos etiquetados con FIXME en el código.

note: type: textblock
en: Locale::Po4a::Texinfo - convert Texinfo documents and derivates from/to PO files
es: Locale::Po4a::TeXinfo - Convierte documentos TeXinfo y derivados desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Texinfo is a module to help the translation of Texinfo documents into other [human] languages.
es: Locale::Po4a:Texinfo es un módulo que asiste en la traducción de documentación en el formato Texinfo a otros lenguajes (humanos).

note: type: textblock
en: This module contains the definitions of common Texinfo commands and environments.
es: Este módulo contiene las definiciones de las órdenes y los entornos más habituales de Texinfo.

note: type: textblock
en: Only the comments starting with 'TRANSLATORS' are added to the PO files to guide the translators.
es: Solamente los comentarios iniciados con 'TRANSLATORS' son agregados a los ficheros PO para pautas de los traductores.

note: type: textblock
en: Locale::Po4a::Text - convert text documents from/to PO files
es: Locale::Po4a::Text - Convierte documentos de texto desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Text is a module to help the translation of text documents into other [human] languages.
es: Locale::Po4a::Text es un módulo que asiste en la traducción de documentación en formato de texto a otros lenguajes (humanos).

note: type: textblock
en: Paragraphs are split on empty lines (or lines containing only spaces or tabulations).
es: La división de los párrafos aparece en las líneas vacías (o líneas que sólo contienen espacios o tabulaciones).

note: type: textblock
en: If a paragraph contains a line starting by a space (or tabulation), this paragraph won't be rewrapped.
es: Si un párrafo contiene una línea que empieza con un espacio (o tabulación), este párrafo no se justificará.

note: type: textblock
en: Treat paragraphs that look like a key value pair as verbatim (with the no-wrap flag in the PO file).  Key value pairs are defined as a line containing one or more non-colon and non-space characters followed by a colon followed by at least one non-space character before the end of the line.
es: Trata los párrafos con apariencia de pareja de valores clave de forma literal (con el parámetro de no justificar en el fichero PO). Las parejas de valores clave se definen como una línea que contiene uno o más caracteres distintos del signo de dos puntos o de espacios en blanco seguidos de un signo de dos puntos, a su vez seguido de al menos un carácter distinto de un espacio en blanco antes del fin de línea.

note: type: textblock
en: Deactivate the detection of bullets.
es: Desactivar la detección de viñetas.

note: type: =item
en: B<tabs=>I<mode>
es: B<tabs=>I<modo>

note: type: textblock
en: Specify how tabulations shall be handled. The I<mode> can be any of:
es: Especifica cómo se tratan las tabulaciones. El I<modo> puede ser cualquiera de los siguientes:

note: type: textblock
en: Lines with tabulations introduce breaks in the current paragraph.
es: Las líneas con tabulaciones insertan líneas nuevas en el párrafo actual.

note: type: textblock
en: Paragraph containing tabulations will not be re-wrapped.
es: Los párrafos que contienen tabulaciones no se justificarán.

note: type: textblock
en: By default, tabulations are considered as spaces.
es: Por omisión, las tabulaciones se consideran espacios.

note: type: =item
en: B<breaks=>I<regex>
es: B<breaks=>I<expresión_regular>

note: type: textblock
en: A regular expression matching lines which introduce breaks.  The regular expression will be anchored so that the whole line must match.
es: Una expresión regular que coincide con las líneas que introducen nuevas líneas. La expresión será anclada para que la línea completa tenga que coincidir con el patrón.

note: type: textblock
en: Handle the header and footer of released versions, which only contain non translatable information.
es: Trate la cabecera y pié de página de las versiones publicadas, que sólo contienen información no traducible.

note: type: textblock
en: Handle the fortunes format, which separate fortunes with a line which consists in '%' or '%%', and use '%%' as the beginning of a comment.
es: Tratar el formato fortunes, que separa fortunes con una línea que consiste de «%» o «%%», y usa «%%» al inicio de un comentario.

note: type: textblock
en: Handle some special markup in Markdown-formatted texts.
es: Tratar algunas marcas especiales en textos con formato Markdown.

note: type: =item
en: B<yfm_keys> (markdown-only)
es: B<yfm_keys> (solo markdown)

note: type: =item
en: B<yfm_skip_array> (markdown-only)
es: B<yfm_skip_array> (solo markdown)

note: type: =item
en: B<control>[B<=>I<taglist>]
es: B<control>[B<=>I<lista-de-etiquetas>]

note: type: textblock
en: Handle control files.  A comma-separated list of tags to be translated can be provided.
es: Tratar ficheros de control. Se puede proporcionar una lista separada por comas de etiquetas a traducir.

note: type: textblock
en: Prevent po4a from wrapping any lines. This means that every content is handled verbatim, even simple paragraphs.
es: Previene po4a desde cobertura de cualquier línea. Esto significa que cada contenido es manipulado tal cual, incluso párrafos simples.

note: type: textblock
en: Tested successfully on simple text files and NEWS.Debian files.
es: Probado con éxito en ficheros de texto simple y ficheros «NEWS.Debian».

note: type: textblock
en: Locale::Po4a::TransTractor - generic trans(lator ex)tractor.
es: Locale::Po4a::TransTractor - Trans(lator ex)tractor genérico (traductor extractor).

note: type: textblock
en: This class is the ancestor of every po4a parser used to parse a document, to search translatable strings, to extract them to a PO file and to replace them by their translation in the output document.
es: Esta clase es la antecesora de todos los analizadores de po4a usados para analizar un documento buscando cadenas traducibles, extraerlas a un fichero PO y reemplazarlas por su traducción en el documento de salida.

note: type: textblock
en: More formally, it takes the following arguments as input:
es: Más formalmente, toma los siguientes parámetros como entrada:

note: type: textblock
en: a document to translate;
es: un documento a traducir;

note: type: textblock
en: a PO file containing the translations to use.
es: un fichero PO que contiene las traducciones a usar.

note: type: textblock
en: As output, it produces:
es: Como salida produce:

note: type: textblock
en: another PO file, resulting of the extraction of translatable strings from the input document;
es: otro fichero PO, resultado de la extracción de cadenas traducibles del documento de entrada;

note: type: textblock
en: a translated document, with the same structure than the one in input, but with all translatable strings replaced with the translations found in the PO file provided in input.
es: un documento traducido, con la misma estructura que el de la entrada, pero con todas las cadenas traducibles reemplazadas por las traducciones encontradas en el fichero PO suministrado en la entrada.

note: type: textblock
en: Here is a graphical representation of this:
es: Aquí tiene una representación gráfica:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \                           /       (translated)
                          +-> parse() function -----+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
es:    Documento de entrada -\                         /---> Documento de salida
                              \                       /         (traducido)
                               +-> función parse() --+
                              /                        \
       PO de entrada --------/                          \---> PO de salida
                                                                (extraído)

note: type: =head1
en: FUNCTIONS YOUR PARSER SHOULD OVERRIDE
es: FUNCIONES QUE SU ANALIZADOR DEBERÍA IMPLEMENTAR

note: type: textblock
en: This is where all the work takes place: the parsing of input documents, the generation of output, and the extraction of the translatable strings. This is pretty simple using the provided functions presented in the section B<INTERNAL FUNCTIONS> below. See also the B<SYNOPSIS>, which presents an example.
es: Aquí es dónde se hace todo el trabajo: el análisis de los documentos de entrada, la generación de la salida, y la extracción de las cadenas traducibles. Es realmente simple usando las funciones presentadas en la sección B<FUNCIONES INTERNAS> más abajo. Consulte la B<SINOPSIS>, que presenta un ejemplo.

note: type: textblock
en: This function is called by the process() function below, but if you choose to use the new() function, and to add content manually to your document, you will have to call this function yourself.
es: Esta función es invocada por la función «process()» a continuación, pero si elije usar la función «new()», y añadir contenido manualmente a su documento, deberá invocar ésta función manualmente.

note: type: textblock
en: This function returns the header we should add to the produced document, quoted properly to be a comment in the target language.  See the section B<Educating developers about translations>, from L<po4a(7)|po4a.7>, for what it is good for.
es: Esta función devuelve la cabecera que deberíamos añadir al documento creado, tratada de forma que sea un comentario para el lenguaje destino. Para ver las ventajas de esto, consulte la sección B<Educar a los programadores sobre las traducciones>, en L<po4a(7)|po4a.7>.

note: type: textblock
en: The following example parses a list of paragraphs beginning with "<p>". For the sake of simplicity, we assume that the document is well formatted, i.e. that '<p>' tags are the only tags present, and that this tag is at the very beginning of each paragraph.
es: El siguiente ejemplo analiza una lista de párrafos que empiezan con «<p>». Para simplificar, suponemos que el documento está correctamente formateado, es decir, que sólo hay presentes etiquetas '<p>', y que esta etiqueta está justo al principio de cada párrafo.

note: type: verbatim
en:    PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Not the first time we see <p>.
                   # Reput the current line in input,
                   #  and put the built paragraph to output
                   $self->unshiftline($line,$lref);
es:    PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # No es la primera vez que vemos <p>.
                   # Devuelve la línea actual a la entrada,
                   # y pon el párrafo construido en la salida.
                   $self->unshiftline($line,$lref);

note: type: verbatim
en:                # Now that the document is formed, translate it:
                   #   - Remove the leading tag
                   $paragraph =~ s/^<p>//s;
es:                # Ahora que tenemos el documento creado, lo traducimos:
                   #   - Eliminamos la etiqueta inicial
                   $paragraph =~ s/^<p>//s;

note: type: verbatim
en:                #   - push to output the leading tag (untranslated) and the
                   #     rest of the paragraph (translated)
                   $self->pushline(  "<p>"
                                   . $self->translate($paragraph,$pararef)
                                   );
es:                #   - Ponemos en la salida la etiqueta inicial (sin traducir) y el
                   #     resto del párrafo (traducido)
                   $self>pushline(  "<p>"
                                       . $self->translate($paragraph,$parraref)
                                       );

note: type: verbatim
en:                next PARAGRAPH;
               } else {
                   # Append to the paragraph
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }
es:                next PARAGRAPH;
               } else {
                   # Añadir al párrafo.
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }

note: type: verbatim
en:            # Reinit the loop
               ($line,$lref)=$self->shiftline();
           }
           # Did not get a defined line? End of input file.
           return;
       }
     }
es:            # Reiniciar el bucle
               ($line,$lref)=$self->shiftline();
           }
    ¿       # ¿No se obtuvo una línea definida? Fin del fichero de entrada.
           return;
       }
     }

note: type: textblock
en: Once you've implemented the parse function, you can use your document class, using the public interface presented in the next section.
es: Una vez haya implementado la función de análisis, ya puede usar su clase de documento usando la interfaz pública presentada en la siguiente sección.

note: type: =head1
en: PUBLIC INTERFACE for scripts using your parser
es: INTERFAZ PÚBLICA para scripts que usen su analizador

note: type: textblock
en: This function can do all you need to do with a po4a document in one invocation. Its arguments must be packed as a hash. ACTIONS:
es: Esta función puede hacer todo lo que quiera hacer con un documento po4a en una invocación:. Sus argumentos deben estar empaquetados como una tabla de elementos asociativos («hash»). ACCIONES:

note: type: textblock
en: Reads all the PO files specified in po_in_name
es: Lee todos los ficheros PO especificados en «po_in_name»

note: type: textblock
en: Reads all original documents specified in file_in_name
es: Lee todos los documentos originales especificado en «file_in_name»

note: type: textblock
en: Parses the document
es: Analiza el documento

note: type: textblock
en: Reads and applies all the addenda specified
es: Lee y aplica todos los apéndices especificados

note: type: textblock
en: Writes the translated document to file_out_name (if given)
es: Escribe el documento traducido en «file_out_name» (si se da)

note: type: textblock
en: Writes the extracted PO file to po_out_name (if given)
es: Escribe el fichero PO extraído en «po_out_name» (si se da)

note: type: textblock
en: ARGUMENTS, beside the ones accepted by new() (with expected type):
es: ARGUMENTOS, aparte de los aceptados por «new()» (con el tipo esperado):

note: type: textblock
en: List of filenames where we should read the input document.
es: Lista de los nombres de ficheros de los que se debe leer el documento de entrada.

note: type: textblock
en: Charset used in the input document (if it isn't specified, it will try to detect it from the input document).
es: El juego de caracteres usado en el documento de entrada (si no se especifica, se intentará detectar del documento de entrada).

note: type: textblock
en: Filename where we should write the output document.
es: Nombre del fichero donde se debe escribir el documento de salida.

note: type: textblock
en: Charset used in the output document (if it isn't specified, it will use the PO file charset).
es: El juego de caracteres usado en el documento de salida (si no se especifica, se usará el juego de caracteres del fichero PO).

note: type: textblock
en: List of filenames where we should read the input PO files from, containing the translation which will be used to translate the document.
es: Lista de los nombres de ficheros de los que se deben leer los ficheros PO de entrada, y que contienen la traducción que se usará para traducir el documento.

note: type: textblock
en: Filename where we should write the output PO file, containing the strings extracted from the input document.
es: Nombre de fichero en el que se debe escribir el fichero PO de salida, el cual contendrá las cadenas extraídas del documento de entrada.

note: type: textblock
en: List of filenames where we should read the addenda from.
es: Lista de los nombres de los ficheros de los que se deben leer los apéndices.

note: type: textblock
en: Charset for the addenda.
es: El juego de caracteres para los apéndices.

note: type: textblock
en: Sets the verbosity.
es: Configura el nivel de verbosidad.

note: type: textblock
en: Sets the debugging.
es: Configura la depuración.

note: type: =head2
en: Manipulating document files
es: Manipulación de ficheros de documentos

note: type: textblock
en: Please note that it does not parse anything. You should use the parse()  function when you're done with packing input files into the document.
es: Cabe destacar que esto no analiza nada. Debe usar la función «parse()» cuando haya terminado de cargar los ficheros de entrada en el documento.

note: type: textblock
en: Write the translated document to the given filename.
es: Escribe el documento traducido al fichero dado.

note: type: verbatim
en: This translated document data are provided by:
     * C<< $self->docheader() >> holding the header text for the plugin, and
     * C<< @{$self->{TT}{doc_out}} >> holding each line of the main translated text in the array.
es: Estos datos de documentos traducidos se proporcionan por:
     * C<< $self->docheader() >> que contiene el texto de cabecera de la extensión, y
     * C<< @{$self->{TT}{doc_out}} >> que contiene cada línea del texto traducido principal de la matriz.

note: type: =head2
en: Manipulating PO files
es: Manipula ficheros PO

note: type: textblock
en: Add the content of a file (which name is passed as argument) to the existing input PO. The old content is not discarded.
es: Añade el contenido de un fichero (cuyo nombre se introduce como argumento) al PO de entrada existente. El contenido anterior no se desecha.

note: type: textblock
en: Write the extracted PO file to the given filename.
es: Escribe el fichero PO extraído al nombre de fichero dado.

note: type: textblock
en: Returns some statistics about the translation done so far. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's stats about recent usage of the PO file, while msgfmt reports the status of the file. It is a wrapper to the Locale::Po4a::Po::stats_get function applied to the input PO file. Example of use:
es: Devuelve algunas estadísticas sobre el punto actual de la traducción en curso. Estas no son las mismas estadísticas que las que muestra «msgfmt --statistic». Aquí las estadísticas son sobre el uso reciente del fichero PO, mientras que msgfmt informa del estado del fichero. Esto es un «wrapper» (patrón de diseño) de la función Locale::Po4a::Po::stats_get aplicada al fichero PO de entrada. Ejemplo de uso:

note: type: verbatim
en:     [normal use of the po4a document...]
es:     [uso normal del documento po4a...]

note: type: verbatim
en:     ($percent,$hit,$queries) = $document->stats();
        print "We found translations for $percent\%  ($hit from $queries) of strings.\n";
es:     ($porcentaje,$aciertos,$solicitudes) = $documento->stats();
        print "Se han encontrado traducciones para el $porcentaje\%  ($aciertos de $solicitudes) de cadenas.\n";

note: type: =head2
en: Manipulating addenda
es: Manipulación de apéndices

note: type: textblock
en: Please refer to L<po4a(7)|po4a.7> for more information on what addenda are, and how translators should write them. To apply an addendum to the translated document, simply pass its filename to this function and you are done ;)
es: Consulte L<po4a(7)|po4a.7> para más información acerca de los apéndices, y cómo los traductores deben escribirlos. Para aplicar un apéndice a un documento traducido, simplemente introduzca su nombre de fichero en ésta función y ya está ;)

note: type: textblock
en: This function returns a non-null integer on error.
es: Esta función devuelve un entero no nulo en caso de error.

note: type: =head2
en: Getting input, providing output
es: Obtener entrada, proporcionar salida

note: type: textblock
en: Four functions are provided to get input and return output. They are very similar to shift/unshift and push/pop of Perl.
es: Se proporcionan cuatro funciones para obtener la entrada y salida de vuelta. Son muy similares a shift/unshift y push/pop de Perl.

note: type: verbatim
en:  * Perl shift returns the first array item and drop it from the array.
     * Perl unshift prepends an item to the array as the first array item.
     * Perl pop returns the last array item and drop it from the array.
     * Perl push appends an item to the array as the last array item.
es:  * Perl shift devuelve el primer elemento de matriz y lo elimina de la matriz.
     * Perl unshift añade un elemento al matriz como el primer elemento del a matriz.
     * Perl pop devuelve el último elemento de la matriz y lo elimina de la matriz.
     * Perl push añade un elemento a la matriz como el último elemento de la matriz.

note: type: textblock
en: The first pair is about input, while the second is about output. Mnemonic: in input, you are interested in the first line, what shift gives, and in output you want to add your result at the end, like push does.
es: El primer par trata la entrada, mientras que el segundo trata la salida. Truco mnemoténico: en la entrada, está interesado en la primera línea, lo que ofrece shift, y en la salida desea insertar el resultado al final, como hace push.

note: type: textblock
en: This function returns the first line to be parsed and its corresponding reference (packed as an array) from the array C<< @{$self->{TT}{doc_in}} >> and drop these first 2 array items.  Here, the reference is provided by a string C<< $filename:$linenum >>.
es: Esta función devuelve la primera línea para su análisis y la referencia correspondiente (en forma de matriz), de la matriz C<< @{$self->{TT}{doc_in}} >>, y elimina estos dos primeros elementos de matriz. Aquí, la referencia es proporcionada por la cadena C<< $filename:$linenum >>.

note: type: textblock
en: Unshifts the last shifted line of the input document and its corresponding reference back to the head of C<< {$self->{TT}{doc_in}} >>.
es: Devuelve la modificación «shift» de la última línea «shifted» del documento de entrada y su referencia a la cabecera de C<< {$self->{TT}{doc_in}} >>.

note: type: textblock
en: Push a new line to the end of C<< {$self->{TT}{doc_out}} >>.
es: Inserta una línea nueva al final de C<< {$self->{TT}{doc_out}} >>.

note: type: textblock
en: Pop the last pushed line from the end of C<< {$self->{TT}{doc_out}} >>.
es: Extrae la últma línea insertada al final de C<< {$self->{TT}{doc_out}} >>.

note: type: =head2
en: Marking strings as translatable
es: Marcar cadenas como traducibles

note: type: textblock
en: One function is provided to handle the text which should be translated.
es: Se proporciona una función para tratar el texto que se debe traducir.

note: type: textblock
en: Mandatory arguments:
es: Argumentos obligatorios:

note: type: textblock
en: A string to translate
es: Una cadena a traducir

note: type: textblock
en: The reference of this string (i.e. position in inputfile)
es: La referencia a esa cadena (por ejemplo, la posición en el fichero de entrada)

note: type: textblock
en: The type of this string (i.e. the textual description of its structural role; used in Locale::Po4a::Po::gettextization(); see also L<po4a(7)|po4a.7>, section B<Gettextization: how does it work?>)
es: El tipo de esta cadena (es decir la descripción textual de su rol estructural; utilizada en Locale::Po4a::Po::gettextization(); consulte también la sección B<Gettextización: ¿cómo funciona?> en L<po4a(7)|po4a.7>)

note: type: textblock
en: This function can also take some extra arguments. They must be organized as a hash. For example:
es: Esta función también puede tomar algunos argumentos adicionales. Estos deben estar en una tabla de elementos asociativos («hash»). Por ejemplo:

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation or extracting it, and wraps the translation.
es: Booleano que indica si podemos considerar que los espacios en blanco de la cadena carecen de importancia. En ese caso, la función canoniza la cadena antes de buscar su traducción o extraerla, y justifica la traducción.

note: type: textblock
en: an extra comment to add to the entry.
es: Un comentario adicional para añadir a la entrada.

note: type: textblock
en: Actions:
es: Acciones:

note: type: textblock
en: Pushes the string, reference and type to po_out.
es: Inserta la cadena, referencia y escribe en «po_out».

note: type: textblock
en: Returns the translation of the string (as found in po_in) so that the parser can build the doc_out.
es: Devuelve la traducción de la cadena (como aparece en «po_in») de forma que el analizador pueda construir el fichero «doc_out».

note: type: textblock
en: Handles the charsets to recode the strings before sending them to po_out and before returning the translations.
es: Trata los juegos de caracteres para recodificar las cadenas antes de enviarlas a «po_out» y antes de devolver las traducciones.

note: type: =head2
en: Misc functions
es: Funciones varias

note: type: textblock
en: Returns if the verbose option was passed during the creation of the TransTractor.
es: Devuelve si se pasó la opción de verbosidad durante la creación del TransTractor.

note: type: textblock
en: Returns if the debug option was passed during the creation of the TransTractor.
es: Devuelve si se pasó la opción de depuración de fallos durante la creación del TransTractor.

note: type: textblock
en: This tells TransTractor that a new charset (the first argument) has been detected from the input document. It can usually be read from the document header. Only the first charset will remain, coming either from the process() arguments or detected from the document.
es: Esto informa al TransTractor que se ha detectado un nuevo juego de caracteres (el primer argumento) en el documento de entrada. Habitualmente se puede encontrar en la cabecera del documento. Solo permanecerá el primer juego de caracteres, ya venga de los argumentos de «process()» o si se detectó en el documento.

note: type: textblock
en: This function will return the charset that should be used in the output document (usually useful to substitute the input document's detected charset where it has been found).
es: Esta función devuelve el juego de caracteres que se debe usar en el documento de salida (normalmente es útil para sustituir el juego de caracteres detectado en el documento de entrada donde se encontró).

note: type: textblock
en: It will use the output charset specified in the command line. If it wasn't specified, it will use the input PO's charset, and if the input PO has the default "CHARSET", it will return the input document's charset, so that no encoding is performed.
es: Utilizará el juego de caracteres especificado en la linea de órdenes. Si no se ha especificado, utilizará el juego de caracteres del PO de entrada, y si el PO de entrada aún tiene el «CHARSET» predefinido, devolverá el juego de caracteres del documento de entrada, para que no se realice ninguna codificación.

note: type: textblock
en: This function returns the recoded text passed as argument, from the input document's charset to the output document's one. This isn't needed when translating a string (translate() recodes everything itself), but it is when you skip a string from the input document and you want the output document to be consistent with the global encoding.
es: Esta función devuelve el texto recodificado introducido como argumento, desde el juego de caracteres del documento de entrada al del documento de salida. No es necesario cuando se traduzca una cadena (translate() ya lo recodifica por su cuenta), pero sí lo es cuando se salta alguna cadena del documento de entrada y quiere mantener la consistencia del documento de salida con la codificación global.

note: type: =head1
en: FUTURE DIRECTIONS
es: DIRECCIONES FUTURAS

note: type: textblock
en: One shortcoming of the current TransTractor is that it can't handle translated document containing all languages, like debconf templates, or .desktop files.
es: Una deficiencia del TransTractor actual es que no puede tratar documentos traducidos que contengan todos los idiomas, como las plantillas de debconf, o en los ficheros «.desktop».

note: type: textblock
en: To address this problem, the only interface changes needed are:
es: Para tratar este problema, los únicos cambios necesarios en la interfaz son:

note: type: textblock
en: take a hash as po_in_name (a list per language)
es: tomar una tabla «hash» como «po_in_name» (una lista por idioma)

note: type: textblock
en: add an argument to translate to indicate the target language
es: añadir un argumento a «translate» para indicar el idioma de destino

note: type: textblock
en: make a pushline_all function, which would make pushline of its content for all languages, using a map-like syntax:
es: hacer una función «pushline_all», que haría un «pushline» de su contenido para todos los idiomas, usando una sintaxis parecida a «map»:

note: type: textblock
en: Will see if it's enough ;)
es: Ya veremos si es suficiente ;)

note: type: textblock
en: Locale::Po4a::Wml - convert WML (web markup language) documents from/to PO files
es: Locale::Po4a::Wml - Convierte documentos WML (web markup language) desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Wml is a module to help the translation of WML documents into other [human] languages. Do not mixup the WML we are speaking about here (web markup language) and the WAP crap used on cell phones.
es: Locale::Po4a::Wml es un módulo que asiste en la traducción de documentación en formato WML a otros lenguajes (humano). No confunda el WML que se trata aquí con la porquería de WAP usado en teléfonos móviles.

note: type: textblock
en: Please note that this module relies upon the Locale::Po4a::Xhtml module, which also relies upon the Locale::Po4a::Xml module.  This means that all tags for web page expressions are assumed to be written in the XHTML syntax.
es: Observe que este módulo depende del módulo Locale::Po4a::Xhtml, el cual depende a su vez del módulo Locale::Po4a::Xml. Esto significa que se supone que todas las etiquetas para las expresiones de páginas web están escritas con sintaxis XHTML.

note: type: textblock
en: This module works for some simple documents, but is still young.  Currently, the biggest issue of the module is probably that it cannot handle documents that contain non-XML inline tags such as <email "foo@example.org">, which are often defined in the WML.  Improvements will be added in the future releases.
es: Este módulo funciona con algunos documentos simples, pero aún es reciente. Actualmente, puede que el mayor problema de este módulo sea que no puede tratar documentos que contienen etiquetas en línea que no son XML tales como <email "foo@ejemplo.org">, que a menudo están definidos en el WML. Experimentará mejoras en versiones futuras.

note: type: textblock
en: Locale::Po4a::Xhtml - convert XHTML documents from/to PO files
es: Locale::Po4a::Xhtml - Convierte documentos XHTML desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Xhtml is a module to help the translation of XHTML documents into other [human] languages.
es: Locale::Po4a::Xhtml es un módulo que asiste en la traducción de documentación en el formato XHTML a otros lenguajes (humanos).

note: type: =item
en: B<includessi>[B<=>I<rootpath>]
es: B<includessi>[B<=>I<ruta_raíz>]

note: type: textblock
en: Include files specified by an include SSI (Server Side Includes) element (e.g. <!--#include virtual="/foo/bar.html" -->).
es: Incluye ficheros especificados con un elemento «include SSI» («Server Side Includes»), por ejemplo <!--#include virtual="/foo/bar.html" -->).

note: type: textblock
en: B<Note:> You should use it only for static files.
es: B<Nota:> Debería usar esto sólo con ficheros estáticos.

note: type: textblock
en: An additional I<rootpath> parameter can be specified. It specifies the root path to find files included by a B<virtual> attribute.
es: Puede especificar un parámetro I<ruta_raíz> adicional. Ésto especifica la ruta raíz donde encontrar los ficheros incluidos por un atributo B<virtual>.

note: type: textblock
en: Locale::Po4a::Xml - convert XML documents and derivates from/to PO files
es: Locale::Po4a::Xml - Convierte documentos XML y derivados desde/a ficheros PO

note: type: textblock
en: Locale::Po4a::Xml is a module to help the translation of XML documents into other [human] languages. It can also be used as a base to build modules for XML-based documents.
es: Locale::Po4a::Xml es un módulo que asiste en la traducción de documentación en el formato XML a otros lenguajes (humanos). También se puede usar como base para construir módulos para documentos basados en XML.

note: type: =head1
en: TRANSLATING WITH PO4A::XML
es: TRADUCIR CON PO4A::XML

note: type: textblock
en: This module can be used directly to handle generic XML documents.  This will extract all tag's content, and no attributes, since it's where the text is written in most XML based documents.
es: Este módulo se puede usar directamente para tratar documentos XML genéricos. Extraerá el contenido de todas las etiquetas, y ningún atributo, ya que ahí es donde se escribe el texto en la mayoría de documentos basados en XML.

note: type: textblock
en: 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 module derived from this, to describe your format's details.  See the section B<WRITING DERIVATE MODULES> below, for the process description.
es: Hay algunas opciones (descritas en la siguiente sección) que pueden personalizar este comportamiento. Si eso no es suficiente para el formato de su documento, le animo a que escriba su propio módulo derivado de éste para describir los detalles de su formato. Consulte la sección B<Escribir módulos derivados> que encontrará más abajo para una descripción del proceso.

note: type: textblock
en: The global debug option causes this module to show the excluded strings, in order to see if it skips something important.
es: La opción «debug» global provoca que este módulo muestre las cadenas excluidas, para ver si se salta algo importante.

note: type: textblock
en: Prevents it to strip the spaces around the extracted strings.
es: Evita que se quiten los espacios alrededor de las cadenas extraídas.

note: type: textblock
en: Canonicalizes the string to translate, considering that whitespaces are not important, and wraps the translated document. This option can be overridden by custom tag options. See the B<translated> option below.
es: Canoniza las cadenas a traducir, considerando que los espacios en blanco no son importantes, y justifica el documento traducido. Tienen preferencia sobre esta, las opciones personalizadas de cada etiqueta. Consulte la opción B<translated> más abajo.

note: type: textblock
en: Attributes are wrapped by default. This option disables wrapping.
es: Los atributos se justifican de forma predefinida. Esta opción desactiva el justificado.

note: type: textblock
en: It makes the tags and attributes searching to work in a case insensitive way.  If it's defined, it will treat E<lt>BooKE<gt>laNG and E<lt>BOOKE<gt>Lang as E<lt>bookE<gt>lang.
es: Permite que las búsquedas de etiqueta y atributos no tengan en cuenta mayúsculas y minúsculas. Si está definido, tratará E<lt>BooKE<gt>laNG y E<lt>BOOKE<gt>Lang como E<lt>bookE<gt>lang.

note: type: textblock
en: Escape quotes in output strings.  Necessary, for example, for creating string resources for use by Android build tools.
es: Escape de comillas en las cadenas de salida. Necesarias, por ejemplo, para crear recursos de cadenas para us uso en herramientas de compilación Android.

note: type: textblock
en: See also: https://developer.android.com/guide/topics/resources/string-resource.html
es: Consulte también: https://developer.android.com/guide/topics/resources/string-resource.html

note: type: textblock
en: When defined, external entities are included in the generated (translated)  document, and for the extraction of strings.  If it's not defined, you will have to translate external entities separately as independent documents.
es: Si se define, se incluirán las entidades externas en el documento (traducido) generado, así como para la extracción de cadenas. De no estar definido tendrá que traducir las entidades externas separadamente, como documentos independientes.

note: type: textblock
en: This option defines the behavior of the module when it encounters invalid XML syntax (a closing tag which does not match the last opening tag).  It can take the following values:
es: Esta opción define el comportamiento del módulo cuando encuentra una sintaxis XML no válida (una etiqueta de cierre que no concuerda con la última etiqueta de inicio). Puede tomar los siguientes valores:

note: type: textblock
en: This is the default value.  The module will exit with an error.
es: Éste es el valor predefinido. El módulo cerrará con un mensaje de error.

note: type: textblock
en: The module will continue, and will issue a warning.
es: El módulo continuará, mostrando una advertencia.

note: type: textblock
en: The module will continue without any warnings.
es: El módulo continuará sin advertencias.

note: type: textblock
en: Be careful when using this option.  It is generally recommended to fix the input file.
es: Sea cuidadoso a la hora de usar esta opción. En general, recomendamos arreglar el fichero de entrada.

note: type: textblock
en: Note: This option is deprecated.
es: Nota: Esta opción está obsoleta.

note: type: textblock
en: String that will try to match with the first line of the document's doctype (if defined). If it doesn't, a warning will indicate that the document might be of a bad type.
es: La cadena que intentará encajar con la primera línea del «doctype» del documento (si está definida). Una advertencia indicará que el documento puede ser de un tipo equivocado, si no encaja.

note: type: textblock
en: String indicating the path (e.g. E<lt>bbbE<gt>E<lt>aaaE<gt>) of a tag where a lang="..." attribute shall be added. The language will be defined as the basename of the PO file without any .po extension.
es: Cadena que indica la ruta (por ejemplo, E<lt>bbbE<gt>E<lt>aaaE<gt>) de una etiqueta donde se ha de añadir el atributo «lang="..."». El idioma se definirá como el nombre base del fichero PO sin ninguna extensión «po».

note: type: textblock
en: Note: This option is deprecated.  You should use the B<translated> and B<untranslated> options instead.
es: Nota: Esta opción está obsoleta. En lugar de ello, debería usar las opciones B<translated> y B<untranslated>.

note: type: textblock
en: Space-separated list of tags you want to translate or skip.  By default, the specified tags will be excluded, but if you use the "tagsonly" option, the specified tags will be the only ones included.  The tags must be in the form E<lt>aaaE<gt>, but you can join some (E<lt>bbbE<gt>E<lt>aaaE<gt>) to say that the content of the tag E<lt>aaaE<gt> will only be translated when it's into a E<lt>bbbE<gt> tag.
es: Lista separada por espacios de las etiquetas que desea traducir u omitir. Por omisión, se excluirán las etiquetas especificadas, pero si utiliza la opción «tagsonly», las etiquetas especificadas serán los únicos incluidos. Las etiquetas deben tener la forma E<lt>aaaE<gt>, pero puede juntar algunos (E<lt>bbbE<gt>E<lt>aaaE<gt>) para indicar que el contenido de la etiqueta E<lt>aaaE<gt> sólo se debe traducir cuando esté dentro de la etiqueta E<lt>bbbE<gt>.

note: type: textblock
en: Example: WE<lt>chapterE<gt>E<lt>titleE<gt>
es: Ejemplo: WE<lt>chapterE<gt>E<lt>titleE<gt>

note: type: textblock
en: Space-separated list of tag's attributes you want to translate.  You can specify the attributes by their name (for example, "lang"), but you can prefix it with a tag hierarchy, to specify that this attribute will only be translated when it's in the specified tag. For example: E<lt>bbbE<gt>E<lt>aaaE<gt>lang specifies that the lang attribute will only be translated if it's in an E<lt>aaaE<gt> tag, and it's in a E<lt>bbbE<gt> tag.
es: Lista separada por espacios de los atributos de etiquetas que quiere traducir. Puede especificar los atributos por su nombre (por ejemplo, «lang»), pero puede añadirle como prefijo una jerarquía de etiquetas para especificar que esta etiqueta sólo se debe traducir cuando esté dentro de la etiqueta especificada. Por ejemplo: E<lt>bbbE<gt>E<lt>aaaE<gt>lang indica que el atributo «lang» sólo se traducirá cuando esté dentro de la etiqueta E<lt>aaaE<gt>, y ésta esté dentro de una etiqueta E<lt>bbbE<gt>.

note: type: textblock
en: Do not translate attributes in inline tags.  Instead, replace all attributes of a tag by po4a-id=<id>.
es: No traduce los atributos en etiquetas en línea. En lugar de ello, reemplaza todos los atributos de una etiqueta con po4a-id=<id>.

note: type: textblock
en: This is useful when attributes shall not be translated, as this simplifies the strings for translators, and avoids typos.
es: Esto es útil cuando no se deben traducir los atributos, simplificando las cadenas a las traductores evitando así errores al teclear.

note: type: textblock
en: Space-separated list of tags which should not be treated as tags.  These tags are treated as inline, and do not need to be closed.
es: Lista separada por espacios de las etiquetas que no se deberían tratar como tales. Éstas se tratan como etiquetas en línea, y no precisan cierre.

note: type: textblock
en: Space-separated list of tags which should break the sequence.  By default, all tags break the sequence.
es: Lista separada por espacios de las etiquetas que deberían romper la secuencia. Por omisión todas las etiquetas rompen la secuencia.

note: type: textblock
en: The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).
es: Las etiquetas deben tener la forma <aaa>, pero puede unir algunas (<bbb><aaa>), si una etiqueta (<aaa>) sólo se debe considerar cuando está dentro de otra etiqueta.

note: type: textblock
en: Please note a tag should be listed in only one of the B<break>, B<inline> B<placeholder>, or B<customtag> setting string.
es: Tenga en cuenta que una etiqueta solo se puede introducir en solo una de las cadenas de ajuste B<break>, B<inline> B<placeholder>, o B<customtag>.

note: type: textblock
en: Space-separated list of tags which should be treated as inline.  By default, all tags break the sequence.
es: Lista separada por espacios de las etiquetas que quiere tratar como elementos en línea (que no rompen la secuencia). Por omisión todas las etiquetas rompen la secuencia.

note: type: textblock
en: Space-separated list of tags which should be treated as placeholders.  Placeholders do not break the sequence, but the content of placeholders is translated separately.
es: Lista separada por espacios de las etiquetas que se deberían tratar como marcadores de posición («placeholders»). Éstos no rompen la secuencia, pero su contenido se traduce separadamente.

note: type: textblock
en: The location of the placeholder in its block will be marked with a string similar to:
es: La ubicación del «placeholder» dentro de su bloque se marcará con una cadena similar a:

note: type: textblock
en: Space separated list of tags that the module should not try to set by default in any category.
es: Una lista separada por espacios de etiquetas que el módulo no debería definir en ninguna categoría de manera predefinidas.

note: type: textblock
en: If you have a tag which has its default setting by the subclass of this module but you want to set alternative setting, you need to list that tag as a part of the B<nodefault> setting string.
es: Si existe una etiqueta cuyo ajuste predefindo se deriva de la subclase de este módulo, pero desea definir un ajuste alternativo, debe introducir tal etiqueta como parte de la cadena de ajuste B<nodefault>.

note: type: textblock
en: Support C preprocessor directives.  When this option is set, po4a will consider preprocessor directives as paragraph separators.  This is important if the XML file must be preprocessed because otherwise the directives may be inserted in the middle of lines if po4a consider it belong to the current paragraph, and they won't be recognized by the preprocessor.  Note: the preprocessor directives must only appear between tags (they must not break a tag).
es: Compatibilidad con directivas de preprocesador de C. Si activa esta opción, po4a tratará las directivas de preprocesador como separadores de párrafo. Esto cobra importancia si se debe preprocesar el fichero XML, ya que de otra forma las directivas se podrían insertar en medio de la línea si po4a considera que pertenecen al párrafo actual, y serían irreconocibles para el preprocesador. Nota: las directivas del preprocesador deben aparecer entre etiquetas (no deben romper etiquetas).

note: type: textblock
en: Space-separated list of tags you want to translate.
es: Una lista separada por espacios de etiquetas que desea traducir.

note: type: textblock
en: You can also specify some tag options by putting some characters in front of the tag hierarchy.  This overrides the default behavior specified by the global B<wrap> and B<defaulttranslateoption> option.
es: También puede especificar algunas opciones de etiquetas poniendo algunos caracteres delante de la jerarquía de etiquetas. Esto anula el comportamiento predefinido especificado por las opciones globales B<wrap> y B<defaulttranslateoption>.

note: type: textblock
en: Tags should be translated and content can be re-wrapped.
es: Las etiquetas deberían traducirse, y se puede justificar el contenido.

note: type: textblock
en: Tags should be translated and content should not be re-wrapped.
es: Las etiquetas deberían traducirse, y no se debe justificar el contenido.

note: type: textblock
en: Tags should be translated inline.
es: Las etiquetas se deberían traducir como elementos en línea.

note: type: textblock
en: Tags should be translated as placeholders.
es: Las etiquetas se deberían traducir como marcadores de posición.

note: type: textblock
en: You can verify actual internal parameter behavior by invoking B<po4a> with B<--debug> option.
es: Puede comprobar el comportamiento de parámatro interno real invocando B<po4a> con la opción B<--debug>.

note: type: textblock
en: Please note a tag should be listed in either B<translated> or B<untranslated> setting string.
es: Tenga en cuenta que una etiqueta se debe introducir en la cadena de ajuste de B<translated> o B<untranslated>.

note: type: textblock
en: Space-separated list of tags you do not want to translate.
es: Lista separada por espacios de las etiquetas que no desea traducir.

note: type: textblock
en: The default categories for tags that are not in any of the translated, untranslated, break, inline, or placeholder.
es: Las categorías predefinidas para las etiquetas que no pertenecen a translated, untranslated, break, inline, o placeholder.

note: type: textblock
en: This is a set of letters as defined in B<translated> and this setting is only valid for translatable tags.
es: Esto es un conjunto de letras como define B<translated>, y este ajuste solo es válido para etiquetas traducibles.

note: type: =head1
en: WRITING DERIVATIVE MODULES
es: ESCRITURA DE MÓDULOS DERIVADOS

note: type: =head2
en: DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE
es: DEFINIR QUÉ ETIQUETAS Y ATRIBUTOS TRADUCIR

note: type: textblock
en: The simplest customization is to define which tags and attributes you want the parser to translate.  This should be done in the initialize function.  First you should call the main initialize, to get the command-line options, and then, append your custom definitions to the options hash.  If you want to treat some new options from command line, you should define them before calling the main initialize:
es: La personalización más simple es definir qué etiquetas («tags») y atributos quiere que el analizador traduzca. Esto se debe hacer en la función «initialize». Primero debe invocar la inicialización principal, para obtener las opciones de la línea de órdenes, y luego, añadir sus definiciones personalizadas a la tabla «hash» de opciones. Si quiere tratar nuevas opciones de la línea de órdenes, debe definirlas antes de invocar la función «initialize» principal:

note: type: textblock
en: You should use the B<_default_inline>, B<_default_break>, B<_default_placeholder>, B<_default_translated>, B<_default_untranslated>, and B<_default_attributes> options in derivative modules. This allow users to override the default behavior defined in your module with command line options.
es: Debería usar las opciones B<_default_inline>, B<_default_break>, B<_default_placeholder>, B<_default_translated>, B<_default_untranslated> y B<_default_attributes> con módulos derivados. Esto permite a los usuarios invalidar el comportamiento predefinido configurado en su módulo mediante las opciones de línea de órdenes.

note: type: textblock
en: If you don't like the default behavior of this xml module and its derivative modules, you can provide command line options to change their behavior.
es: Si no le satisface el comportamiento predefindo de este módulo xml y sus módulos derivados, puede proporcionar opciones de línea de órdenes para modificar su comportamiento.

note: type: textblock
en: See L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,
es: Consulte L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,

note: type: =head2
en: OVERRIDING THE found_string FUNCTION
es: REDEFINIR LA FUNCIÓN found_string

note: type: textblock
en: Another simple step is to override the function "found_string", which receives the extracted strings from the parser, in order to translate them.  There you can control which strings you want to translate, and perform transformations to them before or after the translation itself.
es: Otro paso simple es redefinir la función «found_string», que recibe las cadenas extraídas por el analizador para su traducción. Ahí puede controlar qué cadenas quiere traducir, y realizar pequeñas transformaciones antes o después de la traducción misma.

note: type: textblock
en: It receives the extracted text, the reference on where it was, and a hash that contains extra information to control what strings to translate, how to translate them and to generate the comment.
es: Recibe el texto extraído, la referencia de dónde está, y una tabla «hash» que contiene información adicional para controlar qué cadenas traducir, cómo traducirlas y generar el comentario.

note: type: textblock
en: The content of these options depends on the kind of string it is (specified in an entry of this hash):
es: El contenido de las opciones depende del tipo de cadena que sea (especificado en una entrada de este «hash»):

note: type: =item
en: type="tag"
es: type="etiqueta"

note: type: textblock
en: The found string is the content of a translatable tag. The entry "tag_options" contains the option characters in front of the tag hierarchy in the module "tags" option.
es: La cadena encontrada es el contenido de una etiqueta («tag») traducible. La entrada «tag_options» (opciones de etiquetas) contiene los caracteres de opciones delante de la jerarquía de etiquetas en la opción «tags» del módulo.

note: type: =item
en: type="attribute"
es: type="atributo"

note: type: textblock
en: Means that the found string is the value of a translatable attribute. The entry "attribute" has the name of the attribute.
es: Significa que la cadena encontrada es el valor de un atributo traducible. La entrada «atributo» contiene el nombre del atributo.

note: type: textblock
en: It must return the text that will replace the original in the translated document. Here's a basic example of this function:
es: Debe devolver el texto que reemplazará al original en el documento traducido. Aquí hay un ejemplo básico de ésta función:

note: type: textblock
en: There's another simple example in the new Dia module, which only filters some strings.
es: Aquí tiene otro ejemplo simple en el nuevo módulo Dia, que sólo filtra algunas cadenas.

note: type: =head2
en: MODIFYING TAG TYPES (TODO)
es: MODIFICAR LOS TIPOS DE ETIQUETA (PENDIENTE)

note: type: textblock
en: This is a more complex one, but it enables a (almost) total customization.  It's based on a list of hashes, each one defining a tag type's behavior. The list should be sorted so that the most general tags are after the most concrete ones (sorted first by the beginning and then by the end keys). To define a tag type you'll have to make a hash with the following keys:
es: Esta personalización es más compleja, pero le permite una personalización (prácticamente) total. Está basada en una lista de tablas de elementos asociativos («hash»), cada una de las cuales define el comportamiento de un tipo de etiqueta. La lista debe estar ordenada para que las etiquetas más generales estén después de las más concretas (ordenado primero por la llave «beginning» y luego por la llave «end»). Para definir un tipo de etiqueta debe construir un «hash» con las siguientes llaves:

note: type: textblock
en: Specifies the beginning of the tag, after the "E<lt>".
es: Especifica el principio de la etiqueta, después de «E<lt>».

note: type: textblock
en: Specifies the end of the tag, before the "E<gt>".
es: Especifica el final de la etiqueta, antes de «E<gt>».

note: type: textblock
en: It says if this is a breaking tag class.  A non-breaking (inline) tag is one that can be taken as part of the content of another tag.  It can take the values false (0), true (1) or undefined.  If you leave this undefined, you'll have to define the f_breaking function that will say whether a concrete tag of this class is a breaking tag or not.
es: Indica si esta clase de etiqueta rompe la secuencia. Una etiqueta en línea («inline») que no rompe la secuencia es uno que se puede tomar como parte del contenido de otra etiqueta. Puede tomar los valores falso (0), verdadero (1) o indefinido. Si se deja indefinido, deberá definir la función «f_breaking», que indicará si una etiqueta de esta clase en concreto rompe o no la secuencia.

note: type: textblock
en: It's a function that will tell if the next tag is a breaking one or not.  It should be defined if the B<breaking> option is not.
es: Es una función que dirá si la siguiente etiqueta rompe o no. Debe definirla si la opción B<breaking> no lo está.

note: type: textblock
en: If you leave this key undefined, the generic extraction function will have to extract the tag itself.  It's useful for tags that can have other tags or special structures in them, so that the main parser doesn't get mad.  This function receives a boolean that says if the tag should be removed from the input stream or not.
es: Si deja esta llave indefinida, la función de extracción genérica deberá extraer la etiqueta por si misma. Es útil con etiquetas que pueden contener otras etiquetas o estructuras especiales dentro, y que pueden confundir al analizador principal. Esta función recibe un booleano que indica si la etiqueta se debe eliminar del documento de entrada o no.

note: type: textblock
en: This function receives the tag (in the get_string_until() format) and returns the translated tag (translated attributes or all needed transformations) as a single string.
es: Esta función devuelve la etiqueta (en el formato «get_string_until()») y devuelve la etiqueta traducida (atributos y toda la información necesaria traducidos) como una única cadena.

note: type: =head2
en: WORKING WITH TAGS
es: TRABAJAR CON ETIQUETAS

note: type: textblock
en: This function returns the path to the current tag from the document's root, in the form E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.
es: Esta función devuelve la ruta hasta la etiqueta actual desde la raíz del documento, con la forma E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.

note: type: textblock
en: An additional array of tags (without brackets) can be passed as argument.  These path elements are added to the end of the current path.
es: Puede introducir como argumento una lista adicional de etiquetas (sin corchetes). Estos elementos de ruta se añaden la final de la ruta actual.

note: type: textblock
en: This function returns the index from the tag_types list that fits to the next tag in the input stream, or -1 if it's at the end of the input file.
es: Esta función devuelve el índice de la lista «tag_types» que encaja con la siguiente etiqueta en el documento de entrada, o «-1» si está al final del fichero.

note: type: textblock
en: Here, the tag has structure started by E<lt> and end by E<gt> and it can contain multiple lines.
es: Aquí, la etiqueta presente una estructura iniciada por E<lt> y finalizada por E<gt>, y puede contener varias líneas.

note: type: textblock
en: This works on the array C<< @{$self->{TT}{doc_in}} >> holding input document data and reference indirectly via C<< $self->shiftline() >> and C<< $self->unshiftline($$) >>.
es: Esto funciona con la matriz C<< @{$self->{TT}{doc_in}} >> que contiene los datos de documento de entrad y su referencia indirecta mediante C<< $self->shiftline() >> y C<< $self->unshiftline($$) >>.

note: type: textblock
en: This function returns the next tag from the input stream without the beginning and end, in an array form, to maintain the references from the input file.  It has two parameters: the type of the tag (as returned by tag_type) and a boolean, that indicates if it should be removed from the input stream.
es: Esta función devuelve la próxima etiqueta del documento de entrada sin el principio ni el final, en forma de vector («array»), para mantener las referencias del fichero de entrada. Tiene dos parámetros: el tipo de la etiqueta (tal como devuelve «tag_type») y un booleano, que indica si se debe eliminar del fichero de entrada.

note: type: textblock
en: This function returns the name of the tag passed as an argument, in the array form returned by extract_tag.
es: Esta función devuelve el nombre de la etiqueta introducida como argumento, en la forma de vector devuelta por «extract_tag».

note: type: textblock
en: This function returns a boolean that says if the next tag in the input stream is a breaking tag or not (inline tag).  It leaves the input stream intact.
es: Esta función devuelve un booleano que indica si la siguiente etiqueta del documento de entrada es una etiqueta que rompe o no (es una etiqueta en línea). Esto deja el documento de entrada intacto.

note: type: textblock
en: This function translates the next tag from the input stream.  Using each tag type's custom translation functions.
es: Esta función traduce la siguiente etiqueta del documento de entrada. Usa las funciones de traducción personalizadas de cada tipo de etiqueta.

note: type: textblock
en: This function returns a string value that says if the first argument (a tag hierarchy) matches any of the tags from the second argument (a list of tags or tag hierarchies). If it doesn't match, it returns 0. Else, it returns the matched tag's options (the characters in front of the tag) or 1 (if that tag doesn't have options).
es: Esta función devuelve una cadena que dice si el primer argumento (una jerarquía de etiquetas) encaja con alguna de las etiquetas del segundo argumento (una lista de etiquetas o jerarquías de etiqueta). Si no encaja, devuelve cero. De otra forma, devuelve las opciones de la etiqueta emparejada (los caracteres delante de la etiqueta) o 1 (si la etiqueta no tiene opciones).

note: type: =head2
en: WORKING WITH ATTRIBUTES
es: TRABAJAR CON ATRIBUTOS

note: type: =head2
en: WORKING WITH TAGGED CONTENTS
es: TRABAJAR CON CONTENIDO ETIQUETADO

note: type: textblock
en: This function gets the text until the next breaking tag (not inline) from the input stream.  Translate it using each tag type's custom translation functions.
es: Esta función obtien el texto hasta la siguiente etiqueta de ruptura (no en línea) del flujo de entrada. Traduzca utilizando cada función de traducción personalizada de tipo de etiqueta.

note: type: =head2
en: WORKING WITH THE MODULE OPTIONS
es: TRABAJAR CON LAS OPCIONES DEL MÓDULO

note: type: textblock
en: This function fills the internal structures that contain the tags, attributes and inline data with the options of the module (specified in the command-line or in the initialize function).
es: Esta función llena las estructuras internas que contienen las etiquetas, atributos y datos de elementos en línea con las opciones del módulo (especificadas en la línea de órdenes o en la función «initialize»).

note: type: =head2
en: GETTING TEXT FROM THE INPUT DOCUMENT
es: OBTENER TEXTO DEL DOCUMENTO DE ENTRADA

note: type: textblock
en: This function returns an array with the lines (and references) from the input document until it finds the first argument.  The second argument is an options hash. Value 0 means disabled (the default) and 1, enabled.
es: Esta función devuelve una lista con las lineas (y referencias) del documento de entrada hasta que encuentra el primer argumento. El segundo argumento es una tabla «hash» de opciones. El valor de cero significa desactivado (valor predefinido) y 1, activado.

note: type: textblock
en: The valid options are:
es: Las opciones válidas son:

note: type: textblock
en: This makes the returned array to contain the searched text
es: Esto hace que la lista retornada contenga la cadena buscada

note: type: textblock
en: This removes the returned stream from the input
es: Esto elimina el flujo devuelto de la entrada

note: type: textblock
en: This ensures that the searched text is outside any quotes
es: Esto asegura que el texto buscado se encuentra fuera de cadenas entrecomilladas

note: type: textblock
en: This function receives as argument the reference to a paragraph (in the format returned by get_string_until), skips his heading spaces and returns them as a simple string.
es: Esta función recibe como argumento la referencia a un párrafo (en el formato devuelto por «get_string_until»), omite los espacios de la cabecera y los devuelve como una cadena simple.

note: type: textblock
en: This function returns a simple string with the text from the argument array (discarding the references).
es: Esta función devuelve una cadena simple con el texto de la lista del argumento (descartando las referencias).

note: type: textblock
en: This module can translate tags and attributes.
es: Este módulo puede traducir etiquetas y atributos.

note: type: textblock
en: DOCTYPE (ENTITIES)
es: DOCTYPE (ENTIDADES)

note: type: textblock
en: There is a minimal support for the translation of entities. They are translated as a whole, and tags are not taken into account. Multilines entities are not supported and entities are always rewrapped during the translation.
es: Existe una mínima compatibilidad con la traducción de entidades. Se traducen en conjunto, y no se tienen en cuenta las etiquetas. Las entidades multi-línea no son compatibles y siempre se justifican las entidades durante la traducción.

note: type: textblock
en: MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside the $self hash?)
es: MODIFICAR LOS TIPOS DE ETIQUETA DE LOS MÓDULOS HEREDADOS (¿mover la estructura «tag_types» dentro de la tabla hash $self?)
