PageRenderTime 32ms CodeModel.GetById 4ms app.highlight 10ms RepoModel.GetById 1ms app.codeStats 0ms

/doc/Spanish/userguide-es/userguide-es.t2t

http://txt2tags.googlecode.com/
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