NOMBRE¶
txt2tags - Herramienta de formateo y conversión de texto.
SINOPSIS¶
txt2tags [
opciones] [
ARCHIVO...]
DESCRIPCIÓN¶
txt2tags lee un archivo de texto que ha sido mínimamente 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 página de manual (Man page) fué creada con
txt2tags a
partir de un archivo de texto plano. El mismo archivo de texto fué
también convertido en un archivo HTML para generar la versión online
de este manual.
UNA única fuente, MÚLTIPLES formatos de salida -
http://txt2tags.org
MARCADO¶
Encabezado Las primeras tres líneas del archivo fuente.
Título = texto =
Título numerado + texto +
Comentario % comentarios
Línea de separación -----------------------...
Línea gruesa =======================...
Imagen [nombre.jpg]
Enlace [etiqueta url]
Negrita **texto**
Cursiva //texto//
Subrayado __texto__
Tachado --texto--
Monoespacio ``texto``
Raw ""texto""
Etiquetado ''texto''
Párrafo texto
Cita <TAB>texto
Lista - texto
Lista numerada + texto
Lista de definición : texto
Tabla | celda1 | celda2 | celda3...
Línea verbatim ``` texto
Línea Raw """ texto
Línea Etiquetada ''' texto
Bloque Verbatim ```
líneas
```
Bloque Raw """
líneas
"""
Bloque etiquetado '''
líneas
'''
OPCIONES¶
- -C, --config-file=ARCHIVO
- Lee la configuración desde el archivo externo
especificado en ARCHIVO. La configuración debe estar en
formato %!keyword:value . Para mas detalles, véase la
sección AJUSTES.
-
--css-sugar
- Mejora el código HTML/XHTML generado para poder usar
archivos CSS. Se eliminan los atributos de las etiquetas, se ignoran las
etiquetas de presentación, 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 configuración encontrada y sale.
-
--dump-source
- Muestra el documento fuente, con todas sus inclusiones
(%!include) expandidas.
-
--encoding=CÓDIGO
- Establece la configuración de caracteres del archivo
de salida usando la establecida en CÓDIGO. Ejemplos de
CÓDIGO: UTF-8 y iso-8859-1.
-
--gui
- Llama la Interfaz Gráfica Tk.
- -h, --help
- Muestra la información de ayuda y sale.
- -H, --no-headers
- Elimina los encabezados y los piés de página del
archivo de salida. Solo se mostrarán los contenidos (cuerpo del
documento).
-
--headers
- Muestra los encabezados y piés de página del
archivo de salida. Por defecto: ON.
-
--height=NUM
- Fija el número de líneas del archivo de salida al
señalado en NUM. Esta opción solo se usa en formatos de
salida ASCII Art, cuando también se esté 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 dirección foo@bar.com se convierte en <foo (a) bar com>.
- -n, --enum-title
- Activa la numeración automática de los
títulos. Está prefijada en: 1, 1.1, 1.1.1, ...
-
--no-dump-config
- Cancela la acción --dump-config.
-
--no-dump-source
- Cancela la acción --dump-source.
-
--no-encoding
- Elimina la configuración de caracteres.
-
--no-enum-title
- Desactiva la numeración automática de los
títulos.
-
--no-infile
- Elimina toda anterior declaración --infile.
-
--no-targets
- Elimina la acción --targets.
-
--no-mask-email
- Desactiva la ocultación de emails.
-
--no-outfile
- Elimina toda anterior declaración --outfile.
-
--no-quiet
- Muestra los mensajes, desactiva la opción --quiet.
-
--no-rc
- No leer en el archivo de configuración 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 acción --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 configuración (ajustes) del usuario
~/.txt2tagsrc. Por defecto: ON.
-
--slides
- Formatea el archivo de salida como una presentación de
diapositivas. Esta opción 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
´´módulos´´ para LaTeX. Esta opción puede
usarse múltiples veces para incluir múltiples 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 opción
--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 posición de la TOC
usando el macro %%TOC.
-
--toc-level=NUM
- Fija el nivel máximo de la Tabla de Contenidos (TOC)
al número especificado en NUM. Los niveles inferiores a
NUM no serán 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
conversión. Esta opción puede usarse múltiples veces para
incrementar el número de mensajes a mostrar.
- -V, --version
- Muestra la versión del programa y sale.
-
--width=NUM
- Fija al número especificado en NUM la anchura
de las columnas del archivo de salida. Esta opción se usa solo con
archivos de salida en formato ASCII Art.
ARCHIVO FUENTE¶
Los archivos fuente suelen identificarse por la extensión
.t2t (por
ejemplo, miarchivo.t2t). En un archivo fuente podemos considerar tres
áreas:
- Encabezado (opcional)
- Las tres primeras líneas del archivo. Si no se
necesitara encabezado, dejar la primera línea en blanco. Esta
área suele utilizarse para emplazar el título del documento y la
información sobre el autor, la versión y la fecha.
- Ajustes (opcional)
- Comienzan justo después del Encabezado (4ª
línea, o 2ª línea en el caso de omitir el encabezado) y
finalizan al comienzo del área de Cuerpo del Documento.. Usados para
para implementar ajustes (configuraciones) en formato %!keyword:value.
- Cuerpo del Documento
- Comienza con la primera línea de texto válido
(que no sea comentario o ajustes) después del Encabezado y se
extiende hasta el final del documeno. En esta área 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 área de Ajustes del documento fuente,
en el archivo ~/.txt2tagsrc o en un archivo externo que se invoca mediante la
opción --config-file.
- %!target
- Define el formato del archivo de salida, tal como lo haria
la opción --target. Ejemplo:
%!target: html
- %!options(tipo)
- Define las opciones por defecto para cada tipo de archivo
de salida. Deben usarse las opciones de línea 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 opción
--config-file. Ejemplo:
%!includeconf: miconfig.t2t
- %!style
- Utiliza un archivo de estilo externo en el documento en
uso, tal como lo haria la opción --style. Puede utilizarse
múltiples veces. Ejemplo:
%!style: colores.css
- %!encoding
- Define la codificación de caracteres que se
utilizará en el documento convertido, tal como lo haria la
opción --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 acción. La búsqueda 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 DESPUÉS del completo procesamiento
del archivo fuente por txt2tags. La búsqueda utiliza expresiones
regulares de Python. Ejemplo:
%!postproc(html): "<B>" "<STRONG>"
Si la misma palabra clave aparece mas de una vez, la última encontrada
será que se utilizará (excepciones: opciones, preproc y postproc,
que son acumulativas). Las palabras clave inválidas serán ignoradas.
El orden de procesamiento es: ~/.txt2tagsrc, area de Ajustes del documento
fuente, opción --config-file.
COMANDOS¶
Los Comandos ejecutan tareas durante el proceso de conversión. 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 fácil, contenidos
dinámicos en el documento convertido. Deben definirse en el cuerpo del
documento fuente. Con la excepción 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 mostrará la fecha como: AAAAMMDD.
- %%infile
- Inserta la ruta del archivo fuente. Su formato por defecto
es: %%infile(%f). Útil para enlaces del tipo: [Ver fuente %%infile].
- %%mtime
- Inserta la fecha de modificación del archivo fuente.
Su formato por defecto es: %%date(%Y%m%d), que nos mostrará la fecha
como AAAAMMDD.
- %%outfile
- Inserta la ruta del archivo final. Su formato por defecto
es: %%outfile(%f). Útil en menciones del tipo: "Este es el
archivo manpage-es.man".
- %%toc
- Con ella el usuario puede especificar la ubicación de
la Tabla de Contenidos (TOC). Puede utilizarse repetidas veces. Debe
utilizarse conjuntamente con la opción --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
automática.
- txt2tags -t html --toc --toc-level 2 -n archivo.t2t
-
Convierte a HTML, con una Tabla de Contenidos (TOC) a dos niveles y
títulos numerados.
- txt2tags --toc-only archivo.t2t
-
Solo nos muestra la Tabla de Contenidos (TOC), sin realizar conversión
alguna en el documento fuente.
- txt2tags -t html --css-sugar --style base.css --style
ui.css archivo.t2t
-
Convierte a HTML, preparando el código resultante para poder utilizar
CSS, incluyendo también 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 presentación de diapositivas tipo ASCII Art, apta para ser
visionada en un terminal pantalla/ventana 80x25.
- (echo ; echo "**bold**") | txt2tags -t html -H
-
-
Práctica forma de realizar comprobaciones rápidas 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 configuración del usuario, por defecto.
ENTORNO¶
- T2TCONFIG
- Si no es nulo, define el pathname completo para el archivo
de configuración del usuario por defecto.
AUTOR¶
Aurelio Jargas <verde@aurelio.net>
Traducción al español realizada por Antoni Serra Devecchi
<antoni.serra@gmail.com>
BUGS¶
http://bugs.txt2tags.org
COPYRIGHT¶
Copyright (C) 2001-2010 Aurelio Jargas, GNU GPL v2