Provided by:
txt2tags_2.6-3_all 
NOMBRE
txt2tags - Herramienta de formateo y conversion de texto.
SINOPSIS
txt2tags [opciones] [ARCHIVO...]
DESCRIPCI'ON
txt2tags lee un archivo de texto que ha sido minimamente marcado y lo
convierte a los siguientes formatos: ASCII Art, AsciiDoc, Creole,
DocBook, DokuWiki, Google Code Wiki, HTML, LaTeX, Lout, MagicPoint, Man
page, MoinMoin, PageMaker, Plain Text (Texto Plano), PmWiki, SGML,
Wikipedia and XHTML.
Esta pagina de manual (Man page) fue creada con txt2tags a partir de un
archivo de texto plano. El mismo archivo de texto fue tambien
convertido en un archivo HTML para generar la version online de este
manual.
UNA unica fuente, MULTIPLES formatos de salida - http://txt2tags.org
MARCADO
Encabezado Las primeras tres lineas del archivo fuente.
Titulo = texto =
Titulo numerado + texto +
Comentario % comentarios
Linea de separacion -----------------------...
Linea gruesa =======================...
Imagen [nombre.jpg]
Enlace [etiqueta url]
Negrita **texto**
Cursiva //texto//
Subrayado __texto__
Tachado --texto--
Monoespacio ``texto``
Raw ""texto""
Etiquetado ''texto''
Parrafo texto
Cita <TAB>texto
Lista - texto
Lista numerada + texto
Lista de definicion : texto
Tabla | celda1 | celda2 | celda3...
Linea verbatim ``` texto
Linea Raw """ texto
Linea Etiquetada ''' texto
Bloque Verbatim ```
lineas
```
Bloque Raw """
lineas
"""
Bloque etiquetado '''
lineas
'''
OPCIONES
-C, --config-file=ARCHIVO
Lee la configuracion desde el archivo externo especificado en
ARCHIVO. La configuracion debe estar en formato %!keyword:value
. Para mas detalles, vease la seccion AJUSTES.
--css-sugar
Mejora el codigo HTML/XHTML generado para poder usar archivos
CSS. Se eliminan los atributos de las etiquetas, se ignoran las
etiquetas de presentacion, los encabezados se generan con
etiquetas H1, H2 y H3 y se crean nuevas DIVs : #header, #body,
.toc.
--css-inside
Inserta el contenido de un archivo CSS en el encabezado
HTML/XHTML. Usar --style para especificar el archivo CSS que
debe leerse.
--dump-config
Muestra toda la configuracion encontrada y sale.
--dump-source
Muestra el documento fuente, con todas sus inclusiones
(%!include) expandidas.
--encoding=C'ODIGO
Establece la configuracion de caracteres del archivo de salida
usando la establecida en C'ODIGO. Ejemplos de C'ODIGO: UTF-8 y
iso-8859-1.
--gui
Llama la Interfaz Grafica Tk.
-h, --help
Muestra la informacion de ayuda y sale.
-H, --no-headers
Elimina los encabezados y los pies de pagina del archivo de
salida. Solo se mostraran los contenidos (cuerpo del documento).
--headers
Muestra los encabezados y pies de pagina del archivo de salida.
Por defecto: ON.
--height=NUM
Fija el numero de lineas del archivo de salida al senalado en
NUM. Esta opcion solo se usa en formatos de salida ASCII Art,
cuando tambien se este usando --slides.
-i, --infile=ARCHIVO
Toma ARCHIVO como archivo fuente. Usar '-' para leer la fuente
desde STDIN.
--mask-email
Oculta los emails a los robots de spam. Elimina @ y puntos. La
direccion foo@bar.com se convierte en <foo (a) bar com>.
-n, --enum-title
Activa la numeracion automatica de los titulos. Esta prefijada
en: 1, 1.1, 1.1.1, ...
--no-dump-config
Cancela la accion --dump-config.
--no-dump-source
Cancela la accion --dump-source.
--no-encoding
Elimina la configuracion de caracteres.
--no-enum-title
Desactiva la numeracion automatica de los titulos.
--no-infile
Elimina toda anterior declaracion --infile.
--no-targets
Elimina la accion --targets.
--no-mask-email
Desactiva la ocultacion de emails.
--no-outfile
Elimina toda anterior declaracion --outfile.
--no-quiet
Muestra los mensajes, desactiva la opcion --quiet.
--no-rc
No leer en el archivo de configuracion del usuario
~/.txt2tagsrc.
--no-slides
Desactiva --slides.
--no-style
Elimina todos los ajustes de estilo.
--no-toc
Elimina la Tabla de Contenidos (TOC) en el archivo de salida.
--no-toc-only
Desactiva la accion --toc-only.
-o, --outfile=ARCHIVO
Toma ARCHIVO como nombre del archivo de salida. Usar '-' para
dirigir los resultados a STDOUT.
-q, --quiet
Modo silencioso. Suprime todos los mensajes del sistema, excepto
los de error.
--rc
Lee el archivo de configuracion (ajustes) del usuario
~/.txt2tagsrc. Por defecto: ON.
--slides
Formatea el archivo de salida como una presentacion de
diapositivas. Esta opcion se usa solo en formatos de salida
ASCII Art.
--style=ARCHIVO
Usa ARCHIVO como el archivo que contiene el estilo del
documento. Usado para definir archivos CSS en documentos
HTML/XHTML y ''modulos'' para LaTeX. Esta opcion puede usarse
multiples veces para incluir multiples archivos de estilo.
-t, --target=TIPO
Fija el formato de documento de salida al establecido en TIPO.
Los formatos de documento mas corrientes son: html, xhtml,
tex, man, txt. Usar la opcion --targets para ver los formatos
disponibles.
--targets
Muestra los formatos disponibles para los archivos de salida y
sale.
--toc
Incluye, automaticamente, una Tabla de Contenidos (TOC) en el
archivo de salida, entre el encabezado (HEADER) y el cuerpo del
documento (BODY). El usuario puede especificar la posicion de la
TOC usando el macro %%TOC.
--toc-level=NUM
Fija el nivel maximo de la Tabla de Contenidos (TOC) al numero
especificado en NUM. Los niveles inferiores a NUM no seran
incluidos en la tabla de contenidos.
--toc-only
Muestra la Tabla de Contenidos (TOC) y sale.
-v, --verbose
Muestra los mensajes del sistema durante la conversion. Esta
opcion puede usarse multiples veces para incrementar el numero
de mensajes a mostrar.
-V, --version
Muestra la version del programa y sale.
--width=NUM
Fija al numero especificado en NUM la anchura de las columnas
del archivo de salida. Esta opcion se usa solo con archivos de
salida en formato ASCII Art.
ARCHIVO FUENTE
Los archivos fuente suelen identificarse por la extension .t2t (por
ejemplo, miarchivo.t2t). En un archivo fuente podemos considerar tres
areas:
Encabezado (opcional)
Las tres primeras lineas del archivo. Si no se necesitara
encabezado, dejar la primera linea en blanco. Esta area suele
utilizarse para emplazar el titulo del documento y la
informacion sobre el autor, la version y la fecha.
Ajustes (opcional)
Comienzan justo despues del Encabezado (4a linea, o 2a linea en
el caso de omitir el encabezado) y finalizan al comienzo del
area de Cuerpo del Documento.. Usados para para implementar
ajustes (configuraciones) en formato %!keyword:value.
Cuerpo del Documento
Comienza con la primera linea de texto valido (que no sea
comentario o ajustes) despues del Encabezado y se extiende hasta
el final del documeno. En esta area es en la que se encuentra el
contenido del documento.
AJUSTES
Los Ajustes nos permiten personalizar txt2tags; son similares a las
opciones. Pueden emplazarse: en el area de Ajustes del documento
fuente, en el archivo ~/.txt2tagsrc o en un archivo externo que se
invoca mediante la opcion --config-file.
%!target
Define el formato del archivo de salida, tal como lo haria la
opcion --target. Ejemplo:
%!target: html
%!options(tipo)
Define las opciones por defecto para cada tipo de archivo de
salida. Deben usarse las opciones de linea de comandos (las que
empiezan por -- ). Ejemplo:
%!options(html): --toc --toc-level 3 --css-sugar
%!includeconf
Incluye, en el archivo en uso, las configuraciones definidas en
un archivo externo, tal como lo haria la opcion --config-file.
Ejemplo:
%!includeconf: miconfig.t2t
%!style
Utiliza un archivo de estilo externo en el documento en uso, tal
como lo haria la opcion --style. Puede utilizarse multiples
veces. Ejemplo:
%!style: colores.css
%!encoding
Define la codificacion de caracteres que se utilizara en el
documento convertido, tal como lo haria la opcion --encoding.
Ejemplo :
%!encoding: UTF-8
%!preproc
Filtro input de buscar/reemplazar utilizado para realizar
cambios en el cuerpo del documento fuente ANTES de que txt2tags
realice cualquier accion. La busqueda utiliza expresiones
regulares de Python. Ejemplo:
%!preproc: "JJS" "John J. Smith"
%!postproc
Filtro output de buscar/reemplazar utilizado para realizar
cambios en el documento generado DESPUES del completo
procesamiento del archivo fuente por txt2tags. La busqueda
utiliza expresiones regulares de Python. Ejemplo:
%!postproc(html): "<B>" "<STRONG>"
Si la misma palabra clave aparece mas de una vez, la ultima encontrada
sera que se utilizara (excepciones: opciones, preproc y postproc, que
son acumulativas). Las palabras clave invalidas seran ignoradas. El
orden de procesamiento es: ~/.txt2tagsrc, area de Ajustes del
documento fuente, opcion --config-file.
COMANDOS
Los Comandos ejecutan tareas durante el proceso de conversion. Deben
emplazarse en el cuerpo del documento fuente.
%!csv: archivo.csv
Incorpora un archivo CSV como una tabla.
%!include: archivo.t2t
Incorpora al documento un archivo txt2tags.
%!include: ``archivo.txt``
Incorpora en el documento un archivo de texto (verbatim).
%!include: ''archivo.html''
Incorpora al documento un archivo etiquetado.
MACROS
Mediante las Macros podremos insertar, de una forma facil, contenidos
dinamicos en el documento convertido. Deben definirse en el cuerpo del
documento fuente. Con la excepcion de %%toc, todos las macros pueden
ser personalizadas con directivas especiales, tales como %Y y %f.
Para mas detalles, consultar la Guia del Usuario de txt2tags.
%%date Inserta la fecha actual. Su formato por defecto es:
%%date(%Y%m%d), que nos mostrara la fecha como: AAAAMMDD.
%%infile
Inserta la ruta del archivo fuente. Su formato por defecto es:
%%infile(%f). Util para enlaces del tipo: [Ver fuente
%%infile].
%%mtime
Inserta la fecha de modificacion del archivo fuente. Su formato
por defecto es: %%date(%Y%m%d), que nos mostrara la fecha como
AAAAMMDD.
%%outfile
Inserta la ruta del archivo final. Su formato por defecto es:
%%outfile(%f). Util en menciones del tipo: "Este es el archivo
manpage-es.man".
%%toc Con ella el usuario puede especificar la ubicacion de la Tabla
de Contenidos (TOC). Puede utilizarse repetidas veces. Debe
utilizarse conjuntamente con la opcion --toc.
EJEMPLOS
txt2tags -t html archivo.t2t
Convierte a HTML, guardando el resultado como archivo.html.
txt2tags -t html -o - archivo.t2t
Convierte a HTML, mostrando el resultado en STDOUT.
txt2tags -t html --toc archivo.t2t
Convierte a HTML, generando una Tabla de Contenidos (TOC) de
forma automatica.
txt2tags -t html --toc --toc-level 2 -n archivo.t2t
Convierte a HTML, con una Tabla de Contenidos (TOC) a dos
niveles y titulos numerados.
txt2tags --toc-only archivo.t2t
Solo nos muestra la Tabla de Contenidos (TOC), sin realizar
conversion alguna en el documento fuente.
txt2tags -t html --css-sugar --style base.css --style ui.css
archivo.t2t
Convierte a HTML, preparando el codigo resultante para poder
utilizar CSS, incluyendo tambien una llamada a dos archivos CSS
externos (base.css y ui.css).
txt2tags -t art --slides --width 80 --height 25 -o - archivo.t2t | more
Crea una presentacion de diapositivas tipo ASCII Art, apta para
ser visionada en un terminal pantalla/ventana 80x25.
(echo ; echo "**bold**") | txt2tags -t html -H -
Practica forma de realizar comprobaciones rapidas usando STDIN.
txt2tags -t html -o - archivo.t2t | tidy > archivo.html
Envia el resultado a STDOUT, desde donde se le redirige a un
programa externo (tidy) antes de ser guardado.
ARCHIVOS
~/.txt2tagsrc
Archivo de configuracion del usuario, por defecto.
ENTORNO
T2TCONFIG
Si no es nulo, define el pathname completo para el archivo de
configuracion del usuario por defecto.
AUTOR
Aurelio Jargas <verde@aurelio.net>
Traduccion al espanol realizada por Antoni Serra Devecchi
<antoni.serra@gmail.com>
BUGS
http://bugs.txt2tags.org
COPYRIGHT
Copyright (C) 2001-2010 Aurelio Jargas, GNU GPL v2
Aug, 2010 TXT2TAGS(1)