Provided by: txt2tags_2.6-3_all bug

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)