LOCALE::PO4A::ASCIIDOC.3PM(1) User Contributed Perl Documentation NOMBRE Locale::Po4a::AsciiDoc - Convierte documentos AsciiDoc desde/a ficheros PO DESCRIPCION El objetivo del proyecto po4a (<>, PO para todo) es facilitar la traduccion (y mas interesante, el mantenimiento de las traducciones) usando las herramientas de gettext en ambitos donde no previstos, como la documentacion. Locale::Po4a::AsciiDoc es un modulo que asiste en la traduccion de documentacion en formato AsciiDoc. OPCIONES ACEPTADAS POR ESTE MODULO Estas son las opciones particulares de este modulo: definitions El nombre de un fichero que contiene definiciones para po4a, tal y como se define en la seccion PERSONALIZACION DE OBJETOS EN LINEA. Puede usar esta opcion si no es posible introducir definiciones en el documento que esta traduciendo. En un fichero de definiciones, las lineas no se deben preceder con dos barras, sino directamente con po4a:. entry Una lista separada por espacios de entradas de atributo que quiere traducir. Por omision, ninguna entrada de atributo es traducible. macro Una lista separada por espacios de definiciones de macros. style Una lista separada por espacios de definiciones de estilo. forcewrap Activar el ajuste de linea automatico en bloques no literales, aunque el resultado pueda ser malinterpretado por los formateadores de AsciiDoc. Por defecto, po4a no ajustara los ficheros AsciiDoc producidos porque se requiere una inspeccion manual para asegurar que el ajuste no cambia el formato. Considere por ejemplo el siguiente elemento de la lista: * Una frase larga que termina con un numero 1. Una segunda frase. Si el ajuste de linea conduce a la siguiente presentacion, el elemento se divide en una sublista numerada. Para colmo, solo los hablantes de la lengua utilizada en la traduccion pueden inspeccionar la situacion. * una frase larga que termina con un numero 1. Una segunda frase. Tenga en cuenta que no ajustar los archivos producidos por po4a no deberia ser un problema, ya que esos archivos estan pensados para ser procesados automaticamente. De todas formas, no deberian considerarse archivos fuente. Con esta opcion, po4a producira ficheros AsciiDoc con mejor aspecto, pero puede dar lugar a salidas con formatos posiblemente erroneos. noimagetargets Por defecto, los destinos de las imagenes de bloque son traducibles para dar la oportunidad de hacer que el contenido apunte a imagenes traducidas. Esto se puede detener configurando esta opcion. tablecells Esta opcion es un indicador que habilita segmentacion de sub-tabla dentro del contenido de celda. La segmentacion esta limitada al contenido de la celda, sin ninguna interpretacion dentro de esta. compat Cambia las reglas de analisis para que sean compatibles con diferentes herramientas. Las opciones disponibles son "asciidoc" o "asciidoctor". Asciidoctor tiene reglas de analisis mas estrictas, como la igualdad de longitud de los bloques de apertura y cierre. nolinting Desactivar los mensajes de linting. Cuando el codigo fuente no puede modificarse para que la estructura del documento sea mas clara, estos mensajes son inutiles. cleanspaces Elimine espacios adicionales de los segmentos de origen en modo sin ajuste. Esto es util cuando las herramientas de traduccion son sensibles a la cantidad de espacios. yfm_keys Lista separada por comas de claves a procesar para su traduccion en la seccion YAML Front Matter. Todas las demas claves se omiten. Las claves se comparan distinguiendo entre mayusculas y minusculas. Si yfm_paths y yfm_keys se utilizan conjuntamente, los valores se incluyen si coinciden con al menos una de las opciones. Los valores del array siempre se traducen, a menos que se proporcione la opcion yfm_skip_array. yfm_skip_array No traducir valores de array en la seccion YAML Front Matter. yfm_paths Lista separada por comas de rutas hash a procesar para la extraccion en la seccion YAML Front Matter; todas las demas rutas se omiten. Las rutas se comparan distinguiendo entre mayusculas y minusculas. Si yfm_paths y yfm_keys se utilizan conjuntamente, los valores se incluyen si coinciden con al menos una de las opciones. Siempre se devuelven los valores de los arrays a menos que se proporcione la opcion yfm_skip_array. PERSONALIZACION DE OBJETOS EN LINEA El modulo AsciiDoc se puede personalizar mediante lineas que empiecen con //po4a:. Estas lineas se interpretan como ordenes para el analizador. Se reconocen las siguientes ordenes: //po4a: macro nombre[lista de atributos] Esto describe en detalle los parametros de la orden macro; nombre debe ser una macro valida, y debe finalizar con guion bajo si el objetivo se debe traducir. El argumento lista de atributos es una lista separada por comas que contiene informacion sobre argumentos traducibles. Esta lista contiene o bien numeros, para definir parametros de posicion, o nombres de atributos. Si se prefija el signo de suma (+) a nombre, la macro y sus argumentos se traducen como conjunto. En este caso, no es necesario definir la lista de atributos, pero los parentesis deben estar presentes. //po4a: style [lista de atributos] Esto describe de forma detallada los atributos un estilo que se deben traducir. El argumento lista de atributos es una lista separada por comas que contiene informacion sobre argumentos traducibles. Esta lista contiene o bien numeros, para definir parametros de posicion, o nombres de atributos. El primer atributo es el nombre de estilo, y no se debe traducir. Si se prefija un signo de suma (+) al nombre de estilo, la lista de atributos se traduce en conjunto. No es necesario definir atributos traducibles. Si se prefija un signo de suma (-) al nombre de estilo, entonces este atributo no es traducible. //po4a: entry nombre Esto declara una entrada de atributo como traducible. Por omision, no se traducen. ESTADO DE ESTE MODULO Probado con exito en ficheros simples AsciiDoc. AUTORES Nicolas Francois Denis Barbier TRADUCCION Jordi Vilalta Omar Campagne DERECHO DE COPIA Y LICENCIA Copyright (C) 2005-2008 Nicolas FRANCOIS . Copyright (C) 2012 Denis BARBIER . Copyright (C) 2017 Martin Quinson . Este programa es software libre; puede redistribuirlo y/o modificarlo bajo los terminos de la GPL v2.0 o posterior (consulte el archivo COPYING). perl v5.38.2 2024-06-26 LOCALE::PO4A::ASCIIDOC.3PM(1)