PDF de programación - Txt2tags: Guia del Usuario de Txt2tags

Guia del Usuario de Txt2tags

http://txt2tags.sf.net

Aurélio Marinho Jargas v2.3 (May 2005)

Traducción al español: Antoni Serra Devecchi (Júl 2005)

Contenido

Parte I − Introducción a Txt2tags.........................................................................................................1
Tus Primeras Preguntas.............................................................................................................1
Estructuras de Formato Soportadas por txt2tags.......................................................................2
Formatos de salida soportados..................................................................................................3
Estructuras Soportadas en los Archivos finales.........................................................................4
Las tres interfaces de usuario: GUI, Web y Línea de Comandos...............................................5

Parte II: − OK!, Quiero utilizar el programa. ¿Que debo hacer ?.......................................................9
Obtener e instalar Python...........................................................................................................9
Obtener Txt2tags........................................................................................................................9
Instalar txt2tags..........................................................................................................................9
Instalación de los Archivos de Sintaxis para los Editores de Texto..........................................10

Parte III − Escribiendo y convirtiendo vuestro primer documento.................................................11
Probar las herramientas...........................................................................................................11
Escribir el encabezamiento del documento..............................................................................11
La Primera Conversión : La Interfaz Gráfica............................................................................11
La Primera Conversión: Interface en Línea de Comandos.......................................................12
Comprobar el resultado............................................................................................................13
Escribir el cuerpo del documento.............................................................................................13

Parte IV − Dominando los Conceptos de Txt2tags...........................................................................15
Las Áreas de un Documento .t2t..............................................................................................15
Área de Encabezamiento.........................................................................................................16
Area de Configuración..............................................................................................................16
Área del Cuerpo del Documento..............................................................................................17
Configuraciones: ¿Cómo Configurar algo?. ¿Cuál es la sintaxis?...........................................17
Opciones en Línea de Comando..............................................................................................18
Archivo de Configuracion del Usuario (RC)..............................................................................18
Orden de Aplicación de las Configuraciones y Precedencia....................................................19
El Comando %!include.............................................................................................................19
El Comando %!includeconf.......................................................................................................21

Part V − Dominando las Marcas.........................................................................................................23
Encabezamiento.......................................................................................................................23
Título y Título Numerado..........................................................................................................24
Párrafo......................................................................................................................................24
Comentario...............................................................................................................................24
Modificadores de Fuentes: Negrita, Itálica y Subrayado..........................................................24
Fuente no Proporcional (Monoespaciada)................................................................................25
Línea Verbatim, Zona Verbatim................................................................................................25
Línea de Separación , Línea Gruesa........................................................................................26
Enlaces, Enlaces nombrados...................................................................................................26
Cita...........................................................................................................................................26
Listas, Listas Numeradas, Listas de Definición........................................................................27
Imágen......................................................................................................................................27
Tabla.........................................................................................................................................27
Raw,Líneas y Zonas Raw (tal−cual).........................................................................................28

Parte VI − Dominando las Macros......................................................................................................29
%%date....................................................................................................................................29
%%mtime..................................................................................................................................30
%%infile....................................................................................................................................30
%%outfile..................................................................................................................................31
%%toc.......................................................................................................................................31

i

Contenido

Parte VII − Dominando las Directivas de Configuración..................................................................33
%!Target...................................................................................................................................33
%!Options.................................................................................................................................33
%!Encoding...............................................................................................................................34
%!PreProc.................................................................................................................................34
%!PostProc...............................................................................................................................35
%!Style......................................................................................................................................35
Definiendo una Configuración para un Tipo de Archivo Destino Específico.............................36
Detalles de los filtros PreProc y PostProc................................................................................36

Parte VIII − Mágia Negra......................................................................................................................39
Insertando Múltiples Líneas con %!PostProc (como reglas CSS)............................................39
Creando Contenido "Específico al Tipo Destino" con %!PreProc.............................................39
Cambiando Marcas txt2tags con %!PreProc............................................................................40

Parte IX − História de Txt2tags...........................................................................................................41
Enero de1999: Pre−História.....................................................................................................41
Júnio de 1999: Todavía Pre−História.......................................................................................41
Agosto de 2000: No más Pre−História.....................................................................................41
Mayo 2001: Pythonización e Idea Multi Formato de Destino...................................................42
Júlio de 2001: séries 0.x: Debut de txt2tags (Lanzamiento Mundial).......................................42
Septiembre de 2002: séries 1.x : Crecimiento..........................................................................42
Júlio de 2004: séries 2.x : Maduración.....................................................................................43

ii

Parte I − Introducción a Txt2tags

Tus Primeras Preguntas

Este capítulo presenta txt2tags, introduciendo a las funcionalidades y objetivos del programa.

¿Que és Txt2tags?

Txt2tags es una herramienta de formateo y conversión de texto. Txt2tags convierte un archivo de
texto con algunas marcas a uno de los siguientes tipos de archivo:

•
•
•
•
•
•
•
•
•

Documento HTML
Documento XHTML
Documento SGML
Documento LaTeX
Página man de UNIX
Presentación Magic Point
Página MoinMoin
Documento PageMaker 6.0
Texto plano (sin marcas)

¿Por Qué Debo Usar Txt2tags?

Encontarás txt2tags muy útil si:

•
•
•
•
•
•

precisas publicar documentos en diferentes formatos
precisas manten