/doc/Spanish/userguide-es/userguide-es.t2t
Unknown | 1927 lines | 1271 code | 656 blank | 0 comment | 0 complexity | 873c13a688e736773604a60bc5c4c5c7 MD5 | raw file
Large files files are truncated, but you can click here to view the full file
1Txt2tags: Guia del Usuario de Txt2tags 2Aurelio, %%mtime(%c) 3Traducción al espańol: Antoni Serra Devecchi 4%!target: html 5%!options: --toc --toc-level 2 --css-sugar 6 7%%!options: -o ../../../web/userguide/userguide.html 8 9% TRANSLATOR: 10% - Don't worry about the PDF cover page 11% - Don't worry about PDF at all, translate and check on HTML 12% - Don't worry about the images 13 14% TRANSLATOR uncomment the next line 15%%!options: -o userguide.html 16 17% TRANSLATOR uncomment the next line to use images on the same folder 18%!preproc: IMGPATH . 19 20% TRANSLATOR: 21% You can take new screenshots and make new images for the program 22% interface and "first conversion" section. Remember to send them 23% to the author! 24 25 26%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 27%%% activate those lines when converting to HTML for PDF generation 28%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 29%%% htmldoc does TOC 30%!options(html): --no-toc --no-css-sugar -o userguide-pdf.html 31%%% mask the 'nopdf' marks so they will not be removed 32%!preproc(html): ^%nopdf %yespdf 33%%% removing first header, htmldoc ignores all until next <H1> (cool!) 34%!postproc(html): '<H1>Txt2tags: .*</H1>' '' 35%%% imagens are in the same dir 36%!preproc: IMGPATH . 37%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 38 39% easy way to change all image locations once, when changing file location 40%!preproc: IMGPATH ../img 41 42% normalizing common text 43%%!preproc: CONFAREA Config Area 44%%!preproc: HEADAREA Header Area 45%%!preproc: BODYAREA Body Area 46%%!preproc: MARKPROP **Properties:** 47%%!preproc: MARKCONT **Contains:** 48%%!preproc: MARKDESC **Description:** 49%%!preproc: MARKSYN **Syntax:** 50%%!preproc: MARKDET **Details:** 51%%!preproc: NOMARKS Marks are NOT interpreted 52%%!preproc: NOMACRO Macros are NOT interpreted 53 54%!preproc: URLMARKUP http://txt2tags.org/markup.html 55 56% activate the areas disabled on the PDF version 57%!preproc(html): ^%nopdf '' 58 59% remove separator lines and strong lines 60%!preproc(html): '^ *--------*' '' 61%!preproc(html): '^ *========*' '' 62 63% highlight NEW topic on TOC 64%%!postproc(html): '(<LI>.*Mastering Macros</A>)$' '\1 <b>[NEW!]</b>' 65 66%%% Little clean up for less large tables 67%!postproc: /pessoal/sourceforge.net '' 68 69% border for all images 70%!postproc: '(<IMG [^>]*BORDER)="0"' '\1="1"' 71 72 73%%% Embedded CSS code (ugly not?) 74% 75%!postproc(html): ^<HEAD>$ '<HEAD>\n<STYLE TYPE="text/css">\n@#@' 76%!postproc(html): (@#@)$ 'body {background-color:#ddeeff; color:black; \n\1' 77%!postproc(html): (@#@)$ ' margin:3em; text-align:justify;} \n\1' 78%!postproc(html): (@#@)$ '#header {text-align:center;} \n\1' 79%!postproc(html): (@#@)$ '.toc {border:1px solid black;padding:9px;\n\1' 80%!postproc(html): (@#@)$ ' background-color:white;} \n\1' 81%!postproc(html): (@#@)$ '.toc li{list-style-type: none;} \n\1' 82%!postproc(html): (@#@)$ 'a {text-decoration:none;}\na:hover {color:red;}\n\1' 83%!postproc(html): (@#@)$ 'a:visited {color:purple;}\ndl {margin:1em;} \n\1' 84%!postproc(html): (@#@)$ '#body h1 {text-align:center; color:white; \n\1' 85%!postproc(html): (@#@)$ ' background-color:blue; padding:8px;} \n\1' 86%!postproc(html): (@#@)$ 'h2 {padding-top:20px;}\nhr {border-style:none;}\n\1' 87%!postproc(html): (@#@)$ 'code {background-color:lightblue;} \n\1' 88%!postproc(html): (@#@)$ 'blockquote {border:1px solid black;padding:9px;\n\1' 89%!postproc(html): (@#@)$ ' background-color:white;} \n\1' 90%!postproc(html): (@#@)$ 'table {border-style:solid; border-color:black;}\n\1' 91%!postproc(html): (@#@)$ 'th {background-color:lightblue; padding:.5em;} \n\1' 92%!postproc(html): (@#@)$ 'td {border-style:none; background-color:white;}\n\1' 93%!postproc(html): (@#@)$ 'pre {border-style:solid; border-width:1px 1px; \n\1' 94%!postproc(html): (@#@)$ ' background-color:lightblue; padding:8px; \n\1' 95%!postproc(html): (@#@)$ ' border-color:black;} \n\1' 96%!postproc(html): @#@$ </STYLE> 97 98% 26/Nov/2003: revised by anamimts 99% 26/Jun/2004: updated to v2, new embedded CSS 100% 17/Jul/2004: revised by anamimts 101% 01/Nov/2004: updated to v2.0 and 2.1, new chapters, PDF version 102 103% TODO Mastering Options [option-help], [option-css-sugar], ... 104 105======================================================================== 106 107%nopdf "ĄHola! Čsto es la Guia del Usuario de Txt2tags. Aquí podrás encontrar 108%nopdf toda la información disponible sobre la herramienta de conversión de textos txt2tags. 109%nopdf Puedes encontrar la última versión en http://txt2tags.org/userguide/. 110%nopdf Para más información, visita la 111%nopdf [web de txt2tags http://txt2tags.org]. ĄQue disfrutes!" 112%nopdf 113%%nopdf [Download PDF version http://txt2tags.org/userguide/userguide.pdf] 114 115======================================================================== 116 117%nopdf%**This Guide Contains:** 118 119%%toc 120 121======================================================================== 122 123= Parte I - Introducción a Txt2tags =[intro] 124 125== Tus Primeras Preguntas ==[1st-questions] 126 127Este capítulo presenta txt2tags, introduciendo a las funcionalidades y objetivos del programa. 128 129------------------------------------------------------------------------ 130 131=== żQue és Txt2tags? === 132 133Txt2tags es una herramienta de formateo y conversión de texto. 134Txt2tags convierte un archivo de texto con algunas marcas a uno de los siguientes tipos de archivo: 135 136- Documento HTML 137- Documento XHTML 138- Documento SGML 139- Documento LaTeX 140- Página man de UNIX 141- Presentación Magic Point 142- Página MoinMoin 143- Documento PageMaker 6.0 144- Texto plano (sin marcas) 145 146 147------------------------------------------------------------------------ 148 149=== żPor Qué Debo Usar Txt2tags? === 150 151Encontarás txt2tags muy útil si: 152- precisas publicar documentos en diferentes formatos 153- precisas mantener documentos actualizados en diferentes formatos 154- escribes manuales o documentos técnicos 155- no sabes como escribir un documento en un formato específico 156- no posees un editor específico para cierto formato 157- quieres usar un editor de texto simple para actualizar tus documentos 158 159 160Pero la motivación principal es: 161- economizar tiempo,escribiendo **contenido** sin preocuparse del **formato** 162 163 164------------------------------------------------------------------------ 165 166=== żQué ventajas ofrece, comparado con otras herramientas? === 167 168Txt2tags se encuentra en constante crecimiento, siguiendo una serie de conceptos basicos: 169 170 171| //Archivo fuente legible// | Las marcas de txt2tags son muy simples, casi naturales 172| //Documento destino legible// | Como el archivo fuente, el código del documento generado es también legible 173| //Consistencia en las marcas// | Las marcas txt2tags son únicas, atendiendo todos los tipos de documentos, sin ser confundidas con el contenido 174| //Reglas consistentes// | De la misma manera que las marcas, las reglas a ellas aplicadas son uniformes, sin excepciones ni casos especiales.. 175| //Estructuras simples// | Todas las estructuras soportadas son simples, sin opciones extras o modificadores complejos del comportamiento. Una marca es solo una marca, sin opciones adicionales. 176| //Facil de apreder// | Con marcas simples y código fuente legible, presenta una curva de aprendizaje muy amigable. 177| //Buenos ejemplos// | Los **archivos de ejemplos** incluidos en el paquete están basados en documentos reales, son simples, bién estructurados y están escritos en formato txt2tags. 178| //Herramientas valiosas// | Los **archivos de sintaxis**, incluidos en el paquete ( para los editores Vim, Emacs, Nano y Kate) ayudan a escribir documentos sin errores sintácticos. 179| //Tres interfaces de usuario// | Tiene una **interfaz Gráfica Tk**, una **interfaz Web**, que permite usar el programa remotamente o através de una intranet, y una **interfaz en línea de comandos** para usuarios avanzados y scripts. 180| //Soporta scripts// | Con el modo completo de línea de comandos, un usuario avanzado puede automatizar tareas y efectuar post-ediciones en los archivos convertidos. 181| //Descargar y Ejecutar / Multiplataforma// | txt2tags es un **script Python**. No hay necesidad de compilarlo o cargar módulos extra.Puede ser ejecutado sin problemas en máquinas UNIX, Linux,Windows y Macintosh . 182| //Actualizaciones Frecuentes// | El programa posee una lísta de discusión con usuarios activos que suguieren correcciones y mejoras. El propio autor es un usuario "intensivo" en casa y en su trabajo, por lo que es difícil que el desarrollo pare. 183 184 185------------------------------------------------------------------------ 186 187=== ż Cuanto cuesta ? === 188 189 || ĄABSOLUTAMENTE NADA! | 190 191Txt2tags es un programa gratuito,GLP,open source,dominio público,etc... 192%//<put-your-favorite-buzzword-here>//. 193 194Puedes copiarlo,usarlo,modificarlo,venderlo.. etc. Las polítcas de software y copyright no se encuentran entre las mayores preocupaciones del autor. 195 196------------------------------------------------------------------------ 197 198 199== Estructuras de Formato Soportadas por txt2tags ==[structures] 200 201 202- Encabezamiento (Cabeceras) ( título del documento, nombre de autor,fecha) 203- Títulos de secciones (numeradas o no) 204- Parráfos 205- Modificadores de fuentes 206 - Negrita (bold) 207 - Itálica 208 - Subrayada 209- Fuente no proporcional (Monoespaciada/Verbatim) 210 - Monoespaciada en un párafo 211 - Línea monoespaciada 212 - Zona en monoespaciado (multilínea) 213- Cítas 214- Enlaces 215 - URL/ enlaces internet 216 - enlaces e-mail 217 - enlaces locales 218 - enlaces nombrados 219- Listas 220 - listas marcadas 221 - listas numeradas 222 - listas de definicion 223- Líneas de separación horizontal 224- Imágenes (con un alineamiento adecuado) 225- Tablas (con o sin borde,con alineamiento , con expansión de columna) 226- Marcas especiales para texto raw ( que no debe ser tratado) 227- Macro especial para la fecha actual (con formato flexible) 228- Comentarios (para notas,TODO,FIXME,etc) 229 230 231------------------------------------------------------------------------ 232 233== Formatos de salida soportados ==[targets] 234 235: **HTML** 236 Todos sabemos lo que es HTML. 237 238 Txt2tag genera documentos HTML límpios, con una buena presentación y cuyo código fuente es legible. No utiliza javascript, frames u otras técnicas fútiles,frecuentemente innecesarias en el formateo de documentos técnicos. Pero, si se desea, puede utilizarse un archivo CSS externo. 239Txt2tag genera código "//HTML 4.0 Transitional//". 240 241 Desde la versión 2.0 de txt2tags el código HTML generado es aprobado al 100% 242 por el [ validador w3c http://validator.w3.org/]. 243 244: **XHTML** 245 Es la nueva generación de HTML con reglas mas estrictas, como la de tener que cerrar todas las marcas que se abran. De esta manera se consigue un código más fácil de tratar y de entender. Para propósitos generales, se puede considerar como HTML. 246 Txt2tag genera código "XHTML 1.0 Transitional". 247 248 Desde la versión 2.0 de txt2tags el código XHTML generado es aprobado al 100% 249 por el [ validador w3c http://validator.w3.org/]. 250 251 252: **SGML** 253 Es un formato de documento común que posee aplicaciones de conversiňn, como 254 [sgmltools http://www.sgmltools.org]. A partir de un archivo SGML se pueden generar documentos html, pdf, info, latex, lynx, rtf y xml. Las herramientas como sgml2* también crean índices (TOC) automaticamente, dividiéndolos en secciones y subpáginas (sgml2html) 255 256 Txt2tag genera archivos SGML válidos para DTD linuxdoc, listos para ser convertidos mediante una herramienta sgml2* sin archivo de catŕlogo extra u otras incomodas exigencias de SGML. 257 258: **LATEX** 259 Es uno de los formatos de documento preferido en los medios académicos y es un formato más potente de lo que uno, de entrada, se imagina. Libros completos,fórmulas complicadas o cualquier texto complejo puede ser escrito en LaTeX. Pero si intentas escribir a mano las marcas requeridas, prepárate para la desesperación. 260 261Txt2tag genera archivos LaTeX listos para usar,realizando todo el complejo trabajo que requiere este formateo, con todas las excepciones. El escritor debe preocuparse sólo por el contenido. 262 263 264 265: **LOUT** 266 Muy parecido a LaTeX, pero con una sintaxis mas fácil, utilizando "@" en lugar de "\" . Su proximidad a la idea de que "todo-es-objeto" da lugar a un marcado mas "sano". 267 268Txt2tag genera archivos Lout listos para su uso, que pueden ser convertidos a PS o PDF utilizando la orden "lout". 269 270: **MAN** 271 Las páginas man de UNIX resisten el paso del tiempo. Los formatos de documentos vienen y van, pero ellas siguen aquí, inamovibles. 272 273Hay otras herramientas para generar páginas man, pero txt2tag tiene una ventaja: una fuente, múltiples formatos de destino. Así, el contenido de una misma página man puede ser convertido en una página HTML, una presentacion Magic Point, etc. 274 275: **MGP (Magic Point)** 276 [Magic Point http://www.mew.org/mgp] es una herramienta de presentación bastante útil (tipo: Microsoft PowerPoint), que utiliza un lenguaje de marcado para definir todas las teclas. De esta forma puedes crear presentaciones complejas con vi/emacs/notepad. 277 278Txt2tag genera un archivo .mgp lísto para ser utilizado, definiendo todos los encabezamientos necesarios para las definiciones de fuentes y apariencia, así como el soporte a los carácteres acentuados (código ISO-8859). 279 280 **Observación 1 :** los archivos .mgp creados por txt2tag usan las fuentes Type1 de Xfree86. De esta forma no es necesario incluir fuentes TrueType a su presentación. 281 282 **Observación 2 ::** las definiciones de colores para las fuentes son límpias de forma que, incluso con una paleta de colores de sistema pobre, (cómo ``startx -- -bpp 8``),la presentación va a tener una buena apariencia. 283 284 285 La clave es : Convierte y Usa. Sin necesidad de posteriores u otros requisitos. 286 287: **MOIN** 288 ż No sabes lo que és [MoinMoin http://moin.sourceforge.net]? 289 ĄEs un [WikiWiki http://www.c2.com/cgi/wiki]! 290 291 La sintaxis de Moin es un poco liada: tienes que escribir cosas cómo 292 ``{{{'''''adding braces and quotes'''''}}}``.Pero txt2tag viene con marcadores simplificados y una solución unificada: una fuente, múltiples formatos destino. 293 294: **PM6** 295 żSabías que Adobe PageMaker 6.0 tiene su propio lenguaje de marcado?. Estilos, tablas de colores, modificadores de fuente y la mayor parte de las funcionalidades accesibles via 'clic' de ratón, también están disponibles en su lenguaje de marcado. Sólo tienes que acceder al menú "Import tagget text", aunque sea sólo por curiosidad, y podrás ver que es un lenguaje de marcas semejante al HTML. 296 297Txt2tag genera todas las marcas y define un encabezamiento extenso y funcional, configurando los estilos de párrafo y formatos. 298**ĄAtención!:** Sin saltos de linea. Cada párrafo debe ser una sola linea. 299 300 Nota del Autor: 301 //Todo mi libro sobre [expresiones regulares http://guia-er.sf.net]// 302 //fue escrito con Vi, convertido al formato PageMaker con txt2tag// 303 //y enviado a la imprenta.// 304 305: **TXT** 306 TXT es texto. El único tipo de formato verdadero. 307 308A pesar que las marcas de txt2tag son intuitivas y discretas, puedes eliminarlas convirtiendo el archivo al formato TXT puro. 309 310Los títulos estaran subrayados y el texto es, basicamente, conservado cómo estaba en el archivo fuente. 311 312 313------------------------------------------------------------------------ 314 315== Estructuras Soportadas en los Archivos finales ==[struct-support] 316 317 || Estructura | html | xhtml | sgml | tex | lout | man | mgp | moin | pm6 | txt | 318 | cabeceras | S | S | S | S | S | S | S | N | N | S | 319 | sección título | S | S | S | S | S | S | S | S | S | S | 320 | párrafos | S | S | S | S | S | S | S | S | S | S | 321 | negrita | S | S | S | S | S | S | S | S | S | - | 322 | itálica | S | S | S | S | S | S | S | S | S | - | 323 | subrayado | S | S | - | S | S | - | S | S | S | - | 324 | f.monoespacio | S | S | S | S | S | - | S | S | S | - | 325 | línea verbatim | S | S | S | S | S | S | S | S | S | - | 326 | área verbatim | S | S | S | S | S | S | S | S | S | - | 327 | área de cita | S | S | S | S | S | S | S | S | S | S | 328 | links internet | S | S | S | - | - | - | - | S | - | - | 329 | links e-mail | S | S | S | - | - | - | - | S | - | - | 330 | links locales | S | S | S | N | N | - | - | S | - | - | 331 | links nombrados | S | S | S | - | - | - | - | S | - | - | 332 | listas marcadas | S | S | S | S | S | S | S | S | S | S | 333 | listas numeradas | S | S | S | S | S | S | S | S | S | S | 334 | listas definición | S | S | S | S | S | S | N | N | N | S | 335 | línea horizontal | S | S | - | S | S | - | S | S | N | S | 336 | imágen | S | S | S | S | S | - | S | S | N | - | 337 | tabla | S | S | S | S | N | S | N | S | N | N | 338 || Extras | html | xhtml | sgml | tex | lout | man | mgp | moin | pm6 | txt | 339 | alineación imágen | S | S | N | N | Y | - | S | N | N | - | 340 | alin celdas tb | S | S | S | S | N | Y | N | S | N | N | 341 | span columna tb | S | S | N | N | N | N | N | N | N | N | 342 343 || | Significados 344 | **S** | //Soportado// 345 | **N** | //No soportado (tal vez en futuras versiones....)// 346 | **-** | //No soportado (no es posible en este tipo de archivo final)// 347% | **?** | //not supported (not sure if it can be done or not)// 348 349------------------------------------------------------------------------ 350 351== Las tres interfaces de usuario: GUI, Web y Línea de Comandos ==[interfaces] 352 353Considerando que distintos usuarios pueden tener distintas necesidades y/o disponer de entornos diversos, txt2tags flexibiliza su forma de utilización, presentándose en tres posibles interfaces de usuario, cada una de ellas con sus propias peculiaridades y funcionalidades. 354 355- **Gui**: Escrita en Tk. Aporta a txt2tags un entorno de ventanas y la facilidad del "clic" de ratón. 356- **Web**: Escrita en PHP, permite operar remotamente con txt2tags, mediante un navegador, sin necesidad de instalación local 357- **Línea de Comandos**: Escrita en Phyton, es el núcleo del programa. Todas las funcionalidades y opciones del programa son accesibles desde la Línea de Comandos. 358 359 360------------------------------------------------------------------------ 361 362=== Interfaz Gráfica Tk ===[gui] 363 364Desde su versión 1.0, txt2tags dispone de una interfaz gráfica que funciona en Linux, Mac, Windows y otros sistemas operativos. 365 366Al invocar txt2tags (desde la línea de comandos), el programa detecta automaticamente si el sistema soporta la interfaz gráfica y, en caso afirmativo, la lanza sin necesidad de órdenes adicionales. Se puede forzar el lanzamiento de la interfaz gráfica mediante la opción --gui. Si se detectara la falta de algún componente para el funcionamiento de la interfaz gráfica, el programa nos lo advertirá. 367 368 **Nota:** Se necesita el módulo Tkinter. Forma parte de la distribución estandar de Python. De tener instalado éste,deberia disponerse del citado módulo. 369 370La interfaz es simple e intuitiva: 371 372 [IMGPATH/gui.png] 373 374+ Localizar el archivo fuente .t2t en el disco. 375 376+ Elegir un tipo de documento de salida. 377 378+ A continuación podran elegirse una serie de opciones, aunque ninguna de ellas es imprescindible. 379 380+ Finalmente, activando "Convert!", se realiza la conversión del documento. 381 382 383Una de las opciones cuya activación puede ser útil es "//Dump to screen//", (Visualización en pantalla), que nos permite ver el código generado en una ventana distinta a la de trabajo sin que, por el momento, se guarde ningún archivo. Si el código se considera correcto, desactivamos la opción y la conversión se realizará normalmente. 384 385Los colores que vienen por defecto pueden cambiarse en el archivo ``~/.txt2tagsrc`` 386usando los ajustes ``%!guicolors`` Por ejemplo: 387 388``` 389% set my own colors for the graphical interface (bg1, fg1, bg2, fg2) 390%!guicolors: blue white brown yellow 391``` 392 393------------------------------------------------------------------------ 394 395=== Interfaz Web === 396 397La interfaz web se encuentra disponible en: http://txt2tags.org/online.php . Allí puedes usar y probar el programa sin necesidad de instalarlo localmente. 398 399 [IMGPATH/web.png] 400 401También puede instalarse esta interfaz en la intranet local, evitando así tener que proceder a la instalación de txt2tags en cada una de las computadoras. 402 403------------------------------------------------------------------------ 404 405=== Interfaz de Línea de Comandos (Cónsola) ===[cmdline] 406 407A los usuarios de esta interfaz, la opción --help les debe proporcionar salida en pantalla parecida a čsta: 408 409``` 410Usage: txt2tags [OPTIONS] [infile.t2t ...] 411 412 -t, --target set target document type. currently supported: 413 html, xhtml, sgml, tex, lout, man, mgp, moin, pm6, txt 414 -i, --infile=FILE set FILE as the input file name ('-' for STDIN) 415 -o, --outfile=FILE set FILE as the output file name ('-' for STDOUT) 416 -n, --enum-title enumerate all title lines as 1, 1.1, 1.1.1, etc 417 -H, --no-headers suppress header, title and footer contents 418 --headers show header, title and footer contents (default ON) 419 --encoding set target file encoding (utf-8, iso-8859-1, etc) 420 --style=FILE use FILE as the document style (like HTML CSS) 421 --css-sugar insert CSS-friendly tags for HTML and XHTML targets 422 --css-inside insert CSS file contents inside HTML/XHTML headers 423 --mask-email hide email from spam robots. x@y.z turns <x (a) y z> 424 --toc add TOC (Table of Contents) to target document 425 --toc-only print document TOC and exit 426 --toc-level=N set maximum TOC level (depth) to N 427 --rc read user config file ~/.txt2tagsrc (default ON) 428 --gui invoke Graphical Tk Interface 429 -q, --quiet quiet mode, suppress all output (except errors) 430 -v, --verbose print informative messages during conversion 431 -h, --help print this help information and exit 432 -V, --version print program version and exit 433 --dump-config print all the config found and exit 434 435Turn OFF options: 436 --no-outfile, --no-infile, --no-style, --no-encoding, --no-headers 437 --no-toc, --no-toc-only, --no-mask-email, --no-enum-title, --no-rc 438 --no-css-sugar, --no-css-inside, --no-quiet 439 440Example: 441 txt2tags -t html --toc myfile.t2t 442 443By default, converted output is saved to 'infile.<target>'. 444Use --outfile to force an output file name. 445If input file is '-', reads from STDIN. 446If output file is '-', dumps output to STDOUT. 447``` 448 449==== Ejemplos: ==== 450 451Suponiendo que se haya creado un archivo marcado,denominado ``file.t2t``, veamos varias opciones de conversión: 452 453| **Convertir a HTML** | ``$ txt2tags -t html file.t2t`` 454| **Usando redireccionamiento** | ``$ txt2tags -t html -o - file.t2t > file.html`` 455| | . 456| **Con Índice de Contenidos** | ``$ txt2tags -t html --toc file.t2t`` 457| **Con Títulos Numerados** | ``$ txt2tags -t html --toc --enum-title file.t2t`` 458| | . 459| **Vista rápida del Índice** | ``$ txt2tags --toc-only file.t2t`` 460| **żÍndice numerado? ĄSi!** | ``$ txt2tags --toc-only --enum-title file.t2t`` 461| | . 462| **...... desde STDIN** | ``$ echo -e "\n**bold**" | txt2tags -t html --no-headers -`` 463| **Enmascarando los e-mails** | ``$ echo -e "\njohn.wayne@farwest.com" | txt2tags -t txt --mask-email --no-headers -`` 464| **Edición post-conversión** | ``$ txt2tags -t html -o- file.t2t | sed "s/<BODY .*/<BODY BGCOLOR=green>/" > file.html`` 465 466: //Nota// 467 Desde la versión 1.6 es posible realizar un tratamiento pre y post conversión mediante los filtros 468 ``%!preproc`` y ``%!postproc`` . 469 470 471======================================================================== 472 473 474 475= Parte II: - OK!, Quiero utilizar el programa. żQue debo hacer ? =[install] 476 477Sencillamente, descargar el programa y hacer que corra en tu máquina :-).Veamos como hacerlo. 478 479== Obtener e instalar Python ==[download-python] 480 481En primer lugar, deberemos instalar el interprete Python en nuestro sistema. Si ya lo tenemos instalado, podemos saltarnos este apartado. 482 483Python es uno de los mejores lenguajes de programación. Funciona en Linux, Mac, Windows y otros Sistemas Operativos. Puede descargarse del la web de [Python http://www.python.org]. Las instrucciones para su instalación se encuentran disponibles en este mismo site. Txt2tags funciona mejor con versiones de Python 1.5 o superiores. 484 485Si no estais seguros de tener Python instalado en vuestro sistema, abrid una consola ( tty, xterm, MSDOS..) y lanzad el comando ``python``. Si no está instalado, vuestro sistema os lo advertirá 486 487 488== Obtener Txt2tags ==[download-txt2tags] 489 490El sitio oficial de la distribución de txt2tags es: http://txt2tags.org/src . 491 492Todos los archivos son del tipo "tarball" (tar.gz,.tgz), que pueden ser descomprimidos por la mayoria de los programas de descompresión (incluido Winzip). 493 494Debemos procurar obtener la **última versión** (la mas reciente o el número de versión mas alto). Las versiones precedentes se conservan el el repositorio por razones puramente históricas. 495 496== Instalar txt2tags ==[install-txt2tags] 497 498Como todos los scripts Python, txt2tags apenas precisa de instalación. 499 500El único archivo necesario para el programa es el script txt2tags. Los demás archivos tar.gz (.tgz) son la documentación, las utilidades y los archivos de ejemplo. 501 502El medio mas seguro de iniciar txt2tags es "llamarlo" desde Python. 503``` prompt$ python txt2tags 504 505Si deseais instalar txt2tags como programa en vuestro sistema, copiad (o cread un enlace) el script txt2tags en un directorio referenciado por la variable $PATH y aseguraos de que el sistema pueda lanzar el programa. 506 507: **UNIX/Linux** 508 509 Asegurémosnos de que el script es ejecutable : ``chmod +x txt2tags`` y, seguidamente lo copiamos en un directorio referenciado por $PATH: 510 ``cp txt2tags /usr/local/bin`` 511 512: **Windows** 513 514 Renombrar el script ańadiéndole la extensión .py : 515 ``ren txt2tags txt2tags.py`` y copiarlo en un directorio referenciado en $PATH: 516 ``copy txt2tags.py C:\WINNT`` 517 518 519Después de esto, si deseais utilizar el entorno gráfico, podreis crear un icono en vuestro escritorio. 520 521=== Paquetes especiales para los usuarios de Windows === 522 523Existen dos distribuciones .EXE de txt2tags, que instalan el programa en maquinás Windows con solo unos cuantos "clics": 524 525- La primera es el simple script txt2tags para los que tengan instalado Python. 526- La segunda de estas dos distribuciones es la "versión completa", con la cuál no se precisa tener instalado Python en el sistema (Incluye una versión "ligera" de Python). 527 528 529Se pueden obnener en //Txt2tags-Win//: http://txt2tags-win.sf.net 530 531== Instalación de los Archivos de Sintaxis para los Editores de Texto ==[editor-syntax] 532 533Con txt2tags se proporcionan una serie de archivos de sintaxis prácticos, utilizables con los siguientes editores: 534 535- Vim (www.vim.org) 536- Emacs (www.emacs.org) 537- Nano (www.nano-editor.org) 538- Kate (http://kate.kde.org) 539 540 541Estos archivos sintácticos contienen todas las reglas y marcas que utiliza txt2tags, ayudándo al usuario a escribir los documentos sintacticamente correctos. Las marcas se visualizan en color, así podremos darnos cuenta de si escribimos correctamente. 542 543 544 | [IMGPATH/vim.png] | 545 | Ejemplo de archivo editado en Vim 546 547Cada editor tiene un procedimiento de instalación específico. Consulta el encabezamiento del archivo de sintaxis y la documentación del editor. 548 549======================================================================== 550 551 552 553= Parte III - Escribiendo y convirtiendo vuestro primer documento. =[your-1st-doc] 554 555== Probar las herramientas == 556 557Para poder hacer vuestra primera conversión necesitareis tres cosas: txt2tags, un editor y un navegador web. 558 559+ Comprobad que txt2tags funciona correctamente en vuestra máquina. 560 561 - **Interfaz de Línea de Comandos:** Lanzad el comando txt2tags desde la línea de comandos. Deberá generarse una salida con un mensage similar a "Missing input file". Si no ocurre eso, probad con: "pyton /ruta/hacia/txt2tags" o con: "/ruta/hacia/python /ruta/hacia/txt2tags" en el caso de que python no esté en vuestro PATH. 562 563 - **Interfaz GUI:** Si lanzamos txt2tags desde la línea de comandos, se iniciará con el sistema gráfico. En el caso de que hayamos creado un icono en el escritorio, "clicar" en el. 564 565+ Abrid un editor de texto que conozcais bién, puede ser cualquiera, desde Vim a MSWord u Openoffice. Cread un nuevo documento, que será vuestro primer documento txt2tags. 566 567+ Lanzad vuestro browser preferido para poder ver los resultados de la conversión en una pagina HTML. 568 569 570------------------------------------------------------------------------ 571 572== Escribir el encabezamiento del documento == 573 574+ Id al editor de texto y teclead una primera línea , por ejemplo: //Mi Primer Documento// 575+ En una segunda línea teclead un sub-título, por ejemplo://txt2tags// 576+ Después, en una tercera línea teclead, por ejemplo, una fecha: //Domingo 17 Julio 2005// 577 578 579Así, dispondremos de un documento con el siguiente contenido: 580 581``` 582Mi primer documento 583txt2tags 584Domingo 17 Julio 2005 585``` 586 587Aunque ésto sea sólo una parte del documento, podemos convertirlo y comprobar el resultado. 588Guardad el documento con el nombre ``test.txt`` en un directorio desde donde, más tarde, podamos recuperarlo (en los siguientes ejemplos el documento se ha guardado en el directorio /tmp). 589 590 591------------------------------------------------------------------------ 592 593== La Primera Conversión : La Interfaz Gráfica. == 594 595Si utilizais la interfaz de línea de comandos, pasad a la siguiente sección. 596 597 598Si utilizais la interfaz gráfica, proceded tal como a continuación se indica: 599 600 [IMGPATH/firstdoc.png] 601 602+ Clicar en el botón "Browser", navegad hasta el directorio en el que guardasteis el documento test.tx y seleccionarlo. 603+ En el apartado "Choose the target document type" (Elija el tipo de documento de salida) escoged : "HTML page" 604+ Clicar el boton "Convert!" (Convertir) 605 606 607 [IMGPATH/firstdoc-done.png] 608 609Aparecerá un diálogo que nos informa que la conversión se ha realizado con éxito. Notad que el archivo HTML generado ha sido guardado en el mismo directorio que el archivo test.txt, pero con la extensión .html 610 611------------------------------------------------------------------------ 612 613== La Primera Conversión: Interface en Línea de Comandos == 614 615Si utilizais la interfaz gráfica, id a la sección anterior. 616 617Si utilizais la interfaz de Línea de Comandos, id al directorio en el que está guardado test.txt y teclead el siguiente comando: 618 619``` txt2tags --target html test.txt 620 621Observad que hay un espacio en blanco entre cada una de las partes del comando, pero no en --target. Dicha opción es seguida por html, que indica al programa el formato al que deseamos convertir el archivo de texto. La última parte de la orden es el nombre del archivo de texto que deseamos convertir. 622 623Si la conversión se realiza con éxito, el resultado es guardado como ``test.html`` 624y el programa nos dará un mensaje del tipo: "//txt2tags wrote test.html//" . En caso contrario ,os indicará el error cometido. Verificadlo con atención. 625 626Esto es una muestra de lo que podeis ver en la pantalla: 627``` 628prompt$ txt2tags --target html test.txt 629txt2tags wrote test.html 630prompt$ 631``` 632 633------------------------------------------------------------------------ 634 635== Comprobar el resultado == 636 637Abrir el archivo ``test.html`` con el navegador y comprobar el resultado de la conversiňn. 638 639 640 [IMGPATH/firstdoc-html.png] 641 642Ą Bién ! Os habeis limitado a teclear tres simples líneas de texto y txt2tags ha realizado todo el trabajo necesario para configurar el encabezamiento de la pagina HTML. El alineamiento del texto, los márgenes, los espaciados, la apariencia, etc. Podemos observar como el título principal del documento aparece también en el borde superior del navegador (o en el título de la pestańa, en el caso de que usemos uno que aporte esta función). 643 644 || Vosotros escribis el texto, txt2tags hace el resto :-) | 645 646Truco: podeis utilizar CSS en las páginas HTML generadas por txt2tags. De esta forma la apariencia de la página es configurable al 100%. 647 648------------------------------------------------------------------------ 649 650== Escribir el cuerpo del documento == 651 652Volvamos al editor de texto, ya que la siguiente etapa consistirá en escribir el cuerpo del documento. Podeis escribirlo en texto plano, el mismo que usais en los e-mail. Podreis observar como txt2tags reconoce automaticamente los párrafos y las listas de elementos, sin necesidad de "marcarlos". 653 654Guardad de nuevo el documento y proceded a su conversión, tal como se indicó en la anterior sección. Comprobad el resultado. Éste es el ciclo de desarrollo de documentos con txt2tags. No necesitais más que centraros en el contenido del documento, obteniendo el documento final mas rápidamente que con otros editores. Sin interminables "clics" de ratón, ni menús, ni ventanas ni distracciones. 655 656Observad el contenido del archivo de texto plano ``test.txt`` y comparémoslo con el archivo HTML generado: 657 658``` 659Mi primer documento 660txt2tags 661Domingo 17 Julio 2005 662Bueno, vamos a probar txt2tags. 663No se me ocurre nada que escribir. Probemos con una lista. 664 665Necesitaria: 666- Ducharme 667- Comer una pizza 668- Dormir 669``` 670 671 [IMGPATH/firstdoc-fullhtml.png] 672 673 674Con txt2tags es posible escribir una página web entera sin ningún conocimiento de HTML. No necesitareis intertar ninguna marca. Además, el mismo archivo de texto plano puede convertirse en cada uno de los demás formatos soportados por txt2tags. 675 676Además del texto plano, txt2tags proporciona una serie de marcas muy simples que pueden utilizarse cuando se tenga necesidad de otros formatos o estructuras, como puede ser el texto en negrita, cursiva o itálica, los títulos, las imágenes, las tablas y otros. Un ejemplo rapido: 677 678``**comienza en negrita**`` y ``== los signos igual para el título ==``. 679 680Para aprender a utilizar estas marcas consultad el archivo [Txt2tags Markup Demo http://txt2tags.org/markup.html]. 681 682======================================================================= 683 684 685 686= Parte IV - Dominando los Conceptos de Txt2tags =[concepts] 687 688== Las Áreas de un Documento .t2t ==[areas] 689 690Los archivos marcados por txt2tags se dividen en 3 áreas. Cada una de estas tres áreas tiene sus propias reglas y finalidades. Estas áreas son: 691 692: //ENCABEZAMIENTO// 693 Lugar para el título del documento, nombre del autor, versión y fecha. (opcional) 694: //CONFIGURACIÓN// 695 Lugar para la configuración general del documento. (opcional) 696: //CUERPO// 697 Lugar en el que se coloca el contenido del documento. (obligatoria) 698 699 700Como se ha podido observar, solo el área del //CUERPO// 701es obligaroria. 702 703Cada área esta regulada por reglas específicas, que se detallarán en el siguiente capítulo. Por ahora, vamos a quedarnos con una representación gráfica de las áreas de un documento txt2tags: 704 705 706``` 707 _________________ 708 | | 709 | ENCABEZAMIENTO | 1. En primer lugar,los Encabezamientos 710 | | 711 | CONFIGURACIÓN | 2. Después,las Configuraciones 712 | | 713 | CUERPO | 3. Finalmente,el Cuerpo del documento, 714 | | 715 | ... | el cual abarca hasta el final 716 | ... | 717 |_________________| 718 719``` 720 721En resumen, así es como se definen las tres áreas: 722 723 | **Encabezamiento** | Las primeras 3 líneas del archivo. O la primera línea en blanco, cuando no se quiere un Encabezamiento. 724 | **Configuración** | Desde la 4Ş linea (o desde la 2Ş , en el caso que no se contemple Encabezamiento) hasta donde comience el Cuerpo del Documento.. 725 | **Cuerpo** | Comienza con la primera línea de texto válido (no "comentado" o que no sea una configuración) después del Encabezamiento. 726 727 728=== Veamos un ejemplo: === 729 730``` 731My nice doc Title 732Mr. John Doe 733Last Updated: %%mtime(%c) 734 735%! Target : html 736%! Style : fancy.css 737%! Encoding: iso-8859-1 738%! Options : --toc --enum-title 739 740Hi! This is my test document. 741Its content will end here. 742``` 743 744------------------------------------------------------------------------ 745 746== Área de Encabezamiento ==[headers-area] 747 748Localización: 749- Posicion fija: Las **tres pimeras líneas** de un archivo. Eso es todo :-) 750- Posicion fija: La **primera línea** de un archivo, si se trata de una línea en blanco. Esto signfica "Encabezamiento vacio". 751 752 753El Área de Encabezamiento es la única que tiene una posición fija, determinada por líneas. Se encuentra siempre en las tres primeras líneas del archivo fuente. 754 755El contenido de estas líneas no esta regulado, es libre, aunque se recomienda que se siga la siguiente pauta: 756 757 - //línea 1//: título del documento 758 - //línea 2//: nombre del autor y/o email 759 - //línea 3//: fecha del documento y/o versión (un buén lugar para ``%%date``) 760 761 762Retengamos que las tres primeras líneas del documento fuente serán las tres primeras líneas del documento final, separadas y diferenciadas del resto del contenido del documento ( p.e.,carácteres mas grandes, en negrita). Si es posible la paginación, encontraremos el encabezamiento sólo y centrado en la primera página. 763 764 765==== Menos (o Ninguna) líneas de Encabezamiento ==== 766 767Tal vez deseemos menos líneas de encabezamiento. Por ejemplo, solo deseamos especificar el título y la fecha. 768 769Para ello bastara con dejar la 2Ş y/o la 3Ş línea en blanco. Esta/s líneas en blanco no serán incluidas en el documento final. Pero no debemos olvidar que, aún en blanco, estas líneas forman parte del Área de Encabezamiento del documento y que el Cuerpo del mismo comenzará **a partir de** la tercera línea. 770 771La primera línea (normalmente, el título) es la unica línea requerida en el Área de Encabezamiento. Recordemos que la primera línea en blanco indica **Encabezamiento vacio**, lo que origina que el //Área de Encabezamiento// se inicie a partir de la 2Ş línea. 772 773No configurar un encabezamiento puede sernos de utilidad en el caso de querer insertar un encabezamiento personalizado después de la conversión. Para éste tipo de operación generalmente se requiere la opción de línea de comandos ``--no-headers``. 774 775%==== Straight to the point ==== 776 777 || En resumen: Los Encabezamientos son posiciones, no contenidos. | 778 779Si colocamos un texto en la primera línea del archivo fuente, aparecerá en la primera línea del documento convertido. Lo mismo para las 2Ş y 3Ş líneas. 780 781------------------------------------------------------------------------ 782 783== Area de Configuración ==[config-area] 784 785Localización: 786- Comienza justo despues del Área de Encabezamiento 787 - Comienza a partir de la 4Ş línea si se especifican encabezamientos 788 - Comienza a partir de la 2Ş línea en el caso de **Encabezamiento vacio**. 789- Finaliza donde comienza el Área del Cuerpo del documento 790 - Finaliza en una línea en blanco, en una línea que sea un comentario o en una línea que no sea de ajuste/configuración. 791 792 793El Área de Configuración es opcional. Cualquiera puede generar documentos txt2tags sin siquiera conocer la existencia de dicha área, pero el usuario experimentado dificilmente podra prescindir de la ventaja y el control que dicha área le proporcionará. 794 795El Área de Configuración nos servirá para definir en ella configuraciones que afecten al comportamiento del programa, evitando asi tener que escribir dichas opciones en la línea de comandos en el momento de ralizar la conversión. 796 797Para mas información, consultar la Sección:[Configuraciones (Settings section) #settings-overview]. 798 799---------------------------------------------------------------- 800 801== Área del Cuerpo del Documento ==[body-area] 802 803Localización: 804- Comienza con la primera línea válida de texto del archivo. 805 - Las líneas que contienen ajustes o comentarios y las líneas en blanco no se consideran líneas válidas de texto 806- Finaliza al final del archivo (EOF) 807 808 809Consideraremos Cuerpo todo lo que no sea ni Encabezamiento ni Configuración. 810 811El Cuerpo está constituido por el contenido del documento y todas aquellas estructuras y formatos que txt2tags puede reconocer. 812En el Cuerpo pueden incluirse comentarios para los //TODOs// y notas personales. 813 814Puede utilizarse la opción en línea de comandos ``--no-headers`` para convertir solo el Cuerpo del documento, suprimiendo los Encabezamientos. Esto es práctico cuando se tienen Encabezamientos personalizados en un archivos aparte, que se concatenará seguidamente con el documento que estemos procesando. 815 816---------------------------------------------------------------- 817 818== Configuraciones: żCómo Configurar algo?. żCuál es la sintaxis? ==[settings-overview] 819 820Las líneas de configuración son líneas de comentario especiales, situadas en el Área de Configuración, que afectan al proceso de conversión. Su sintaxis, tan simple como la atribución de valor a una variable, está compuesta por una palabra-clave y un valor, separados la una del otro por el separador canonico dos-puntos **":"** . Su sintaxis es: 821 822 || %! palabra-clave : valor | 823 824Lista de claves válidas: 825 826 || Clave | Descripción | 827 | Target | Define el formato al cuál debe ser convertido el documento. 828 | Options | Es útil para especificar las opciones de línea de comando para el archivo fuente. El formato de las opciones es el mismo que el utilizado en la línea de comandos. Usando esta opción junto con %!target permite convertir el documento simplemente con la orden: txt2tags file.t2t 829 | Style | Sólo es soprtado por el documento destino HTML, para definir una hoja de estilo (CSS) 830 | Encoding | Es una configuración importante en documentos que contienen acentos y carácteres no ASCII, ya que permite personalizar el Conjunto de Carácteres (Codificación de Carácteres). 831 | PreProc | Es un filtro. Define reglas del tipo "busca y sustituye" que serán aplicadas al archivo original antes de cualquier análisis por parte de txt2tags. 832 | PostProc | Es un filtro. Define reglas del tipo "busca y sustituye" que serán aplicadas al archivo destino después de todo el procesamiento por parte de txt2tags. 833 834Ejemplo: 835 836``` 837%! Target : html 838%! Options : --toc --toc-level 3 839%! Style : fancy.css 840%! Encoding: iso-8859-1 841%! PreProc : "AMJ" "Aurelio Marinho Jargas" 842%! PostProc: '<BODY.*?>' '<BODY bgcolor="yellow">' 843``` 844 845----------------------------------------------------------------------- 846=== Algunas reglas sobre las Configuraciones === 847- Las configuraciones son válidas solo dentro del Area de Configuración. Serán tratadas como comentarios simples si se encuentran en el Cuerpo del documento. 848 849- Si la misma palabra-clave aparece más de una vez en el Area de Configuración, solo se utilizara la última. Excepciones: Options, PreProc y PostProc, que son acumulativas. 850 851- Una línea de configuración con una palabra-clave inválida será considerada un comentario. 852 853- Las opciones de configuración situadas en el Área de Configuración tienen preferencia dentro del archivo txt2tags, pero no sobre las opciones en Línea de Comando. 854 855 856== Opciones en Línea de Comando ==[options] 857 858El modo más rápido de cambiar el comportamiento por defecto es utilizando las opciones de la línea de comando. Esto es sólo posible cuando se utiliza la citada interfaz, no cuando se utilizan las interfaces Web o GUI. 859 860El programa acepta un juego de opciones predefinidas. Una opción es un guión ("-") seguido de una letra o dos guiones ("--") seguidos de una o mas palabras, como ``-t`` y ``--target``. 861A propósito de la opción "target": resulta ser la única opción obligatoria. Todas las demás opciones son eso, opcionales. :-) 862 863Las opciones más utilizadas son ``--outfile`` para activar la generación automática de índices de materias y 864``--encoding`` que nos permite escoger el tipo de codificación de caracteres. La mayoria de las opciones pueden ser desactivadas precediéndolas de "no-" , por ejemplo: 865``--no-encoding`` and ``--no-toc``. 866 867Pueden configurarse las opciones que se deseen utilizar en un determinado archivo origen, en el Ärea de Configuración del mismo archivo, mediante la regla de configuración ``%!options`` . Esto nos evita el tecleado de las opciones en la línea de comando. 868Por ejemplo: ``%!options: --toc -o mydoc.html``. 869La excepción es la especificacion del formato del archivo final, que tiene su propia sintaxis: ``%!target: html``. 870 871La opción ``--help`` nos proporcionará una lista completa de las opciones disponibles. 872 873----------------------------------------------------------------------- 874 875== Archivo de Configuracion del Usuario (RC) ==[rc] 876 877El archivo de configuración del usuario (llamado también archivo RC) es el lugar donde se guardan las reglas de las configuraciones que pueden ser compartidas por TODOS los archivos. Si utilizas las mismas reglas de configuración en todos los archivos .t2t que escribais, incluidlas en el archivo RC y podrán ser utilizadas globalmente, tanto por los existentes como por futuros archivos fuente. 878 879El emplazamiento por defecto de este archivo depende del sistema que se esté utilizando. De todas maneras, dicho emplazamiento puede ser modificado por el usuario utilizando una variable de entorno. 880 881 || | RC file location | 882 | Windows: | ``%HOMEPATH%\_t2trc`` 883 | Linux y otros: | ``$HOME/.txt2tagsrc`` 884 | Definidod por usuario: | ``T2TCONFIG`` env var 885 886 887El formato de las reglas de configuración es exactamente el mismo que el utilizado en el Área de Configuración de los archivos .t2t. Podemos encontrar un ejemplo de archivo RC en el "tarball" 888``doc/txt2tagsrc`` 889 890Ejemplo: 891``` 892% my configs 893 894%%% Always use CSS-friendly tags in HTML 895%!options(html): --css-sugar 896 897%%% Change the default TOC depth for all targets 898%!options: --toc-level 4 899 900%%% Set the default encoding for all documents 901%!options: --encoding iso-8859-1 902``` 903 904Toda línea no vacia, un comentario o una línea de configuración vŕlida puede generar un error durante la ejecución de txt2tags. Sed muy cautelosos a la hora de editar el archivo RC. 905 906Txt2tags aplica automaticamente el archivo RC a todo archivo fuente que convierta. Si se desea desactivar el comportamiento para un determinado archivo, utilizad la opción ``--no-rc``. 907 908== Orden de Aplicación de las Configuraciones y Precedencia ==[config-loading] 909 910Hay tres formas de indicar a txt2tags cuales opciones y configuraciones utilizar y el orden que debe aplicarlas: 911 912+ El archivo de usuario RC ( .txt2tagsrc) 913+ Una Área de Configuración en el documento fuente 914+ Las opciones de línea de comando 915 916 917En primer lugar, el programa lee las configuraciones del archivo RC. Si no encuentra otras, las aplica. Si encuentra configuraciones en el Área de Configuración del documento fuente, las lee, sobrescribiendo las configuraciones de RC. Finalmente, si encuentra opciones en la línea de comando,las lee, sobreescribiento a cualquiera de las otras dos anteriones. 918 919Asi, si el "encoding" del documento fuera definido en las tres opciones, se aplicarian las opciones definidas en la linea de comando. 920 921 922----------------------------------------------------------------------- 923 924== El Comando %!include ==[include] 925 926Desde la versión 1.7, es posible la utilización del comando ``include`` para insertar el contenido de un archivo externo en el Cuerpo del documento original. 927 928``include`` es un comando, no una configuración. Es solo válido cuando se incluye en el //Área del Cuerpo del documento//. 929 930``include`` es útil para dividir un documento grande en varios archivos menores ( p.e. en capítulos) o para incluir todo el contenido de un archivo externo cualquiera en el documento fuente. 931 932Ejemplo: 933 934``` 935My first book 936Dr. John Doe 9371st Edition 938 939%!include: intro.t2t 940%!include: chapter1.t2t 941%!include: chapter2.t2t 942... 943%!include: chapter9.t2t 944%!include: ending.t2t 945``` 946 947Como puede verse, basta con indicar el nombre del archivo después del comando ``include``. Las especificaciones opcionales del archivo final tambien són soportadas por el comando: 948 949``` %!include(html): file.t2t 950 951Debemos tener presente que ``include`` insertará en el Área del Cuerpo el archivo .t2t, ignorando su encabezamiento y sus configuraciones. Esto nos permitirá convertir el documento incluido, separada o conjuntamente con el documento principal. 952 953Podemos considerar tres variantes de inclusión: 954- Verbatim 955- Raw 956- Tagged 957 958 959 **Verbatim** : El texto es incluido preservando sus espacios y formato original, como si estuviese marcado por VERB. Para incluir un archivo de esta manera, basta con incluir su nombre entre (```): 960 961``` %!include: ``/etc/fstab`` 962 963**Raw** : El texto es incluido "como esta". No busca las marcas txt2tags, ni las interpreta. Es como si el texto estuviese entre marcadores (" ") de área protegida. 964Para incluir un archivo de esta menera basta con colocar su nombre entre dobles-comillas (" " ): 965 966``` %!include: ""boom_text.txt"" 967 968**Tagged** : El texto es pasado directamente al documento resultante, sin ningún tratamiento por parte de txt2tags. Mediante este procedimiento podemos in…
Large files files are truncated, but you can click here to view the full file