Linux Certif

Toute la documentation sur la certification Linux LPI

txt2tags

NOMBRE

txt2tags - Herramienta de formateo y conversión de texto

SINOPSIS

txt2tags [OPCIÓN]... [ARCHIVO]...

DESCRIPCIÓN

txt2tags es una herramienta GLP de conversión de formatos, escrita en Pyton, que genera documentos HTML, XHTML, SGML, LaTeX, Lout, Man Page, MoinMoin, MagicPoint y PageMaker a partir de un simple archivo de texto mínimamente marcado ( p.ej.: texto plano).

El usuario sólo precisa conocer unas pocas y sencillas reglas de marcado, propias de de txt2tags, y escribir sus archivos en texto plano. El programa se encarga de realizar todo el trabajo, añadiendo las marcas necesarias y arreglándose con los problemas que pueda presentar el archivo de salida.

El mismo archivo de texto puede ser convertido a todos y cada uno de los formatos de salida, sin necesidad de tener que editarlo cada vez. Éste es el propósito de txt2tags : UN archivo fuente, MÚLTIPLES archivos finales.

Visitad la página del programa, que se encuentra en: http://txt2tags.sourceforge.net.

OPCIONES

 -C, --config-file

Lee la configuración desde un archivo externo (actúa cómo %!includeconf)

     --css-sugar

Inserta CSS-friendly tags para archivos de salida HTML y XHTML

     --css-inside

Inserta el contenido de un archivo CSS en el encabezamiento HTML/XHTML

     --dump-config

Imprime toda la configuración encontrada y sále.

     --dump-source

Imprime el documento fuente, con las inclusiones expandidas

     --encoding

Elige la codificación del archivo de salida (UTF-8, ISO-8859-1, etc)

     --gui

Lanza la Interfaz Gráfica TK

 -h, --help

Imprime la información de ayuda y sále

 -H, --no-headers

Suprime el encabezamiento, título y pié de página

     --headers

Muestra el encabezamiento, título y pié de página (por defecto, ON)

 -i, --infile=FILE

Toma FILE como nombre del archivo de entrada ('-' para STDIN)

     --mask-email

Oculta email a los robots de spam. < x@y.z > se convierte en < x (a) y z >

 -n, --enum-title

Numera todos los títulos: 1, 1.1, 1.1.1, etc

     --no-dump-config

Desactiva dump config

     --no-dump-source

Desactiva dump source

     --no-encoding

Excluye la configuración de encoding

     --no-enum-title

Desactiva la numeración de títulos

     --no-infile

Suprime las anteriores declaraciones infile

     --no-mask-email

Muestra emails. Desactiva la opción --mask-email

     --no-outfile

Suprime las anteriores declaraciones outfile

     --no-quiet

Muestra mensajes. Desactiva la opción --quiet

     --no-rc

No lee el archivo de configuración de usuario ~/.txt2tagsrc

     --no-style

Suprime la declaración de estilo

     --no-toc

No añade índice de contenidos TOC (Table of Contents) al documento final

     --no-toc-only

Desactiva la opción --toc-only

 -o, --outfile=FILE

Toma FILE como el nombre del archivo de salida ('-' para STDOUT)

 -q, --quiet

Modo silencioso, suprime todas las salidas (excepto errores)

     --rc

Lee el archivo de configuracion de usuario ~/.txt2tagsrc (por defecto, ON)

     --style=FILE

Usa FILE como documento de estilo (cómo HTML CSS)

-t, --target

Define el tipo de documento final. Actualmente las opciones son: html, xhtml, sgml, tex, lout, man, mgp, moin, pm6, txt

     --toc

Añade índice de contenidos, TOC (Table of Contents) al documento final

     --toc-level=N

Define en N el nivel máximo (profundidad) del índice de contenidos

     --toc-only

Imprime el índice de contenidos (TOC) y sále

 -v, --verbose

Imprime los mensajes de información durante la conversión

 -V, --version

Imprime la versión del programa y sále

Por defecto, el archivo de salida es salvado en 'file.<type>'. Usar --outfile para forzar un nombre de archivo de salida. Si el archivo de entrada es '-', lee de STDIN. Si el archivo de salida es '-', vuelca el archivo de salida en STDOUT.

ESTRUCTURA

Un archivo fuente txt2tags puede tener tres áreas:

Encabezamiento

Las tres primeras líneas. Son usadas para la identificación del documento. Si no precisas encabezamientos, puedes dejar en blanco la primera línea o mediante la opción no-header .

Configuraciones

Se inician a partir de la cuarta línea. Todas las configuraciones siguen el formato: %!clave: valor. Las configuraciones también pueden hacerse mediante archivos de configuración o línea de comandos.

Cuerpo

Es el documento en si. Es la única área imprescindible para tener un archivo txt2tags válido.

CONFIGURACIÓN

La conversión de un archivo fuente puede personalizarse por dos vias: externa o interna. Externamente, las configuraciones pueden ser tomadas de un archivo RC (~/.txt2tagsrc) o importadas de otro archivo de configuración definido por el usuario. Internamente, la personalización se realiza mediante comandos de configuración especiales en el mismo documento fuente. En ambos métodos se utiliza la misma sintaxis:

%!target:

Define el formato destino (target) principal

%!options(target):

Define las opciones de cada destino

%!include: file.t2t

Incluye un archivo txt2tags en el documento

%!include: ``file.txt``

Incluye un archivo de texto (verbatim) en el documento

%!include: ''file.html''

Incluye un archivo de forma "literal" en el documento, eso és, "tal cómo está"

%!style:

Define un archivo CSS (Cascading Style Sheets) para archivos finales del tipo XHTML y HTML o para cargar los módulos (\usepackage) en un archivo destino tipo TEX

%!encoding:

Para elegir la codificación de carácteres del archivo final (como ISO-8859-1) para usuarios de lengua no-inglesa

%!includeconf:

Usado para incluir, el en archivo corriente, una configuración a partir de un archivo externo.

%!guicolors:

Configuración de los colores para la interfaz GUI (tk/tcl)

%!preproc:

Para definir los propios filtros (macros) que serán procesados ANTES de procesar el documento

%!postproc:

Para definir los propios filtros (macros) que serán procesados DESPUÉS de procesar el documento

REGLAS DE LAS CONFIGURACIONES

*

Las configuraciones son sólo vàlidas en el Área de Configuración y serán consideradas comentarios si se encuentran en el Área del Cuerpo

*

Si aparece la misma palabra clave más de una vez en una misma Área de Configuración, la última hallada será la que se utilizará. Excepciones: options, preproc, postproc, que son acumulativas.

*

Una línea de configuración con una palabra clave inválida, será considerada un comentario.

*

Éstas configuraciones tienen precedencia sobre el archivo txt2tagsrc, pero no sobre las opciones en línea de comando.

SINTAXIS

Se utiliza una sencilla sintaxis de marcas en el archivo fuente ( el archivo de texto plano) para identificar las estructuras y el formato. Ésta es la lista completa:

Básicas

   Encabezamiento      Las primeras 3 líneas del archivo fuente
   Título             = palabras =
   Título numerado    + palabras +
   Párrafo            palabras
 

Modificadores de Fuentes

   Negrita             **palabras**
   Italic (cursiva)    //palabras//
   Subrayado           __palabras__
   Monoespaciado       ``palabras``
 

Bloques de Texto

   Cita                  <TAB>palabras
   Lista                 - palabras
   Lista numerada        + palabras
   Lista de definición   : palabras
   Línea verbatim        ``` palabras
   Zona verbatim         ```<Retono (/n)> lìneas <Retorno (/n)>```
   Línea raw             """ palabras
   Zona raw              """<Retorno (/n)> lines <Retorno (/n)>"""
   Tabla                 | celda1 | celda2 | celda3...
 

Otras

   Línea de separación    -----------------------...
   Línea gruesa           =======================...
   Enlaces (links)        [etiqueta url]
   Imagen                 [archivo.jpg]
   Texto raw              ""palabras""
   Comentario             % comentarios
 

Leer la Guía del Usuario de txt2tags para una descripción mas detallada de cada marca

EJEMPLOS

Asumiendo que hayas creado el archivo marcado file.t2t, veamos cómo operar para proceder a su conversión:

Convertir a HTML (archivo final: file.html)

$ txt2tags -t html file.t2t

Lo mismo, usando redireccionamiento

$ txt2tags -t html -o - file.t2t > file.html

Incluyendo un Índice de Contenidos (TOC)

$ txt2tags -t html --toc file.t2t

Incluyendo TOC y títulos numerados

$ txt2tags -t html --toc --enum-title file.t2t

Vista rápida del Índice de Contenidos

$ txt2tags --toc-only file.t2t

Comprobación on-line rápida através de STDIN

$ (echo ; echo "**bold**") | txt2tags -t html -H -

Utilización de la interfaz gráfica

$ txt2tags --gui file.t2t

TRUCOS

Existen algunos trucos que hacen de text2tags una excelente herramienta para el tratamiento de documentos:

Anclas

Los títulos pueden tener enlaces con anclas, lo que nos permitira llegar directamente a ellos, si el formato del documento final lo permite:

   Título             = palabras =[ancla]
   Título numerado   + palabras +[ancla]
 

Archivos múltiples

txt2tags puede convertir a más de un archivo a la vez :

   txt2tags *.t2t
 

MACROS

%%date

Permite incluir la fecha en curso, en el formato YYYYMMDD. Puede definirse un formato opcional utilizando la sintaxis: %%date(cadena-formato)

%%infile

Utilizado para obtener información sobre el fichero fuente. Admite formatos opcionales especificados por la sintaxis: %%infile(cadena-formato) .

Útil como enlace a pié de página cómo [Ver archivo fuente %%infile], de este modo podrás cambiar el nombre del archivo y la refencia será actualizada.

%%mtime

Nos da información sobre la fecha de modificación del archivo fuente. Utiliza el mismo formato que la macro %%date.

%%outfile

Utilizado para obtener información sobre el archivo convertido. Admite formatos opcionales utilizando la sintaxis: %%outfile(cadena-formato)

Útil para indicar cosas como: "Este es el archivo de salida manpage-es.man ", Podemos cambiar el nombre del archivo y su referéncia sera actualizada .

%%toc

%%toc especifica donde se emplaza el Índice de matérias (TOC). Puede situarse en cualquier lugar del documento.

NOTE: %%toc sólo sera procesada con la opción --toc .

AUTOR

Escrito y mantenido por Aurelio Jargas <verde@aurelio.net>

Éste Manual fué escrito por Jose Inacio Coelho <jic@technologist.com> como un fichero de texto, y convertido al formato man por txt2tags!

La traducción al español fué realizada por Antoni Serra Devecchi <antoni.serra@gmail.com>

COPYRIGHT

Copyright (C) 2001, 2002, 2003, 2004, 2005 Aurelio Jargas

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.