/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 

    

  1. Txt2tags: Guia del Usuario de Txt2tags
    2. 

  2. Aurelio, %%mtime(%c)
    3. 

  3. Traducción al espańol: Antoni Serra Devecchi
    4. 

  4. %!target: html
    5. 

  5. %!options: --toc --toc-level 2 --css-sugar 
    6. 

  6. 

  7. %%!options: -o ../../../web/userguide/userguide.html
    8. 

  8. 

  9. % TRANSLATOR:
    10. 

  10. % - Don't worry about the PDF cover page
    11. 

  11. % - Don't worry about PDF at all, translate and check on HTML
    12. 

  12. % - Don't worry about the images
    13. 

    14. 

  14. % TRANSLATOR uncomment the next line
    15. 

  15. %%!options: -o userguide.html
    16. 

  16. 

  17. % TRANSLATOR uncomment the next line to use images on the same folder
    18. 

  18. %!preproc: IMGPATH .
    19. 

  19. 

  20. % TRANSLATOR:
    21. 

  21. % You can take new screenshots and make new images for the program
    22. 

  22. % interface and "first conversion" section. Remember to send them
    23. 

  23. % to the author!
    24. 

  24. 

  25. 

  26. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    27. 

  27. %%% activate those lines when converting to HTML for PDF generation
    28. 

  28. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    29. 

  29. %%% htmldoc does TOC
    30. 

  30. %!options(html): --no-toc --no-css-sugar -o userguide-pdf.html
    31. 

  31. %%% mask the 'nopdf' marks so they will not be removed
    32. 

  32. %!preproc(html): ^%nopdf  %yespdf
    33. 

  33. %%% removing first header, htmldoc ignores all until next <H1> (cool!)
    34. 

  34. %!postproc(html): '<H1>Txt2tags: .*</H1>'  ''
    35. 

  35. %%% imagens are in the same dir
    36. 

  36. %!preproc: IMGPATH .
    37. 

  37. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    38. 

  38. 

  39. % easy way to change all image locations once, when changing file location
    40. 

  40. %!preproc: IMGPATH ../img
    41. 

  41. 

  42. % normalizing common text
    43. 

  43. %%!preproc: CONFAREA	Config Area
    44. 

  44. %%!preproc: HEADAREA	Header Area
    45. 

  45. %%!preproc: BODYAREA	Body Area
    46. 

  46. %%!preproc: MARKPROP	**Properties:**
    47. 

  47. %%!preproc: MARKCONT	**Contains:**
    48. 

  48. %%!preproc: MARKDESC	**Description:**
    49. 

  49. %%!preproc: MARKSYN	**Syntax:**
    50. 

  50. %%!preproc: MARKDET	**Details:**
    51. 

  51. %%!preproc: NOMARKS	Marks are NOT interpreted
    52. 

  52. %%!preproc: NOMACRO	Macros are NOT interpreted
    53. 

  53. 

  54. %!preproc: URLMARKUP	http://txt2tags.org/markup.html
    55. 

  55. 

  56. % activate the areas disabled on the PDF version
    57. 

  57. %!preproc(html): ^%nopdf  ''
    58. 

  58. 

  59. % remove separator lines and strong lines
    60. 

  60. %!preproc(html): '^ *--------*'  ''
    61. 

  61. %!preproc(html): '^ *========*'  ''
    62. 

  62. 

  63. % highlight NEW topic on TOC
    64. 

  64. %%!postproc(html): '(<LI>.*Mastering Macros</A>)$' '\1 <b>[NEW!]</b>'
    65. 

  65. 

  66. %%% Little clean up for less large tables
    67. 

  67. %!postproc: /pessoal/sourceforge.net ''
    68. 

  68. 

  69. % border for all images
    70. 

  70. %!postproc: '(<IMG [^>]*BORDER)="0"'    '\1="1"'
    71. 

  71. 

  72. 

  73. %%% Embedded CSS code (ugly not?)
    74. 

  74. %
    75. 

  75. %!postproc(html): ^<HEAD>$ '<HEAD>\n<STYLE TYPE="text/css">\n@#@'
    76. 

  76. %!postproc(html): (@#@)$ 'body {background-color:#ddeeff; color:black;   \n\1'
    77. 

  77. %!postproc(html): (@#@)$ '      margin:3em; text-align:justify;}         \n\1'
    78. 

  78. %!postproc(html): (@#@)$ '#header {text-align:center;}                   \n\1'
    79. 

  79. %!postproc(html): (@#@)$ '.toc {border:1px solid black;padding:9px;\n\1'
    80. 

  80. %!postproc(html): (@#@)$ '            background-color:white;}           \n\1'
    81. 

  81. %!postproc(html): (@#@)$ '.toc li{list-style-type: none;}                \n\1'
    82. 

  82. %!postproc(html): (@#@)$ 'a {text-decoration:none;}\na:hover {color:red;}\n\1'
    83. 

  83. %!postproc(html): (@#@)$ 'a:visited {color:purple;}\ndl {margin:1em;}    \n\1'
    84. 

  84. %!postproc(html): (@#@)$ '#body h1 {text-align:center; color:white;      \n\1'
    85. 

  85. %!postproc(html): (@#@)$ '          background-color:blue; padding:8px;} \n\1'
    86. 

  86. %!postproc(html): (@#@)$ 'h2 {padding-top:20px;}\nhr {border-style:none;}\n\1'
    87. 

  87. %!postproc(html): (@#@)$ 'code {background-color:lightblue;}             \n\1'
    88. 

  88. %!postproc(html): (@#@)$ 'blockquote {border:1px solid black;padding:9px;\n\1'
    89. 

  89. %!postproc(html): (@#@)$ '            background-color:white;}           \n\1'
    90. 

  90. %!postproc(html): (@#@)$ 'table {border-style:solid; border-color:black;}\n\1'
    91. 

  91. %!postproc(html): (@#@)$ 'th {background-color:lightblue; padding:.5em;} \n\1'
    92. 

  92. %!postproc(html): (@#@)$ 'td {border-style:none; background-color:white;}\n\1'
    93. 

  93. %!postproc(html): (@#@)$ 'pre {border-style:solid; border-width:1px 1px; \n\1'
    94. 

  94. %!postproc(html): (@#@)$ '     background-color:lightblue; padding:8px;  \n\1'
    95. 

  95. %!postproc(html): (@#@)$ '     border-color:black;}                      \n\1'
    96. 

  96. %!postproc(html):  @#@$  </STYLE>
    97. 

  97. 

  98. % 26/Nov/2003: revised by anamimts
    99. 

  99. % 26/Jun/2004: updated to v2, new embedded CSS 
    100. 

  100. % 17/Jul/2004: revised by anamimts
    101. 

  101. % 01/Nov/2004: updated to v2.0 and 2.1, new chapters, PDF version
    102. 

  102. 

  103. % TODO Mastering Options [option-help], [option-css-sugar], ...
    104. 

  104. 

  105. ========================================================================
    106. 

  106. 

  107. %nopdf	"ĄHola! Čsto es la Guia del Usuario de Txt2tags. Aquí podrás encontrar
    108. 

  108. %nopdf	toda la información disponible sobre la herramienta de conversión de textos txt2tags.
    109. 

  109. %nopdf	Puedes encontrar la última versión en  http://txt2tags.org/userguide/. 
    110. 

  110. %nopdf	Para más información, visita la
    111. 

  111. %nopdf	[web de txt2tags  http://txt2tags.org]. ĄQue disfrutes!"
    112. 

  112. %nopdf  
    113. 

  113. %%nopdf	[Download PDF version http://txt2tags.org/userguide/userguide.pdf]
    114. 

  114. 

  115. ========================================================================
    116. 

  116. 

  117. %nopdf%**This Guide Contains:**
    118. 

  118. 

  119. %%toc
    120. 

  120. 

  121. ========================================================================
    122. 

  122. 

  123. = Parte I - Introducción a Txt2tags =[intro]
    124. 

  124. 

  125. == Tus Primeras Preguntas ==[1st-questions]
    126. 

  126. 

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

  128. 

  129. ------------------------------------------------------------------------
    130. 

  130. 

  131. === żQue és Txt2tags? ===
    132. 

  132. 

  133. Txt2tags es una herramienta de formateo y conversión de texto.
    134. 

  134. Txt2tags convierte un archivo de texto con algunas marcas a uno de los siguientes tipos de archivo:
    135. 

  135. 

  136. - Documento HTML 
    137. 

  137. - Documento XHTML 
    138. 

  138. - Documento SGML 
    139. 

  139. - Documento LaTeX 
    140. 

  140. - Página man de UNIX 
    141. 

  141. - Presentación Magic Point
    142. 

  142. - Página MoinMoin 
    143. 

  143. - Documento PageMaker 6.0 
    144. 

  144. - Texto plano (sin marcas)
    145. 

  145. 

  146. 

  147. ------------------------------------------------------------------------
    148. 

  148. 

  149. === żPor Qué Debo Usar Txt2tags?  ===
    150. 

  150. 

  151. Encontarás txt2tags muy útil si:
    152. 

  152. - precisas publicar documentos en diferentes formatos
    153. 

  153. - precisas mantener documentos actualizados en diferentes formatos
    154. 

  154. - escribes manuales o documentos técnicos
    155. 

  155. - no sabes como escribir un documento en un formato específico
    156. 

  156. - no posees un editor específico para cierto formato
    157. 

  157. - quieres usar un editor de texto simple para actualizar tus documentos
    158. 

  158. 

  159. 

  160. Pero la motivación principal es:
    161. 

  161. - economizar tiempo,escribiendo **contenido** sin preocuparse del **formato**
    162. 

  162. 

  163. 

  164. ------------------------------------------------------------------------
    165. 

  165. 

  166. === żQué ventajas ofrece, comparado con otras herramientas? ===
    167. 

  167. 

  168. Txt2tags se encuentra en constante crecimiento, siguiendo una serie de conceptos basicos:
    169. 

  169. 

  170. 

  171. | //Archivo fuente legible// | Las marcas de txt2tags son muy simples, casi naturales
    172. 

  172. | //Documento destino legible// | Como el archivo fuente, el código del documento generado es también legible
    173. 

  173. | //Consistencia en las marcas// | Las marcas txt2tags son únicas, atendiendo todos los tipos de documentos, sin ser confundidas con el contenido
    174. 

  174. | //Reglas consistentes// | De la misma manera que las marcas, las reglas a ellas aplicadas son uniformes, sin excepciones ni casos especiales..
    175. 

  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. 

  176. | //Facil de apreder// | Con marcas simples y código fuente legible, presenta una curva de aprendizaje muy amigable.
    177. 

  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. 

  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. 

  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. 

  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. 

  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. 

  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. 

  183. 

  184. 

  185. ------------------------------------------------------------------------
    186. 

  186. 

  187. === ż Cuanto cuesta ? ===
    188. 

  188. 

  189.                 || ĄABSOLUTAMENTE NADA! |
    190. 

  190. 

  191. Txt2tags es un programa gratuito,GLP,open source,dominio público,etc...
    192. 

  192. %//<put-your-favorite-buzzword-here>//.
    193. 

  193. 

  194. Puedes copiarlo,usarlo,modificarlo,venderlo.. etc. Las polítcas de software y copyright no se encuentran entre las mayores preocupaciones del autor.
    195. 

  195. 

  196. ------------------------------------------------------------------------
    197. 

  197. 

  198. 

  199. == Estructuras de Formato Soportadas por txt2tags ==[structures]
    200. 

  200. 

  201. 

  202. - Encabezamiento (Cabeceras) ( título del documento, nombre de autor,fecha)
    203. 

  203. - Títulos de secciones (numeradas o no)
    204. 

  204. - Parráfos
    205. 

  205. - Modificadores de fuentes
    206. 

  206.   - Negrita (bold)
    207. 

  207.   - Itálica
    208. 

  208.   - Subrayada
    209. 

  209. - Fuente no proporcional (Monoespaciada/Verbatim)
    210. 

  210.   - Monoespaciada en un párafo
    211. 

  211.   - Línea monoespaciada
    212. 

  212.   - Zona en monoespaciado (multilínea)
    213. 

  213. - Cítas
    214. 

  214. - Enlaces
    215. 

  215.   - URL/ enlaces internet
    216. 

  216.   - enlaces  e-mail
    217. 

  217.   - enlaces locales
    218. 

  218.   - enlaces nombrados
    219. 

  219. - Listas
    220. 

  220.   - listas marcadas
    221. 

  221.   - listas numeradas
    222. 

  222.   - listas de definicion
    223. 

  223. - Líneas de separación horizontal
    224. 

  224. - Imágenes (con un alineamiento adecuado)
    225. 

  225. - Tablas (con o sin borde,con alineamiento , con expansión de columna)
    226. 

  226. - Marcas especiales para texto raw ( que no debe ser tratado)
    227. 

  227. - Macro especial para la fecha actual (con formato flexible)
    228. 

  228. - Comentarios (para notas,TODO,FIXME,etc)
    229. 

  229. 

  230. 

  231. ------------------------------------------------------------------------
    232. 

  232. 

  233. == Formatos de salida soportados ==[targets]
    234. 

  234. 

  235. : **HTML**
    236. 

  236.   Todos sabemos lo que es HTML.
    237. 

  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.
    239. 

  239. Txt2tag genera código "//HTML 4.0 Transitional//".
    240. 

  240. 

  241.   Desde la versión 2.0 de txt2tags el código HTML generado es aprobado al 100% 
    242. 

  242.   por el [ validador w3c http://validator.w3.org/].
    243. 

  243. 

  244. : **XHTML**
    245. 

  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. 

  246.   Txt2tag genera código "XHTML 1.0 Transitional".
    247. 

  247.   
    248. 

  248.   Desde la versión 2.0 de txt2tags el código XHTML generado es aprobado al 100% 
    249. 

  249.   por el [ validador w3c http://validator.w3.org/].
    250. 

  250. 

  251. 

  252. : **SGML**
    253. 

  253.   Es un formato de documento común que posee aplicaciones de conversiňn, como
    254. 

  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. 

  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. 

  257. 

  258. : **LATEX**
    259. 

  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. 

  260.   
    261. 

  261. Txt2tag 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. 

  262. 

  263.   
    264. 

  264. 

  265. : **LOUT**
    266. 

  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. 

  267.   
    268. 

  268. Txt2tag genera archivos Lout listos para su uso, que pueden ser convertidos a PS o PDF utilizando la orden "lout".
    269. 

  269. 

  270. : **MAN**
    271. 

  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. 

  272.  
    273. 

  273. Hay 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. 

  274. 

  275. : **MGP (Magic Point)**
    276. 

  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. 

  277.   
    278. 

  278. Txt2tag 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. 

  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. 

  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. 

  283. 

  284. 

  285.   La clave es : Convierte y Usa. Sin necesidad de posteriores u otros requisitos.
    286. 

  286. 

  287. : **MOIN**
    288. 

  288.   ż No sabes lo que és [MoinMoin http://moin.sourceforge.net]?
    289. 

  289.  ĄEs un [WikiWiki http://www.c2.com/cgi/wiki]!
    290. 

  290. 

  291.   La sintaxis de Moin es un poco liada: tienes que escribir cosas cómo
    292. 

  292.   ``{{{'''''adding braces and quotes'''''}}}``.Pero txt2tag viene con marcadores simplificados y una solución unificada: una fuente, múltiples formatos destino.
    293. 

  293. 

  294. : **PM6**
    295. 

  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. 

  296.   
    297. 

  297. Txt2tag genera todas las marcas y define un encabezamiento extenso y funcional, configurando los estilos de párrafo y formatos.
    298. 

  298. **ĄAtención!:** Sin saltos de linea. Cada párrafo debe ser una sola linea.
    299. 

  299. 

  300.  Nota del Autor:
    301. 

  301.   //Todo mi libro sobre [expresiones regulares http://guia-er.sf.net]//
    302. 

  302.   //fue escrito con Vi, convertido al formato PageMaker con txt2tag//
    303. 

  303.   //y enviado a la imprenta.//
    304. 

  304. 

  305. : **TXT**
    306. 

  306.   TXT es texto. El único tipo de formato verdadero.
    307. 

  307.   
    308. 

  308. A pesar que las marcas de txt2tag son intuitivas y discretas, puedes eliminarlas convirtiendo el archivo al formato TXT puro.
    309. 

  309. 

  310. Los títulos estaran subrayados y el texto es, basicamente, conservado cómo estaba en el archivo fuente.
    311. 

  311. 

  312. 

  313. ------------------------------------------------------------------------
    314. 

  314. 

  315. == Estructuras Soportadas en los Archivos finales ==[struct-support]
    316. 

  316. 

  317.   || Estructura       | html | xhtml | sgml | tex | lout | man | mgp | moin | pm6 | txt |
    318. 

  318.   | cabeceras         |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  N   |  N  |  S  |
    319. 

  319.   | sección título    |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  S  |
    320. 

  320.   | párrafos          |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  S  |
    321. 

  321.   | negrita              |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  -  |
    322. 

  322.   | itálica           |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  -  |
    323. 

  323.   | subrayado         |  S   |   S   |  -   |  S  |  S   |  -  |  S  |  S   |  S  |  -  |
    324. 

  324.   | f.monoespacio     |  S   |   S   |  S   |  S  |  S   |  -  |  S  |  S   |  S  |  -  |
    325. 

  325.   | línea verbatim    |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  -  |
    326. 

  326.   | área verbatim     |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  -  |
    327. 

  327.   | área de cita      |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  S  |
    328. 

  328.   | links internet    |  S   |   S   |  S   |  -  |  -   |  -  |  -  |  S   |  -  |  -  |
    329. 

  329.   | links e-mail      |  S   |   S   |  S   |  -  |  -   |  -  |  -  |  S   |  -  |  -  |
    330. 

  330.   | links locales     |  S   |   S   |  S   |  N  |  N   |  -  |  -  |  S   |  -  |  -  |
    331. 

  331.   | links nombrados   |  S   |   S   |  S   |  -  |  -   |  -  |  -  |  S   |  -  |  -  |
    332. 

  332.   | listas marcadas   |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  S  |
    333. 

  333.   | listas numeradas  |  S   |   S   |  S   |  S  |  S   |  S  |  S  |  S   |  S  |  S  |
    334. 

  334.   | listas definición |  S   |   S   |  S   |  S  |  S   |  S  |  N  |  N   |  N  |  S  |
    335. 

  335.   | línea horizontal  |  S   |   S   |  -   |  S  |  S   |  -  |  S  |  S   |  N  |  S  |
    336. 

  336.   | imágen            |  S   |   S   |  S   |  S  |  S   |  -  |  S  |  S   |  N  |  -  |
    337. 

  337.   | tabla             |  S   |   S   |  S   |  S  |  N   |  S  |  N  |  S   |  N  |  N  |
    338. 

  338.   || Extras           | html | xhtml | sgml | tex | lout | man | mgp | moin | pm6 | txt |
    339. 

  339.   | alineación imágen |  S   |   S   |  N   |  N  |  Y   |  -  |  S  |  N   |  N  |  -  |
    340. 

  340.   | alin celdas tb    |  S   |   S   |  S   |  S  |  N   |  Y  |  N  |  S   |  N  |  N  |
    341. 

  341.   | span columna tb   |  S   |   S   |  N   |  N  |  N   |  N  |  N  |  N   |  N  |  N  |
    342. 

  342. 

  343.   ||      | Significados
    344. 

  344.   | **S** | //Soportado//
    345. 

  345.   | **N** | //No soportado (tal vez en futuras versiones....)//
    346. 

  346.   | **-** | //No soportado (no es posible en este tipo de archivo final)//
    347. 

  347. % | **?** | //not supported (not sure if it can be done or not)//
    348. 

  348. 

  349. ------------------------------------------------------------------------
    350. 

  350. 

  351. == Las tres interfaces de usuario: GUI, Web y Línea de Comandos ==[interfaces]
    352. 

  352. 

  353. Considerando 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. 

  354. 

  355. - **Gui**: Escrita en Tk. Aporta a txt2tags  un entorno de ventanas y la facilidad del "clic" de ratón.
    356. 

  356. - **Web**: Escrita en PHP, permite operar remotamente con txt2tags, mediante un navegador, sin necesidad de instalación local
    357. 

  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. 

  358. 

  359. 

  360. ------------------------------------------------------------------------
    361. 

  361. 

  362. === Interfaz Gráfica Tk ===[gui]
    363. 

  363. 

  364. Desde su versión 1.0, txt2tags dispone de una interfaz gráfica que funciona en Linux, Mac, Windows y otros sistemas operativos.
    365. 

  365. 

  366. Al 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. 

  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. 

  369. 

  370. La interfaz es simple e intuitiva:
    371. 

  371. 

  372.                      [IMGPATH/gui.png]  
    373. 

  373. 

  374. + Localizar el archivo fuente .t2t en el disco.
    375. 

  375. 

  376. + Elegir un tipo de documento de salida.
    377. 

  377. 

  378. + A continuación podran elegirse una serie de opciones, aunque ninguna de ellas es imprescindible.
    379. 

  379. 

  380. + Finalmente, activando "Convert!", se realiza la conversión del documento.
    381. 

  381. 

  382. 

  383. Una 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. 

  384. 

  385. Los colores que vienen por defecto pueden cambiarse en el archivo ``~/.txt2tagsrc``
    386. 

  386. usando los ajustes ``%!guicolors`` Por ejemplo:
    387. 

  387. 

  388. ```
    389. 

  389. % set my own colors for the graphical interface (bg1, fg1, bg2, fg2)
    390. 

  390. %!guicolors: blue white brown yellow
    391. 

  391. ```
    392. 

  392. 

  393. ------------------------------------------------------------------------
    394. 

  394. 

  395. === Interfaz Web  ===
    396. 

  396. 

  397. La interfaz web se encuentra disponible en: http://txt2tags.org/online.php . Allí puedes usar y probar el programa sin necesidad de instalarlo localmente.
    398. 

  398. 

  399.           [IMGPATH/web.png]  
    400. 

  400. 

  401. Tambié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. 

  402. 

  403. ------------------------------------------------------------------------
    404. 

  404. 

  405. === Interfaz de Línea de Comandos (Cónsola) ===[cmdline]
    406. 

  406. 

  407. A los usuarios de esta interfaz, la opción --help les debe proporcionar salida en pantalla parecida a čsta:
    408. 

  408. 

  409. ```
    410. 

  410. Usage: txt2tags [OPTIONS] [infile.t2t ...]
    411. 

    412. 

  412.   -t, --target        set target document type. currently supported:
    413. 

  413.                       html, xhtml, sgml, tex, lout, man, mgp, moin, pm6, txt
    414. 

  414.   -i, --infile=FILE   set FILE as the input file name ('-' for STDIN)
    415. 

  415.   -o, --outfile=FILE  set FILE as the output file name ('-' for STDOUT)
    416. 

  416.   -n, --enum-title    enumerate all title lines as 1, 1.1, 1.1.1, etc
    417. 

  417.   -H, --no-headers    suppress header, title and footer contents
    418. 

  418.       --headers       show header, title and footer contents (default ON)
    419. 

  419.       --encoding      set target file encoding (utf-8, iso-8859-1, etc)
    420. 

  420.       --style=FILE    use FILE as the document style (like HTML CSS)
    421. 

  421.       --css-sugar     insert CSS-friendly tags for HTML and XHTML targets
    422. 

  422.       --css-inside    insert CSS file contents inside HTML/XHTML headers
    423. 

  423.       --mask-email    hide email from spam robots. x@y.z turns <x (a) y z>
    424. 

  424.       --toc           add TOC (Table of Contents) to target document
    425. 

  425.       --toc-only      print document TOC and exit
    426. 

  426.       --toc-level=N   set maximum TOC level (depth) to N
    427. 

  427.       --rc            read user config file ~/.txt2tagsrc (default ON)
    428. 

  428.       --gui           invoke Graphical Tk Interface
    429. 

  429.   -q, --quiet         quiet mode, suppress all output (except errors)
    430. 

  430.   -v, --verbose       print informative messages during conversion
    431. 

  431.   -h, --help          print this help information and exit
    432. 

  432.   -V, --version       print program version and exit
    433. 

  433.       --dump-config   print all the config found and exit
    434. 

    435. 

  435. Turn OFF options:
    436. 

  436.      --no-outfile, --no-infile, --no-style, --no-encoding, --no-headers
    437. 

  437.      --no-toc, --no-toc-only, --no-mask-email, --no-enum-title, --no-rc
    438. 

  438.      --no-css-sugar, --no-css-inside, --no-quiet
    439. 

    440. 

  440. Example:
    441. 

  441.      txt2tags -t html --toc myfile.t2t
    442. 

    443. 

  443. By default, converted output is saved to 'infile.<target>'.
    444. 

  444. Use --outfile to force an output file name.
    445. 

  445. If  input file is '-', reads from STDIN.
    446. 

  446. If output file is '-', dumps output to STDOUT.
    447. 

  447. ```
    448. 

  448. 

  449. ==== Ejemplos: ====
    450. 

  450. 

  451. Suponiendo que se haya creado un archivo marcado,denominado ``file.t2t``, veamos varias opciones de conversión:
    452. 

  452. 

  453. | **Convertir a HTML**            | ``$ txt2tags -t html file.t2t``
    454. 

  454. | **Usando redireccionamiento**    | ``$ txt2tags -t html -o - file.t2t > file.html``
    455. 

  455. |  | .
    456. 

  456. | **Con Índice de Contenidos**    | ``$ txt2tags -t html --toc file.t2t``
    457. 

  457. | **Con Títulos Numerados**       | ``$ txt2tags -t html --toc --enum-title file.t2t``
    458. 

  458. |  | .
    459. 

  459. | **Vista rápida del Índice**     | ``$ txt2tags --toc-only file.t2t``
    460. 

  460. | **żÍndice numerado? ĄSi!**     | ``$ txt2tags --toc-only --enum-title file.t2t``
    461. 

  461. |  | .
    462. 

  462. | **...... desde STDIN**          | ``$ echo -e "\n**bold**" | txt2tags -t html --no-headers -``
    463. 

  463. | **Enmascarando los e-mails**  | ``$ echo -e "\njohn.wayne@farwest.com" | txt2tags -t txt --mask-email --no-headers -``
    464. 

  464. | **Edición post-conversión**     | ``$ txt2tags -t html -o- file.t2t | sed "s/<BODY .*/<BODY BGCOLOR=green>/" > file.html``
    465. 

  465. 

  466. : //Nota//
    467. 

  467.    Desde la versión 1.6 es posible realizar un tratamiento pre y post conversión mediante los filtros 
    468. 

  468.    ``%!preproc`` y ``%!postproc`` .
    469. 

  469. 

  470. 

  471. ========================================================================
    472. 

  472. 

  473. 

  474. 

  475. = Parte II: - OK!, Quiero utilizar el programa. żQue debo hacer ? =[install]
    476. 

  476. 

  477. Sencillamente, descargar el programa y hacer que corra en tu máquina  :-).Veamos como hacerlo.
    478. 

  478. 

  479. == Obtener e instalar Python ==[download-python]
    480. 

  480. 

  481. En primer lugar, deberemos instalar el interprete Python en nuestro sistema. Si ya lo tenemos instalado, podemos saltarnos este apartado.
    482. 

  482. 

  483. Python 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. 

  484. 

  485. Si 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. 

  486. 

  487. 

  488. == Obtener Txt2tags ==[download-txt2tags]
    489. 

  489. 

  490. El sitio oficial de la distribución de txt2tags es: http://txt2tags.org/src .
    491. 

  491. 

  492. Todos 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. 

  493. 

  494. Debemos 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. 

  495. 

  496. == Instalar txt2tags ==[install-txt2tags]
    497. 

  497. 

  498. Como todos los scripts Python, txt2tags apenas precisa de instalación.
    499. 

  499. 

  500. El ú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. 

  501. 

  502. El medio mas seguro de iniciar txt2tags es "llamarlo" desde Python.
    503. 

  503. ``` prompt$ python txt2tags
    504. 

    505. 

  505. Si 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. 

  507. : **UNIX/Linux**
    508. 

    509. 

  509.   Asegurémosnos de que el script es ejecutable : ``chmod +x txt2tags`` y, seguidamente lo copiamos en un directorio referenciado por  $PATH:
    510. 

  510.   ``cp txt2tags /usr/local/bin``
    511. 

    512. 

  512. : **Windows**
    513. 

    514. 

  514.   Renombrar el script ańadiéndole la extensión .py :
    515. 

  515.   ``ren txt2tags txt2tags.py`` y copiarlo en un directorio referenciado en $PATH: 
    516. 

  516.   ``copy txt2tags.py C:\WINNT``
    517. 

    518. 

    519. 

  519. Después de esto, si deseais utilizar el entorno gráfico, podreis crear un icono en vuestro escritorio.
    520. 

    521. 

  521. === Paquetes especiales para los usuarios de Windows ===
    522. 

    523. 

  523. Existen dos distribuciones .EXE de txt2tags, que instalan el programa en maquinás Windows con solo unos cuantos "clics":
    524. 

    525. 

  525. - La primera es el simple script txt2tags para los que tengan instalado Python.
    526. 

  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. 

    529. 

  529. Se pueden obnener en //Txt2tags-Win//:  http://txt2tags-win.sf.net
    530. 

    531. 

  531. == Instalación de los Archivos de Sintaxis para los Editores de Texto ==[editor-syntax]
    532. 

    533. 

  533. Con txt2tags se proporcionan una serie de archivos de sintaxis prácticos, utilizables con los siguientes editores:
    534. 

    535. 

  535. - Vim (www.vim.org)
    536. 

  536. - Emacs (www.emacs.org)
    537. 

  537. - Nano (www.nano-editor.org)
    538. 

  538. - Kate (http://kate.kde.org)
    539. 

    540. 

    541. 

  541. Estos 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. 

  544.            |  [IMGPATH/vim.png]  |
    545. 

  545.            |  Ejemplo de archivo editado en Vim 
    546. 

    547. 

  547. Cada editor tiene un procedimiento de instalación específico. Consulta el encabezamiento del archivo de sintaxis y la documentación del editor.
    548. 

    549. 

  549. ========================================================================
    550. 

    551. 

    552. 

    553. 

  553. = Parte III - Escribiendo y convirtiendo vuestro primer documento. =[your-1st-doc]
    554. 

    555. 

  555. == Probar las herramientas ==
    556. 

    557. 

  557. Para poder hacer vuestra primera conversión necesitareis tres cosas: txt2tags, un editor y un navegador web.
    558. 

    559. 

  559. + Comprobad que txt2tags funciona correctamente en vuestra máquina.
    560. 

    561. 

  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. 

  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. 

  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. 

  567. + Lanzad vuestro browser preferido para poder ver los resultados de la conversión en una pagina HTML.
    568. 

    569. 

    570. 

  570. ------------------------------------------------------------------------
    571. 

    572. 

  572. == Escribir el encabezamiento del documento ==
    573. 

    574. 

  574. + Id al editor de texto y teclead una primera línea , por ejemplo: //Mi Primer Documento//
    575. 

  575. + En una segunda línea teclead un sub-título, por ejemplo://txt2tags//
    576. 

  576. + Después, en una tercera línea teclead, por ejemplo, una fecha: //Domingo 17  Julio 2005//
    577. 

    578. 

    579. 

  579. Así, dispondremos de un documento con el siguiente contenido:
    580. 

    581. 

  581. ```
    582. 

  582. Mi primer documento
    583. 

  583. txt2tags
    584. 

  584. Domingo 17 Julio 2005
    585. 

  585. ```
    586. 

    587. 

  587. Aunque ésto sea sólo una parte del documento, podemos convertirlo y comprobar el resultado.
    588. 

  588. Guardad 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. 

  591. ------------------------------------------------------------------------
    592. 

    593. 

  593. == La Primera Conversión : La Interfaz Gráfica. ==
    594. 

    595. 

  595. Si utilizais la interfaz de línea de comandos, pasad a la siguiente sección.
    596. 

    597. 

    598. 

  598. Si utilizais la interfaz gráfica, proceded tal como a continuación se indica:
    599. 

    600. 

  600.     [IMGPATH/firstdoc.png] 
    601. 

    602. 

  602. + Clicar en el botón "Browser", navegad hasta el directorio en el que guardasteis el documento test.tx y seleccionarlo.
    603. 

  603. + En el apartado "Choose the target document type" (Elija el tipo de documento de salida) escoged : "HTML page"
    604. 

  604. + Clicar el boton "Convert!" (Convertir)
    605. 

    606. 

    607. 

  607.    [IMGPATH/firstdoc-done.png] 
    608. 

    609. 

  609. Aparecerá 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. 

  611. ------------------------------------------------------------------------
    612. 

    613. 

  613. == La Primera Conversión: Interface en Línea de Comandos ==
    614. 

    615. 

  615. Si utilizais la interfaz gráfica, id a la sección anterior.
    616. 

    617. 

  617. Si 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. 

  619. ``` txt2tags  --target  html  test.txt
    620. 

  620. 

  621. Observad 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. 

  622. 

  623. Si la conversión se realiza con éxito, el resultado es guardado como ``test.html``
    624. 

  624. y 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. 

  625. 

  626. Esto es una muestra de lo que podeis ver en la pantalla:
    627. 

  627. ```
    628. 

  628. prompt$ txt2tags --target html test.txt
    629. 

  629. txt2tags wrote test.html
    630. 

  630. prompt$
    631. 

  631. ```
    632. 

  632. 

  633. ------------------------------------------------------------------------
    634. 

  634. 

  635. == Comprobar el resultado ==
    636. 

  636. 

  637. Abrir el archivo ``test.html`` con el navegador y comprobar el resultado de la conversiňn.
    638. 

  638. 

  639. 

  640.    [IMGPATH/firstdoc-html.png] 
    641. 

  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. 

  643. 

  644.   || Vosotros escribis el texto, txt2tags hace el resto :-) |
    645. 

  645. 

  646. Truco: 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. 

  647. 

  648. ------------------------------------------------------------------------
    649. 

  649. 

  650. == Escribir el cuerpo del documento ==
    651. 

  651. 

  652. Volvamos 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. 

  653. 

  654. Guardad 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. 

  655. 

  656. Observad el contenido del archivo de texto plano ``test.txt`` y comparémoslo con el archivo HTML generado:
    657. 

  657. 

  658. ```
    659. 

  659. Mi primer documento
    660. 

  660. txt2tags
    661. 

  661. Domingo 17 Julio 2005
    662. 

  662. Bueno, vamos a probar txt2tags.
    663. 

  663. No se me ocurre nada que escribir. Probemos con una lista.
    664. 

    665. 

  665. Necesitaria:
    666. 

  666. - Ducharme
    667. 

  667. - Comer una pizza
    668. 

  668. - Dormir
    669. 

  669. ```
    670. 

  670. 

  671.    [IMGPATH/firstdoc-fullhtml.png] 
    672. 

  672. 

  673. 

  674. Con 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. 

  675. 

  676. Ademá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. 

  677. 

  678. ``**comienza en negrita**`` y ``== los signos igual para el título ==``. 
    679. 

  679. 

  680. Para aprender a utilizar estas marcas consultad el archivo  [Txt2tags Markup Demo http://txt2tags.org/markup.html].
    681. 

  681. 

  682. =======================================================================
    683. 

  683. 

  684. 

  685. 

  686. = Parte IV - Dominando los Conceptos de Txt2tags =[concepts]
    687. 

  687. 

  688. == Las Áreas de un Documento .t2t ==[areas]
    689. 

  689. 

  690. Los 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. 

  691. 

  692. : //ENCABEZAMIENTO// 
    693. 

  693.   Lugar para el título del documento, nombre del autor, versión y fecha. (opcional)
    694. 

  694. : //CONFIGURACIÓN//
    695. 

  695.   Lugar para la configuración general del documento. (opcional)
    696. 

  696. : //CUERPO//
    697. 

  697.   Lugar en el que se coloca el contenido del documento. (obligatoria)
    698. 

  698. 

  699. 

  700. Como se ha podido observar, solo el área del //CUERPO//
    701. 

  701. es obligaroria.
    702. 

  702. 

  703. Cada á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. 

  704. 

  705. 

  706. ```
    707. 

  707.        _________________
    708. 

  708.       |                 |
    709. 

  709.       | ENCABEZAMIENTO  |   1. En primer lugar,los Encabezamientos
    710. 

  710.       |                 |
    711. 

  711.       | CONFIGURACIÓN   |   2. Después,las Configuraciones
    712. 

  712.       |                 |
    713. 

  713.       |   CUERPO        |   3. Finalmente,el Cuerpo del documento,
    714. 

  714.       |                 |
    715. 

  715.       |    ...          |       el cual abarca hasta el final
    716. 

  716.       |    ...          |
    717. 

  717.       |_________________|  
    718. 

    719. 

  719. ```
    720. 

  720. 

  721. En resumen, así es como se definen las tres áreas:
    722. 

  722. 

  723.  |  **Encabezamiento**  | Las primeras 3 líneas del archivo. O la primera línea en blanco, cuando no se quiere un Encabezamiento.
    724. 

  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. 

  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. 

  726. 

  727. 

  728. === Veamos un ejemplo: ===
    729. 

  729. 

  730. ```
    731. 

  731. My nice doc Title
    732. 

  732. Mr. John Doe
    733. 

  733. Last Updated: %%mtime(%c)
    734. 

    735. 

  735. %! Target  : html
    736. 

  736. %! Style   : fancy.css
    737. 

  737. %! Encoding: iso-8859-1
    738. 

  738. %! Options : --toc --enum-title
    739. 

    740. 

  740. Hi! This is my test document.
    741. 

  741. Its content will end here.
    742. 

  742. ```
    743. 

  743. 

  744. ------------------------------------------------------------------------
    745. 

  745. 

  746. == Área de Encabezamiento ==[headers-area]
    747. 

  747. 

  748. Localización:
    749. 

  749. - Posicion fija: Las **tres pimeras líneas** de un archivo. Eso es todo :-)
    750. 

  750. - Posicion fija: La **primera línea** de un archivo, si se trata de una línea en blanco. Esto signfica "Encabezamiento vacio".
    751. 

  751. 

  752. 

  753. El Á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. 

  754. 

  755. El contenido de estas líneas no esta regulado, es libre, aunque se recomienda que se siga la siguiente pauta:
    756. 

  756. 

  757.    - //línea 1//: título del documento
    758. 

  758.    - //línea 2//: nombre del autor y/o email
    759. 

  759.    - //línea 3//: fecha del documento y/o versión (un buén lugar para ``%%date``)
    760. 

  760. 

  761. 

  762. Retengamos 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. 

  763. 

  764. 

  765. ==== Menos (o Ninguna) líneas de Encabezamiento ====
    766. 

  766. 

  767. Tal vez deseemos menos líneas de encabezamiento. Por ejemplo, solo deseamos especificar el título y la fecha.
    768. 

  768. 

  769. Para 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. 

  770. 

  771. La 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. 

  772. 

  773. No 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. 

  774. 

  775. %==== Straight to the point ====
    776. 

  776. 

  777.  || En resumen: Los Encabezamientos son posiciones, no contenidos. |
    778. 

  778. 

  779. Si 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. 

  780. 

  781. ------------------------------------------------------------------------
    782. 

  782. 

  783. == Area de Configuración ==[config-area]
    784. 

  784. 

  785. Localización:
    786. 

  786. - Comienza justo despues del Área de Encabezamiento
    787. 

  787.   - Comienza a partir de la 4Ş línea si se especifican encabezamientos
    788. 

  788.   - Comienza a partir de la 2Ş línea en el caso de **Encabezamiento vacio**.
    789. 

  789. - Finaliza donde comienza el Área del Cuerpo del documento
    790. 

  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. 

  791. 

  792. 

  793. El Á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. 

  794. 

  795. El Á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. 

  796. 

  797. Para mas información, consultar la Sección:[Configuraciones (Settings section) #settings-overview].
    798. 

  798. 

  799. ----------------------------------------------------------------
    800. 

  800. 

  801. == Área del Cuerpo del Documento ==[body-area]
    802. 

  802. 

  803. Localización:
    804. 

  804. - Comienza con la primera línea válida de texto del archivo.
    805. 

  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. 

  806. - Finaliza al final del archivo (EOF)
    807. 

  807. 

  808. 

  809. Consideraremos Cuerpo todo lo que no sea ni Encabezamiento ni Configuración.
    810. 

  810. 

  811. El Cuerpo está constituido por el contenido del documento y todas aquellas estructuras y formatos que txt2tags puede reconocer.
    812. 

  812. En el Cuerpo pueden incluirse comentarios para los //TODOs// y notas personales.
    813. 

  813. 

  814. Puede 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. 

  815. 

  816. ----------------------------------------------------------------
    817. 

  817. 

  818. == Configuraciones: żCómo Configurar algo?. żCuál es la sintaxis? ==[settings-overview]
    819. 

  819. 

  820. Las 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. 

  821. 

  822.  || %! palabra-clave : valor |
    823. 

  823. 

  824. Lista de claves válidas:
    825. 

  825. 

  826.  || Clave     | Descripción |
    827. 

  827.  |   Target   | Define el formato al cuál debe ser convertido el documento.
    828. 

  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. 

  829.  |   Style    | Sólo es soprtado por el documento destino HTML, para definir una hoja de estilo (CSS)
    830. 

  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. 

  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. 

  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. 

  833. 

  834. Ejemplo:
    835. 

  835. 

  836. ```
    837. 

  837. %! Target  : html
    838. 

  838. %! Options : --toc --toc-level 3
    839. 

  839. %! Style   : fancy.css
    840. 

  840. %! Encoding: iso-8859-1
    841. 

  841. %! PreProc : "AMJ"        "Aurelio Marinho Jargas"
    842. 

  842. %! PostProc: '<BODY.*?>'  '<BODY bgcolor="yellow">'
    843. 

  843. ```
    844. 

  844. 

  845. -----------------------------------------------------------------------
    846. 

  846. === Algunas reglas sobre las Configuraciones ===
    847. 

  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. 

  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. 

  850. 

  851. - Una línea de configuración con una palabra-clave inválida será considerada un comentario.
    852. 

  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. 

  854. 

  855. 

  856. == Opciones en Línea de Comando ==[options]
    857. 

  857. 

  858. El 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. 

  859. 

  860. El 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``.
    861. 

  861. A propósito de la opción "target": resulta ser la única opción obligatoria. Todas las demás opciones son eso, opcionales. :-)
    862. 

  862. 

  863. Las opciones más utilizadas son  ``--outfile`` para activar la generación automática de índices de materias y
    864. 

  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. 

  865. ``--no-encoding`` and ``--no-toc``.
    866. 

  866. 

  867. Pueden 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.
    868. 

  868. Por ejemplo: ``%!options: --toc -o mydoc.html``. 
    869. 

  869. La excepción es la especificacion del formato del archivo final, que tiene su propia sintaxis: ``%!target: html``.
    870. 

  870. 

  871. La opción ``--help`` nos proporcionará una lista completa de las opciones disponibles.
    872. 

  872. 

  873. -----------------------------------------------------------------------
    874. 

  874. 

  875. == Archivo de  Configuracion del Usuario (RC) ==[rc]
    876. 

  876. 

  877. El 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. 

  878. 

  879. El 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. 

  880. 

  881.   ||                  | RC file location      |
    882. 

  882.   |          Windows: | ``%HOMEPATH%\_t2trc``
    883. 

  883.   |    Linux y otros: | ``$HOME/.txt2tagsrc``
    884. 

  884.   | Definidod por usuario:  | ``T2TCONFIG`` env var
    885. 

  885. 

  886. 

  887. El 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. 

  888. ``doc/txt2tagsrc``
    889. 

  889. 

  890. Ejemplo:
    891. 

  891. ```
    892. 

  892. % my configs
    893. 

    894. 

  894. %%% Always use CSS-friendly tags in HTML
    895. 

  895. %!options(html): --css-sugar
    896. 

    897. 

  897. %%% Change the default TOC depth for all targets
    898. 

  898. %!options: --toc-level 4
    899. 

    900. 

  900. %%% Set the default encoding for all documents
    901. 

  901. %!options: --encoding iso-8859-1
    902. 

  902. ```
    903. 

  903. 

  904. Toda 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. 

  905. 

  906. Txt2tags 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. 

  907. 

  908. == Orden de Aplicación de las Configuraciones y Precedencia ==[config-loading]
    909. 

  909. 

  910. Hay tres formas de indicar a txt2tags cuales opciones y configuraciones utilizar y el orden que debe aplicarlas:
    911. 

  911. 

  912. + El archivo de usuario RC ( .txt2tagsrc)
    913. 

  913. + Una Área de Configuración en el documento fuente
    914. 

  914. + Las opciones de línea de comando
    915. 

  915. 

  916. 

  917. En 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. 

  918. 

  919. Asi, si el "encoding" del documento fuera definido en las tres opciones, se aplicarian las opciones definidas en la linea de comando.
    920. 

  920. 

  921. 

  922. -----------------------------------------------------------------------
    923. 

  923. 

  924. == El Comando  %!include ==[include]
    925. 

  925. 

  926. Desde 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. 

  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. 

  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. 

  931. 

  932. Ejemplo:
    933. 

  933. 

  934. ```
    935. 

  935. My first book
    936. 

  936. Dr. John Doe
    937. 

  937. 1st Edition
    938. 

    939. 

  939. %!include: intro.t2t
    940. 

  940. %!include: chapter1.t2t
    941. 

  941. %!include: chapter2.t2t
    942. 

  942. ...
    943. 

  943. %!include: chapter9.t2t
    944. 

  944. %!include: ending.t2t
    945. 

  945. ```
    946. 

  946. 

  947. Como 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. 

  948. 

  949. ``` %!include(html): file.t2t
    950. 

    951. 

  951. Debemos 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. 

    953. 

  953. Podemos considerar tres variantes de inclusión:
    954. 

  954. - Verbatim 
    955. 

  955. - Raw 
    956. 

  956. - Tagged 
    957. 

    958. 

    959. 

  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. 

  960. 

  961. ``` %!include: ``/etc/fstab``
    962. 

    963. 

  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.
    964. 

  964. Para incluir un archivo de esta menera basta con colocar su nombre entre dobles-comillas (" " ):
    965. 

    966. 

  966. ``` %!include: ""boom_text.txt""
    967. 

  967. 

  968. **Tagged** : El texto es pasado directamente al documento resultante, sin ningún tratamiento por parte de txt2tags. Mediante este procedimiento podemos incluir en el documento final  textos marcados  o con estructuras complejas no soportadas por txt2tags. Otra aplicación seria la de incluir un encabezamiento o un pié de página en todos los documentos. Para aplicar esta variante de inclusión debemos encerrar el nombre del archivo entre dobles-simples-comillas  ( '' '' ) no entre dobles-comillas ("") como en el anterior caso.
    969. 

  969. 

  970. ``` %!include(html): ''footer.html''
    971. 

    972. 

  972. Como el contenido de cabecera.html contiene tags, es conveniente especificar el destino (html) para evitar problemas..
    973. 

    974. 

  974. -----------------------------------------------------------------------
    975. 

    976. 

  976. == El Comando  %!includeconf ==[includeconf]
    977. 

    978. 

  978.  ``includeconf`` se utiliza para incluir la configuración de un archivo externo en el archivo corriente. Es sólo válido cuando se incluye en el Área de Configuración.
    979. 

    980. 

  980. Es  práctico cuando se desea tener la misma configuración para múltiples archivos, permitiéndonos centralizar su gestión. En el archivo en el que se quiera incluir la configuración global, incluir una llamada ``includeconf``. 
    981. 

    982. 

  982. Ejemplo:
    983. 

    984. 

  984. ```
    985. 

  985. Mi Primer Documento
    986. 

  986. txt2tags
    987. 

  987. Domingo 17 Julio 2005
    988. 

  988. 

  989. %!includeconf: config.t2t
    990. 

  990. 

  991. Este es un ejemplo de includeconf
    992. 

  992. ```
    993. 

  993. El formato del archivo incluido es el mismo que en el [archivo RC #rc].
    994. 

    995. 

  995. =======================================================================
    996. 

    997. 

    998. 

    999. 

  999. = Part V - Dominando las Marcas =[marks]
    1000. 

    1001. 

    1002. 

  1002. Resúmen de las Marcas:
    1003. 

    1004. 

  1004.  ||               Básicas | ``...............`` |  Modificadores | ``...............`` |
    1005. 

  1005.  |          //Encabezamiento// |  primeras 3 lineas  |         //Negrita// |  ""**palabras**"" 
    1006. 

  1006.  |            //Título// |  = palabras =      |       //Itálica// |  ""//palabras//"" 
    1007. 

  1007.  |   //Título numerado// |  + palabras +      |    //Subrayado// |  ""__palabras__"" 
    1008. 

  1008.  |        //Párrafo// |  palabras          |   //Monospaciado// |  ""``palabras``"" 
    1009. 

  1009.  ||         Bloque de Texto | ``...............`` |        Otras | ``...............`` |
    1010. 

  1010.  |            //Cita// |  <TAB>palabras     |  //Línea de separación// |  ------------... 
    1011. 

  1011.  |             //Lista// |  - palabras        |     //Línea gruesa// |  ============... 
    1012. 

  1012.  |    //Lista numerada// |  + palabras        |        //Enlace// |  ""[etiqueta url]"" 
    1013. 

  1013.  |  //Lista definición// |  : palabras        |        //Imágen// |  ""[filename.jpg]"" 
    1014. 

  1014.  |    //Línea Verbatim// |  ``` palabras      |      //Comentario// |  % comentarios 
    1015. 

  1015.  |    //Zona Verbatim// |  ""```\n lineas \n```""  |  //Texto Raw// |  """"palabras"""" 
    1016. 

  1016.  |         //Línea Raw// |  """"""" palabras  |        //Tabla// |  ""| celda1 | celda2 | celda3..."" 
    1017. 

  1017.  |         //Zona Raw// |  """""""\n lineas \n"""""""  |  //Ancla// |  = titulo =[ancla] 
    1018. 

  1018. 

  1019. Reglas Generales:
    1020. 

  1020. 

  1021. - **Encabezamiento:** son las tres primeras líneas del documento, las marcas no son intrepretadas.
    1022. 

  1022. - **Titulos:** son carácteres "=" or "+" , equilibrados alrrededor del texto del título. A mayor número de carácteres, mayor "profundidad" de título ( titulo, sub-título, sub-sub-título, etc).
    1023. 

  1023. - **Modificadores de Fuentes:** no aceptan espacios entre las marcas y su contenido.
    1024. 

  1024. - **Comentario:** la marca "%" debe situarse al comienzo de la línea (primera columna).
    1025. 

  1025. - **Imáges:** el nombre del archivo de imágen debe acabar en GIF, JPG, PNG o similar.
    1026. 

  1026. - Las únicas marcas **multilinea** son las de las zonas verbatin y raw.
    1027. 

  1027. - En las zonas verbatim y raw, ninguna marca es **interpretada**.
    1028. 

  1028. - las **Líneas de Separación/Líneas Gruesas** deben tener, al menos, 20 carácteres.
    1029. 

  1029. - El **(des) anidamiento** de las Citas y Listas viene determinado por la indentación.
    1030. 

  1030. - La **fila de encabezamiento de una Tabla** se define con dos barras verticales || al principio de la fila.
    1031. 

  1031. 

  1032. 

  1033. ------------------------------------------------------------------------
    1034. 

  1034. %- MARKPROP Multiline, FreeSpaces, Align, Nesting
    1035. 

  1035. %- MARKCONT Macros, Beautifiers, Quote, Lists, Table, Verbatim, Raw, Bars, Links, Image, Comment
    1036. 

  1036. %-----------------------------------------------------------------------
    1037. 

  1037. 

  1038. == Encabezamiento ==[mark-headers]
    1039. 

  1039. 

  1040. - **Descripción:** Identifica las cabeceras del documento.
    1041. 

  1041. - **Propiedades:** Multilinea, FreeSpaces, !Align, !Nesting
    1042. 

  1042. - **Contiene:** Macros
    1043. 

  1043. - **Sintaxis:**
    1044. 

  1044.   - Las tres primeras líneas del documento fuente.
    1045. 

  1045.   - Para no especificar encabezamiento, dejar la pimera línea blanco
    1046. 

  1046.   - Dejar en blanco la segunda y/o tercera línea para eliminar otras partes del encabezamiento.
    1047. 

  1047. - **Detalles:**
    1048. 

  1048.   - Las marcas no son interpretadas.
    1049. 

  1049.   - Las tres primeras líneas del documento origen serán las tres primeras del documento final en el que aparecerá resaltadas. Si la paginación es soportada, pueden aparecer aisladas en la primera página del documento final.
    1050. 

  1050.   - El contenido del encabezamiento puede ser cualquier cosa, sin requisito alguno de formato. De todas formas, se recomienda seguir la siguiente estructura:
    1051. 

  1051.     - Linea 1: Título del documento
    1052. 

  1052.     - Linea 2: Nombre del autor y/o e-mail
    1053. 

  1053.     - Linea 3: Fecha del documento y/o versiňn ( buen lugar para ""%%mtime"")
    1054. 

  1054. 

  1055. 

  1056. ------------------------------------------------------------------------
    1057. 

  1057. 

  1058. == Título y Título Numerado ==[mark-title]
    1059. 

  1059. 

  1060. - **Descripción:** Identifica un título de sección, numerado o no.
    1061. 

  1061. - **Propiedades:**!Multiline, FreeSpaces, !Align, !Nesting
    1062. 

  1062. - **Contenido:** Raw
    1063. 

  1063. - **Sintaxis:**
    1064. 

  1064.   - Para títulos numerados, sustituir "=" por "+" en las siguientes reglas.
    1065. 

  1065.   - Equilibrio de signos alrededor de las palabras : ``= asi, si =``  ``==así, no =``
    1066. 

  1066.   - Mas signos,mas sub-niveles : ``=título=``  ``==subtítulo==`` ``===sub-subtitulo===``
    1067. 

  1067.   - Hay un máximo de 5 niveles ``====como esto====``
    1068. 

  1068.   - Los signos no equilibrados no dan lugar a un título : ``=no es tětulo===``
    1069. 

  1069.   - Se autorizan espacios dentro las marcas: ``= como esto =``
    1070. 

  1070.   - Los títulos pueden tener anclas: ``=título=[ancla]``. Para crear un ancla, crear un ``[enlace local#ancla]``
    1071. 

  1071. - **Detalles:**
    1072. 

  1072.   - Las marcas no son  interpretadas.
    1073. 

  1073.   - Las macros no son interpretadas.
    1074. 

  1074. 

  1075. 

  1076. ------------------------------------------------------------------------
    1077. 

  1077. 

  1078. == Párrafo ==[mark-paragraph]
    1079. 

  1079. 

  1080. - **Descripción:** Identifica un párrafo de texto
    1081. 

  1081. - **Propiedades:**Multiline, FreeSpaces, !Align, !Nesting
    1082. 

  1082. - **Contenido:**Macros, Modificadores de Fuentes, Raw, Enlaces, Imagenes, Comentarios
    1083. 

  1083. - **Sintaxis:**
    1084. 

  1084.   - Los párrafos son grupos de líneas delimitados por líneas vacias.
    1085. 

  1085.   - Otros bloques como las listas, las citas, las tablas y las zonas verbatim también cierran párrafos.
    1086. 

  1086. 

  1087. 

  1088. ------------------------------------------------------------------------
    1089. 

  1089. 

  1090. == Comentario ==[mark-comment]
    1091. 

  1091. 

  1092. - **Descripción:** Usados para insertar un texto que no formará parte del documento final.
    1093. 

  1093. - **Propiedades:** !Multiline, !<FreeSpaces, !Align, !Nesting
    1094. 

  1094. - **Contenido:** --
    1095. 

  1095. - **Sintaxis:**
    1096. 

  1096.   - Una línea con un caracter "%" en la primera columna: ``% como ésto``.
    1097. 

  1097.   - Sin espacio delante
    1098. 

  1098. - **Detalles:**
    1099. 

  1099.   - Como comentarios, no se muestran en el texto convertido.
    1100. 

  1100.   - No son un bloque: cada línea de comentario debe comenzar con  "%"
    1101. 

  1101.   - Útiles para TODOs,llamadas FIXME y notas del editor
    1102. 

  1102. 

  1103. 

  1104. ------------------------------------------------------------------------
    1105. 

  1105. 

  1106. == Modificadores de Fuentes: Negrita, Itálica y Subrayado ==[mark-beautifiers]
    1107. 

  1107. 

  1108. - **Descripción:** Utilizado para insertar texto en negrita/itálica/subrayado,en un párrafo, una tabla, una lista o una cita
    1109. 

  1109. - **Propiedades:**!Multiline, !FreeSpaces, !Align, Nesting
    1110. 

  1110. - **Contenidos:** Macros, Modificadores de Fuentes, Raw, Enlaces, Imágenes
    1111. 

  1111. - **Sintaxis:**
    1112. 

  1112.   - Dos arteriscos alrrededor para la negrita: ``**como ésto**``
    1113. 

  1113.   - Dos barras alrededor para la itálica: ``//como ésto//``
    1114. 

  1114.   - Dos guiones-bajos alrededor para el subrayado: ``__como ésto__``
    1115. 

  1115.   - No debe haber espacio entra las marcas y el contenido: ``**  esto és inválido **``
    1116. 

  1116. - **Detalles:**
    1117. 

  1117.   - Todos los modificadores de fuentes deben estar sobre una misma línea del archivo original, no debe haber un salto de línea
    1118. 

  1118.   - Las macros deben emplazarse en el interior de los modificadores de fuentes: ``**%%date**``
    1119. 

  1119.   - Pueden anidarse : ``**__como__//aqui//**``
    1120. 

  1120. 

  1121. ------------------------------------------------------------------------
    1122. 

  1122. 

  1123. == Fuente no Proporcional (Monoespaciada) ==[mark-monospaced]
    1124. 

  1124. 

  1125. - **Descripción:** Utilizado para insertar un texto en fuente no proporcional en un párrafo, una tabla o una cita
    1126. 

  1126. - **Propiedades:** !Multiline, !FreeSpaces, !Align, !Nesting
    1127. 

  1127. - **Contenido:** --
    1128. 

  1128. - **Sintaxis:**
    1129. 

  1129.   - Dos apóstrofes inversos: ````como aqui````
    1130. 

  1130.   - No debe haber espacio entre las marcas y el contenido: ````  esto és inválido ````
    1131. 

  1131. - **Detalles:**
    1132. 

  1132.   - Las marcas no son interpretadas
    1133. 

  1133.   - Las macros no son interpretadas
    1134. 

  1134.   - Todo el texto en fuente no proporcional debe estar en una sóla línea del archivo fuente, no se admiten saltos de línea
    1135. 

  1135.   - En algunos archivos convertidos, los espacios internos son mantenidos, en otros, los espacios múltiples son reemplazados por espacios sencillos
    1136. 

  1136.   - Se puede crear un texto en negrita en fuente no proporcional insertándolo en las marcas de negrita : ``""**``negrita``**""``. Lo mismo para los otros dos modificadores, itálica y subrayado: ``""//``italica``//""`` y  ``""__``subrayado``__""``
    1137. 

  1137. 

  1138. 

  1139. ---------------------------------------------------------------------
    1140. 

  1140. 

  1141. == Línea Verbatim, Zona Verbatim ==[mark-verbatim]
    1142. 

  1142. 

  1143. - **Descripción: **Usado para insertar código-programa u otro texto pre-formateado en un párrafo, tabla, lista o cita, preservando los espacios, los saltos de línea y usando fuente no proporcional (monoespaciada)
    1144. 

  1144. - **Propiedades:**Multiline, !FreeSpaces, !Align, !Nesting
    1145. 

  1145. - **Contenido:** --
    1146. 

  1146. - **Sintaxis: Línea Verbatim:**
    1147. 

  1147.   - Una línea que comienza exactamente con 3 apóstrofes inversos, seguidos de un espacio y seguido de texto: ``""```"" como ésto``
    1148. 

  1148.   - Los apóstrofes inversos deben estar en la primera columna, sin espacios delante
    1149. 

  1149. - **Sintaxis: Zona Verbatim:**
    1150. 

  1150.   - Una línea que comienza exactamente con 3 apóstrofes inversos  ``````` seguidos de líneas de texto, seguidas de otra línea con exactamente 3 apóstrofes inversos ```````.
    1151. 

  1151.   - No está permitido ningun espacio antes y después de las marcas
    1152. 

  1152. - **Detalles:**
    1153. 

  1153.   - Las marcas no son interpretadas
    1154. 

  1154.   - Las macros no son interpretadas
    1155. 

  1155.   - Si se activa el fin del archivo (EOF), la zona verbatim acaba
    1156. 

  1156.     
    1157. 

    1158. 

    1159. 

  1159. ---------------------------------------------------------------------
    1160. 

    1161. 

  1161. == Línea de Separación , Línea Gruesa ==[mark-separator]
    1162. 

    1163. 

  1163. - **Descripción:** Identifica una línea de separación o una línea gruesa.
    1164. 

  1164. - **Propiedades:** !Multiline, FreeSpaces, !Align, !Nesting
    1165. 

  1165. - **Contenido:** --
    1166. 

  1166. - **Sintaxis:**
    1167. 

  1167.   - La línea de separación puede estar compuesta por guiones "-" o de carácteres de subrayado "_"
    1168. 

  1168.   - La línea gruesa está compuesta por signos igual "="
    1169. 

  1169.   - Deben usarse, al menos, 20 signos "-", "_"   o   "="
    1170. 

  1170.   - Tanto al principio como al final de la línea pueden colocarse espacios
    1171. 

  1171.   - Cualquier otro carácter colocado sobre la línea invalida la marca
    1172. 

  1172. - **Detalles:**
    1173. 

  1173.   - Si el archivo final no admite línea de separación, ésta es reemplazada por un comentario
    1174. 

  1174.   - La línea  gruesa puede tener distintos aspectos en ciertos tipos de archivos finales:
    1175. 

  1175.     - Una línea de separación más gruesa
    1176. 

  1176.     - Una pausa, en los formatos de presentación del tipo MagicPoint
    1177. 

  1177.     - Un salto de página, en formatos con paginación, del tipo LaTeX
    1178. 

    1179. 

    1180. 

  1180. ---------------------------------------------------------------------
    1181. 

    1182. 

  1182. == Enlaces, Enlaces nombrados ==[mark-link]
    1183. 

    1184. 

  1184. - **Descripción:** Identifica un enlace remoto (internet) o local
    1185. 

  1185. - **Propiedades:**!Multiline, !FreeSpaces, !Align, !Nesting
    1186. 

  1186. - **Contenido:** Macros, Raw, Imágenes
    1187. 

  1187. - **Sintaxis:**
    1188. 

  1188.   - Cualquier dirección internet válida ( URL, Ftp, news, e-mail) es detectada y convertida automaticamente
    1189. 

  1189.   - La indicación del protocolo ( http, https, ftp) es opcional : ``www.comoesto.net``
    1190. 

  1190.   - Puede utilizarse un nombre para un enlace: ``[clicar aqui www.url.net]``
    1191. 

  1191.   - Una imágen puede apuntar a un enlace: ``[imagen.jpg www.url.net]``
    1192. 

  1192.   - Pueden usarse macros en las direcciones de los enlaces: ``[ver source% %infile]``
    1193. 

  1193.   - Pueden utilizarse macros en los nombres de enlaces: ``[mirror de %%outfile www.debian.org]``
    1194. 

  1194. % - Beautifiers are allowed on the link name: ``[**click** here www.url.com]``
    1195. 

  1195.   - El enlace debe ser especificado en una sola línea, sin saltos de línea
    1196. 

  1196. - **Detalles:**
    1197. 

  1197.   - Si el archivo final no soporta enlaces, éstos serán subrayados.
    1198. 

    1199. 

    1200. 

  1200. ---------------------------------------------------------------------
    1201. 

    1202. 

  1202. == Cita ==[mark-quote]
    1203. 

    1204. 

  1204. - **Descripción:** Identifica una línea de cita (indentada).
    1205. 

  1205. - **Propiedades:**Multiline, !FreeSpaces, !Align, Nesting
    1206. 

  1206. - **Contenido:** Macros, Modificadores de Fuentes, Cita, Raw, Barras, Enlaces, Imágen, Comentarios
    1207. 

  1207. - **Sintaxis:**
    1208. 

  1208.   - Una línea que comienza por una tabulación (TAB)
    1209. 

  1209.   - A más TABs, mayor "profundidad"
    1210. 

  1210.   - No se permiten listas ni tablas
    1211. 

  1211. - **Detalles:**
    1212. 

  1212.   - Si el final del archivo fuente es activado (EOF) , se cierra la cita abierta
    1213. 

  1213.   - No hay límites en los niveles de cita, pero algunos tipos de archivos destino no soportan determinados niveles de cita. En estos casos, las sub-citas no soportadas son transformadas al nivel superior
    1214. 

    1215. 

    1216. 

  1216. ---------------------------------------------------------------------
    1217. 

    1218. 

  1218. == Listas, Listas Numeradas, Listas de Definición ==[mark-lists]
    1219. 

    1220. 

  1220. - **Descripción:** Identifica el comienzo de una lista de elementos
    1221. 

  1221. - **Propiedades:** Multiline, !FreeSpaces, !Align, Nesting
    1222. 

  1222. - **Contenido:**Macros, Modificadores de Fuentes, Listas, Tabla, Raw, Barras, Enlaces, Imágen, Comentario
    1223. 

  1223. - **Sintaxis:** 
    1224. 

  1224.   - Una línea que comienza por la siguiente secuencia:  guión "-" /dos puntos ":" / seguida de, exactamente, un espacio
    1225. 

  1225.   - El primer carácter de la lista no puede ser un espacio (excepción: listas de definición)
    1226. 

  1226.   - Espacios (no TAB) al principio de la línea definen la profundidad (niveles) de las sub-listas (anidamiento)
    1227. 

  1227.   - Las sub-listas se acaban con un elemento de menor profundidad o con un elemento vacio
    1228. 

  1228.   - Todas las listas abiertas se cierran con dos lineas en blanco consecutivas
    1229. 

  1229. - **Detalles:**
    1230. 

  1230.   - Si el final del archivo fuente es activado (EOF)  se cierran todas las listas abiertas
    1231. 

  1231.   - Las listas pueden ser mixtas, por ejemplo, una lista de definición en una lista numerada
    1232. 

  1232.   - Algunos tipos de archivos finales no admiten la imbricación de listas, los elementos de las sub-listas son transformados al nivel superior..
    1233. 

  1233.   - No hay restricción en la profundidad de las listas, pero ciertos tipos de archivos destino tienen restricciones al respecto. En estos casos, las sub-listas de nivel inferior son ascendidas
    1234. 

    1235. 

    1236. 

  1236. ---------------------------------------------------------------------
    1237. 

    1238. 

  1238. == Imágen ==[mark-image]
    1239. 

    1240. 

  1240. - **Descripción:**Identifica una imágen
    1241. 

  1241. - **Propiedades:** !Multiline, !FreeSpaces, Align, !Nesting
    1242. 

  1242. - **Contenido:**Macros
    1243. 

  1243. - **Sintaxis:**
    1244. 

  1244.   - Un archivo de imágen encerrado entre corchetes: ``[imagen.jpg]``
    1245. 

  1245.   - El archivo de imágen debe acabar con una extensión del tipo PNG, JPG, GIF,.....(en mayúsculas o minúsculas, indiferentemente)
    1246. 

  1246.   - Se admiten símbolos en el nombre del archivo de imágen:  ``[ imagen~!tres.jpg]``
    1247. 

  1247.   - Se admiten macros en el nombre del archivo de imágen:  ``[report-%%date(%Y-%m-%d).png]``
    1248. 

  1248.   - No se admiten espacios en el nombre del archivo de imágen:  ``[como esta.jpg]``
    1249. 

  1249.   - No se admiten espacios entre el corchete y el nombre del archivo de imágen:  ``[  likethis.jpg ]`` es incorrecto
    1250. 

  1250. - **Detalles:**
    1251. 

  1251.   - Si el archivo destino no admite imágenes, el nombre del archivo de la imágen se presenta entre (paréntesis)
    1252. 

  1252.   - La posición de las marcas indica el alineamiento de la imágen:
    1253. 

  1253.     - ``[IZQUIERDA.jpg]`` blablablabla
    1254. 

  1254.     - blablabla ``[CENTRO.jpg]`` blablabla
    1255. 

  1255.     - blablablabla ``[DERECHA.jpg]``
    1256. 

    1257. 

    1258. 

  1258. ---------------------------------------------------------------------
    1259. 

    1260. 

  1260. == Tabla ==[mark-table]
    1261. 

    1262. 

  1262. - **Descripción:** Delimita una fila de una tabla, de cualquier número de colunas.
    1263. 

  1263. - **Propiedades:** Multiline, FreeSpaces, Align, !Nesting
    1264. 

  1264. - **Contenido:** Macros, Modificadores de Fuentes, Raw, Enlaces, Comentario.
    1265. 

  1265. - **Sintaxis:**
    1266. 

  1266.   - Una línea vertical "|" identifica una fila de una tabla.
    1267. 

  1267.   - Dos líneas verticales "||" al principio de una línea identifica la fila de cabecera de una tabla
    1268. 

  1268.   - Los espacios delante de la primera línea vertical personalizan el centrado de la tabla
    1269. 

  1269.   - Los campos están separados por la cadena espacio/barra vertical/espacio " | "
    1270. 

  1270.   - Una barra vertical "|" al final de la primera fila de una tabla hace visibles los bordes 
    1271. 

  1271.   - La barra-vertical al final de otras filas de la tabla es ignorada (sólo tiene efectos "cosméticos)
    1272. 

  1272.   - Cerrando una celda con más de una barra vertical determina la expansión de columna (column span) : "||" para dos columnas, "|||" para tres columnas, etc....
    1273. 

  1273.   - Los espacios(no TAB) en el interior de las celdas determinan su alineamiento.
    1274. 

  1274.   - Ejemplo: ``| fila | de | tabla | con | seis | columnas |``
    1275. 

  1275. - **Detalles:**
    1276. 

  1276.   - Cada fila de tabla debe estar en una sóla línea del archivo fuente, sin saltos de línea
    1277. 

  1277.   - Los archivos destino con alineamiento por columnas (como sgml y LaTeX) usan el alineamiento de la primera fila como referencia para las demás.
    1278. 

  1278.   - Toda línea "no-tabla" cierra la tabla abierta, con excepción de las líneas de comentario
    1279. 

  1279.   - El número de celdas es flexible.Cada fila puede contener un número distinto de celdas
    1280. 

  1280.   - No hay un modo de especificar la anchura de las columnas.
    1281. 

  1281.   - Si el archivo destino no admite tablas, las filas de la tabla son consideradas como una zona verbatim
    1282. 

    1283. 

    1284. 

  1284. ---------------------------------------------------------------------
    1285. 

    1286. 

  1286. == Raw,Líneas y Zonas Raw (tal-cual) ==[mark-raw]
    1287. 

    1288. 

  1288. - **Descripción:**Utilizado para proteger texto del archivo fuente, de manera que las marcas y macros que contenga no sean tratados
    1289. 

  1289. - **Propiedades:**!Multiline, !FreeSpaces, !Align, !Nesting
    1290. 

  1290. - **Contenido:** --
    1291. 

  1291. - **Sintaxis:Raw:**
    1292. 

  1292.   - Dos dobles-comillas alrededor del texto: ``""""como ésto""""``
    1293. 

  1293.   - Sin espacios entre las marcas y el texto
    1294. 

  1294. - **Sintaxis:Línea Raw:**
    1295. 

  1295.   - Una línea que comieza con 3 dobles-comillas consecutivas:``""" línea``
    1296. 

  1296.   - La marca debe estar en la primera columna de la línea, sin espacios delante
    1297. 

  1297.   - Utilizar un espacio después de la marca para separar la del texto
    1298. 

  1298. - **Sintaxis:Zona Raw:**
    1299. 

  1299.   - Una línea que comieza con 3 dobles-comillas consecutivas, seguidas de la línea de texto, seguida de otras 3 dobles-comillas consecutivas.
    1300. 

  1300.   - Sin espacios antes o después de las marcas
    1301. 

  1301. - **Detalles:**
    1302. 

  1302.   - Las marcas no son interpretadas
    1303. 

  1303.   - Las macros no son interpretadas
    1304. 

  1304.   - Si el final del archivo fuente es activado (EOF) se cierra la zona raw abierta
    1305. 

    1306. 

    1307. 

  1307. =======================================================================
    1308. 

    1309. 

    1310. 

    1311. 

  1311. = Parte VI - Dominando las Macros =[macros]
    1312. 

    1313. 

  1313. Las macros son palabras-clave específicas que son utilizadas por el programa, en el momento de la conversión, para insertar informaciones dinŕmicas tales como la fecha e informaciones referentes al documento fuente o al documento final.
    1314. 

    1315. 

  1315. Una macro está constituida por los carácteres ``%%`` seguidos de su nombre, por ejemplo, ``%%date``. Algunas macros aceptan una cadena de formato entre paréntesis, justo después del nombre de la macro, como, por ejemplo:  ``%%date(%Y-%m-%d)``. Ésta cadena de formato incluye texto clásico junto con directivas, identificadas por ``%``, seguidas de un carácter de identificación. Si no se especifica ninguna cadena de formato, se utilizará el formato por defecto.
    1316. 

    1317. 

  1317.   || Nombre Macro   | Se transforma en...                        | Formato por defecto |
    1318. 

  1318.   | ""%%date""    | Fecha actual                     |  %Y%m%d 
    1319. 

  1319.   | ""%%mtime""   | Fecha de modificacion del archivo fuente    |  %Y%m%d 
    1320. 

  1320.   | ""%%infile""  | Path al archivo fuente                 |    %f 
    1321. 

  1321.   | ""%%outfile"" | Path al archivo final                 |    %f 
    1322. 

  1322.   | ""%%toc""     | Índice de contenidos del documanto (TOC) |    - 
    1323. 

    1324. 

  1324. Reglas generales:
    1325. 

    1326. 

  1326. - El nombre de la macros es insensible a la caja:  ``%%date``  y  ``%%DaTe`` son idénticas
    1327. 

  1327. - Las macros son válidas en las áreas del Encabezamiento y del Cuerpo del documento, excepto  ``%%toc``, que sólo es válida en el área del Cuerpo.
    1328. 

  1328. - Una macro que se encuentre en la zona de Configuración se ejecutará en la zona del Cuerpo.
    1329. 

  1329. - Una macro puede situarse en cualquier parte de una línea.
    1330. 

  1330. - Una línea puede contener varias macros. Excepción:  ``%%toc``, que debe estar sóla en la línea
    1331. 

  1331. - Una macro puede utilizarse en los enlaces y en las marcas de imágen (excepto ``%%toc``)
    1332. 

  1332. - Las macros no son procesadas en los títulos ni en las zonas Verbatim y Raw
    1333. 

    1334. 

    1335. 

  1335. Ejemplo (el texto en negrita ha sido generado por macros):
    1336. 

    1337. 

  1337. 	Esto es la guia del Usuario de Txt2tags,convertida a **%%outfile(%e)**
    1338. 

  1338. 	por txt2tags a partir del archivo fuente **%%infile** . La conversión se realizó en fecha
    1339. 

  1339. 	 **%%date(%Y-%m-%d %X)**, los últimos cambios en el documento fuente fueron realizados el
    1340. 

  1340. 	 **%%mtime(%Y-%m-%d %X)**. Tanto el archivo fuente como el final se encuentran en el directorio **%%infile(%D)**
    1341. 

    1342. 

  1342. -----------------------------------------------------------------------
    1343. 

    1344. 

  1344. == %%date ==[macro-date]
    1345. 

    1346. 

  1346. Llamada sin ninguna directiva especiál, ``%%date`` nos devuelve la fecha actual con el formato ISO yyyymmdd. Puede cambiarse el formato usando la sintaxis  ``%%date(formato)``
    1347. 

    1348. 

  1348. Esta macro acepta un amplio conjunto de directivas. Puede encontrarse un listado completo de estas directivas en
    1349. 

  1349. la web de [Phyton http://www.python.org/doc/current/lib/module-time.html].
    1350. 

  1350. Éstas son las directivas usadas com mayor frecuencia:
    1351. 

    1352. 

  1352.  || Directiva | Descripción |
    1353. 

  1353.   |  %a  | Nombre abreviado del día de la semana.
    1354. 

  1354.   |  %A  | Nombre completo del día de la semana.
    1355. 

  1355.   |  %b  | Nombre abreviado del més.
    1356. 

  1356.   |  %B  | Nombre completo del més.
    1357. 

  1357.   |  %c  | Representacion del día y hora, con formato apropiado.
    1358. 

  1358.   |  %d  | Día del més en formato decimal [01,31].
    1359. 

  1359.   |  %H  | Hora (modo 24-horas) en formato decimal [00,23].
    1360. 

  1360.   |  %I  | Hora (modo 12-horas) en formato decimal [01,12].
    1361. 

  1361.   |  %m  | Mes en formato decimal [01,12].
    1362. 

  1362.   |  %M  | Minutos en formato decimal [00,59].
    1363. 

  1363.   |  %p  | Equivalente locál tanto para AM como PM.
    1364. 

  1364.   |  %S  | Segundos en formato decimal[00,61].  (1)
    1365. 

  1365.   |  %x  | Representación apropiada de la fecha local.
    1366. 

  1366.   |  %X  | Representación apropiada de la hora local.
    1367. 

  1367.   |  %y  | Ańo, sin las cifras de la centuria, en formato decimal [00,99].
    1368. 

  1368.   |  %Y  | Ańo, con las cifras de la centuria, en formato decimal
    1369. 

  1369.   |  %%  | El carácter %
    1370. 

    1371. 

  1371. Ejemplos
    1372. 

    1373. 

  1373.  || Macro                          |  -->  | Resultados convertidos en %%date(%Y, %b %d at %H:%M) |
    1374. 

  1374.   | ""%%date(Convertido en: %c)""    |  -->  | %%date(Convertido en: %c)
    1375. 

  1375.   | ""%%date(%Y-%m-%d)""            |  -->  | %%date(%Y-%m-%d)
    1376. 

  1376.   | ""%%date(%I:%M %p)""            |  -->  | %%date(%I:%M %p)
    1377. 

  1377.   | ""%%date(Hoy es %A, on %B.)"" |  -->  | %%date(Hoy es %A, on %B.)
    1378. 

    1379. 

  1379. -----------------------------------------------------------------------
    1380. 

    1381. 

  1381. == %%mtime ==[macro-mtime]
    1382. 

    1383. 

  1383. Esta macro nos devuelve la fecha de la última modificación del archivo fuente. Acepta las mismas directivas de formato que [""%%date"" macro #macro-date].
    1384. 

    1385. 

  1385. Ejemplo:
    1386. 

  1386.  
    1387. 

  1387.  Esta Guía del Usuario fué editada por última vez el
    1388. 

  1388. **%%mtime(%c)**. Esta fecha ha sido generada por ``%%mtime(%c)``.
    1389. 

    1390. 

  1390. -----------------------------------------------------------------------
    1391. 

    1392. 

  1392. == %%infile ==[macro-infile]
    1393. 

    1394. 

  1394. Nos devuelve el camino (PATH) al archivo fuente en el sistema. Es útil para hacer cosas como "mira la fuente de este archivo" en enlaces de páginas HTML. Dar esta información es un detalle amable hacia los debutantes, que podrŕn utilizar vuestra fuente como ejemplo para sus propias páginas. 
    1395. 

    1396. 

  1396. Esta macro acepta las siguientes directivas de formato:
    1397. 

    1398. 

  1398.  || %<char> | Descripción | output generado para esta Guia del Usuario |
    1399. 

  1399.  |    %f    | Nombre del archivo                     | %%infile(%f)
    1400. 

  1400.  |    %F    | Nombre del archivo (sin extension) | %%infile(%F)
    1401. 

  1401.  |    %e    | Extensión del archivo                | %%infile(%e)
    1402. 

  1402.  |    %p    | Path absoluto al archivo            | %%infile(%p)
    1403. 

  1403.  |    %d    | Path al archivo (sólo directorios)  | %%infile(%d)
    1404. 

  1404.  |    %D    | Path al archivo (sólo directorio padre)   | %%infile(%D)
    1405. 

  1405.  |    %%    | Carácter %          | %%infile(%%)
    1406. 

    1407. 

  1407. Ejemplos:
    1408. 

    1409. 

  1409.  || Fuente                                      |  -->  | Resultado  |
    1410. 

  1410.  | El directorio padre de esta guia es ""%%infile(%D)"".    |  -->  | El directorio padre de ésta Guía es %%infile(%D). |
    1411. 

  1411.  | Usa la extensión ""%%infile(%e)"" . |  -->  | Usa la extensión %%infile(%e). |
    1412. 

  1412.  | ""[Consulta la fuente %%infile]""                 |  -->  | [Consulta la fuente %%infile]
    1413. 

  1413.  | Convertido a XHTML, Se llamará ""%%infile(%F)"".xhtml |  -->  | Convertid a XHTML, se llamará %%infile(%F).xhtml
    1414. 

    1415. 

  1415. Nota: La macro nos devuelve "-" si el archivo fuente es STDIN.
    1416. 

    1417. 

  1417. -----------------------------------------------------------------------
    1418. 

    1419. 

  1419. == %%outfile ==[macro-outfile]
    1420. 

    1421. 

  1421. Nos devuelve el camino (PATH) al archivo convertido, en el sistema. Es práctico colocado en las áreas de Encabezamiento y el Cuerpo del archivo.
    1422. 

  1422. Acepta las mismas directivas que la macro [ ""%%infile""  #macro-infile] 
    1423. 

    1424. 

  1424. Ejemplos:
    1425. 

    1426. 

  1426.  || Fuente                                    |  -->  | Resultado  |
    1427. 

  1427.  | Estás leyendo el archivo ""%%outfile"" .    |  -->  | Estás leyendo el archivo %%outfile .
    1428. 

  1428.  | txt2tags -t ""%%outfile(%e)"" -i ""%%infile"" -o ""%%outfile"" |  -->  | txt2tags -t %%outfile(%e) -i %%infile -o %%outfile
    1429. 

    1430. 

  1430. Nota: La macro nos devuelve "-" si el archivo fuente es STDOUT
    1431. 

    1432. 

  1432. -----------------------------------------------------------------------
    1433. 

    1434. 

  1434. == %%toc ==[macro-toc]
    1435. 

    1436. 

  1436. Esta macro nos devuelve el índice de materias del documento. Es útil para indicarnos donde lo queremos insertar.
    1437. 

  1437. Puedes utilizar esta macro más de una vez para, por ejemplo, insertar el índice de materias al inicio y al final del documento . Esta Guia esta utilizando ``%%toc`` para insertar el ěndice de materias 
    1438. 

    1439. 

  1439. A diferencia de otras macros, no acepta directivas de formato y se rige por unas reglas especiales:
    1440. 

    1441. 

  1441. - Sólo es válida si se coloca en el **Area del Cuerpo** del documento
    1442. 

  1442. - Debe encontrarse sóla en la línea ( se permiten espacios antes y después de la macros)
    1443. 

  1443. - Debe utilizarse con la opción en línea de comandos --toc, si no, será ignorada.
    1444. 

  1444. - El posicionamiento y el formato por defecto del Ěndice de materias, se ignorarán cuando se encuentre una macro  ``%%toc``.
    1445. 

    1446. 

    1447. 

  1447. =======================================================================
    1448. 

    1449. 

    1450. 

    1451. 

  1451. = Parte VII - Dominando las Directivas de  Configuración =[settings]
    1452. 

    1453. 

  1453. Las Directivas de Configuración son directivas especiales, localizadas en en **Area de Configuración** del documento fuente, que afectan al comprotamiento de la conversión.
    1454. 

  1454.  
    1455. 

  1455. Las Directivas de Configuración son todas  opcionales. Cualquier usuario medio puede generar documentos txt2tags sin siquiera conocer la existencia de dicha Directivas, pero, como ya se ha dicho anteriormente, el usuario que las haya "experimentado" dificilmente podrá prescindir de las ventajas y el control que le proporcionan.
    1456. 

    1457. 

  1457. Las Directivas de Configuración se escriben como //líneas de comentario especiales//, precedidas de la marca  ("!") que las diferencia de los comentarios clásicos. 
    1458. 

  1458. La sintaxis es tan simple como la de la asingación de un valor a una variable:
    1459. 

    1460. 

  1460.  || %! palabra-clave : valor |
    1461. 

    1462. 

  1462. Detalles de la sintaxis:
    1463. 

    1464. 

  1464. - No debe haber espacio entre el carácter de comentario y el signo de exclamación ("%!")
    1465. 

    1466. 

  1466. - Los espacios entre la clave y el separador (":") son opcionales
    1467. 

    1468. 

  1468. - La clave y el valor son insensibles a la caja ( no distinguen entre mayúsculas 	y minúsculas)
    1469. 

    1470. 

    1471. 

  1471. Reglas:
    1472. 

    1473. 

  1473. - Sólo son válidas en el **Area de Configuracón**. Si se emplazan en otra área del documento serán tratadas como comenterios
    1474. 

    1475. 

  1475. - Si la misma directiva aparece varias veces en el **Area de Configuración**, sólo se tomará en consideración la última. Excepción: options, preproc  y postproc, que son acumulativas
    1476. 

    1477. 

  1477. - Una directiva con una clave no válida será considerada un comentario
    1478. 

  1478.   
    1479. 

    1480. 

  1480. - Las directivas tienen prioridad sobre el archivo RC pero no sobre las opciones en línea de comandos
    1481. 

    1482. 

    1483. 

  1483. -----------------------------------------------------------------------
    1484. 

    1485. 

  1485. == %!Target ==[setting-target]
    1486. 

    1487. 

  1487. Usando la configuración target se define un formato para el documento destino:
    1488. 

    1489. 

  1489. ``` %!target: html
    1490. 

  1490. 

  1491. Asi, al usuario le bastará con ordenar
    1492. 

  1492. 

  1493. ``` $ txt2tags file.t2t
    1494. 

    1495. 

  1495. Y la conversión se realizará al formato especificado en target
    1496. 

    1497. 

  1497. Target no permite una especificación opcional de destino. Asi, no tendra sentido: ``%!target(tex): html``.
    1498. 

    1499. 

  1499. -----------------------------------------------------------------------
    1500. 

    1501. 

  1501. == %!Options ==[setting-options]
    1502. 

    1503. 

  1503. Tener que escribir largas líneas de comando cada vez que sea necesario convertir un documento, además de cansado puede ser fuente de numerosos errores. La configuración ``%!options`` permite que el usuario guarde, en el propio documento origen, todas las opciones de configuración que necesitará. Esto es garantia, además, de que el documento será siempre convertido de la misma forma, con las mismas opciones.
    1504. 

    1505. 

  1505. Las opciones deben escribirse como se haria en la línea de comandos, sin errores sintacticos. Pero no debe incluirse la llamada al programa "txt2tags" ni el nombre del archivo origen al final de la línea. 
    1506. 

  1506. Si en línea de comandos se utiliza la siguiente orden:
    1507. 

    1508. 

  1508. ``` $ txt2tags -t html --toc --toc-level 2 --enum-title file.t2t
    1509. 

  1509. 

  1510. En la configuración ``%!options`` deberá escribirse:
    1511. 

  1511. 

  1512. ```
    1513. 

  1513. %!target: html
    1514. 

  1514. %!options(html): --toc --toc-level 2 --enum-title
    1515. 

  1515. ```
    1516. 

  1516. 

  1517. La línea de comandos, para la conversión del documento que incluya la configuración  ``%!options``, pasa a ser "txt2tags file.t2t", y la conversión puede ser ejecutada dentro nuestro editor de texto preferido mientras el contenido está siendo editado. En Vi, el comando es:
    1518. 

  1518. 

  1519. ``` :!txt2tags %
    1520. 

    1521. 

  1521. -----------------------------------------------------------------------
    1522. 

    1523. 

  1523. == %!Encoding ==[setting-encoding]
    1524. 

    1525. 

  1525. La configuración de ``%!encoding``  es casi imprescindible para aquellos autores que escriben en idiomas que contemplan letras acentuadas y otros detalles específicos, de forma que el Conjunto de Caracteres del documento final pueda ser personalizado.
    1526. 

  1526. Los valores válidos para la configuración de ``%!encoding`` son los mismos que para documentos HTML, (iso-8859-1, UTF-8, koi8-r, etc. ).
    1527. 

  1527. En la siguiente dirección pude consultarse la lista de [códigos  http://www.iana.org/assignments/character-sets]
    1528. 

    1529. 

  1529. El documento final LaTex utiliza alias para la codificación . Esto no representa ningún problema para el usuario,ya que txt2tags los traduce intennamente. 
    1530. 

  1530. Algunos ejemplos de esta traducción son los que a continuación se relacionan:
    1531. 

    1532. 

  1532.       || txt2tags/HTML   |  >  | LaTeX  |
    1533. 

  1533.        | windows-1250    | >>> | cp1250 |
    1534. 

  1534.        | windows-1252    | >>> | cp1252 |
    1535. 

  1535.        | ibm850          | >>> | cp850  |
    1536. 

  1536.        | ibm852          | >>> | cp852  |
    1537. 

  1537.        | iso-8859-1      | >>> | latin1 |
    1538. 

  1538.        | iso-8859-2      | >>> | latin2 |
    1539. 

  1539.        | koi8-r          | >>> | koi8-r |
    1540. 

    1541. 

    1542. 

  1542. Si el valor es no es reconocido por txt2tags, será pasado sin codificar, permitiendo al usuario especificar codificaciones personalizadas.
    1543. 

    1544. 

  1544. -----------------------------------------------------------------------
    1545. 

    1546. 

  1546. == %!PreProc ==[setting-preproc]
    1547. 

    1548. 

  1548. Es un filtro con la función "busca y cambia", que es aplicada en el documento original, después de que la línea haya sido leída y antes de cualquier tratamiento por txt2tags.
    1549. 

    1550. 

  1550. Es útil para definir algunas abreviaciones para texto que sea de uso frecuente, como:
    1551. 

    1552. 

  1552. ```
    1553. 

  1553. %!preproc JJS          "John J. Smith"
    1554. 

  1554. %!preproc RELEASE_DATE "2003-05-01"
    1555. 

  1555. %!preproc BULLET       "[images/tiny/bullet_blue.png]"
    1556. 

  1556. ```
    1557. 

    1558. 

  1558. Si el usuario escribe una línea como ésta :
    1559. 

    1560. 

  1560. ``` ĄHola! Me llamo Antoni. Hoy es RELEASE_DATE.
    1561. 

  1561. 

  1562. txt2tags la presentará como :
    1563. 

  1563. 

  1564. ``` ĄHola! Me llamo Antoni. Hoy es 2003-05-01.
    1565. 

    1566. 

  1566. Este filtro es un componente que trabaja entre el autor del documento y la conversión de txt2tags. Es una espécie de "primera conversión" antes de la conversión definitiva. Este componente funciona exactamente como un filtro Sed/Perl externo, que se invocan de la siguiente forma:
    1567. 

    1568. 

  1568. ``` $ cat ARCHIVO.t2t | preproc-script.sh | txt2tags -
    1569. 

  1569. 

  1570. El tratamiento ejecutado por txt2tags comenzará una vez todas las sustituciones PreProc hayan sido realizadas.
    1571. 

  1571. 

  1572. -----------------------------------------------------------------------
    1573. 

  1573. 

  1574. == %!PostProc ==[setting-postproc]
    1575. 

  1575. 

  1576. Es un filtro con la funcion "busca y sustituye", que es aplicada al archivo resultante, una vez realizadas todas las conversiones por txt2tags.
    1577. 

  1577. 

  1578. Es útil para definir algunos refinamientos en el documento generado, cambiar  algunas marcas, ańadir texto extra, etc. Algunos breves ejemplos:
    1579. 

  1579. 

  1580. ```
    1581. 

  1581. %!postproc(html): '<BODY.*?>' '<BODY BGCOLOR="green">'
    1582. 

  1582. %!postproc(tex) : "\\newpage" ""
    1583. 

  1583. ```
    1584. 

  1584. 

  1585. Estos filtros cambian el color de fondo de la pagina HTML y eliminan los saltos de página en archivos LaTex generados.
    1586. 

  1586. 

  1587. Las reglas de PostProc son las mismas que las de los filtros externos Sed/Perl, que se invocan de la siguiente forma:
    1588. 

  1588. 

  1589. ``` $ txt2tags -t html -o- file.t2t | postproc-script.sh > file.html
    1590. 

    1591. 

  1591. Antes de que apareciera esta funcionalidad, era bastante común tener pequeńos scripts para "ajustar" los resultados generados por txt2tags. Dichos scripts eran, de hecho, varios comandos sed ( o simlares), para hacer algo parecido a "sustituye esto por aquello". Actualmente las órdenes para  estas sustituciones  pueden ser guardadas junto con el texto del documento, y también aprovechase de la poderosa maquina de Expresiones regulares de Python.
    1592. 

    1593. 

  1593. -----------------------------------------------------------------------
    1594. 

    1595. 

  1595. == %!Style ==[setting-style]
    1596. 

    1597. 

  1597. - Esta opción es útil en la generacion de archivos HTML y XHTML, definiendo el nombre del archivo CSS que sera usado por el documento generado.
    1598. 

    1599. 

  1599. - En el formato LaTex, esa opción se usa para cargar modulos ``/usepackage``.
    1600. 

    1601. 

  1601. - El mismo resultado se obtiene con la opción en línea de comandos --style
    1602. 

    1603. 

  1603. - La opcion --style en línea de comandos tiene preferencia sobre la configuración de  ``%!style``.
    1604. 

    1605. 

    1606. 

  1606. -----------------------------------------------------------------------
    1607. 

    1608. 

  1608. == Definiendo una Configuración para un Tipo de Archivo Destino Específico ==[setting-specific]
    1609. 

    1610. 

    1611. 

    1612. 

  1612. Desde la versión 1.6 de txt2tags, todas las Directivas de Configuración, excepto ``%!target``, pueden ser especificadas para un tipo de archivo destino especifico, usando la sintaxis : ``%!clave(destino):valor``. De esta forma, el usuario puede definir diferentes configuraciones para diferentes tipos de archivos generados.
    1613. 

    1614. 

    1615. 

  1615. Éste es un aspecto especialmente útil en los filtros pre/postproc, aunque puede ser utilizado en todas las directrices. Por ejemplo, configurar diferentes estilos para HTML y LaTeX:
    1616. 

    1617. 

  1617. ```
    1618. 

  1618. %!style(html): fancy.css
    1619. 

  1619. %!style(tex) : amssymb
    1620. 

  1620. ```
    1621. 

    1622. 

  1622. Para ajustar las opciones en el documento convertido, algo como ésto puede ser útil:
    1623. 

    1624. 

  1624. ```
    1625. 

  1625. %!target: sgml
    1626. 

  1626. %!options(sgml): --toc
    1627. 

  1627. %!options(html): --style foo.css
    1628. 

  1628. %!options(txt ): --toc-only --toc-level 2
    1629. 

  1629. ```
    1630. 

    1631. 

  1631. De esta forma, el tipo de destino patrón es SGML y generará un índice de materias (TOC). 
    1632. 

  1632. Si el usuario ejecuta:
    1633. 

    1634. 

    1635. 

  1635.  ``$ txt2tags -t html file.t2t``
    1636. 

  1636.  
    1637. 

  1637.  
    1638. 

  1638.  El tipo de destino será HTML y solamente serán usadas las opciones de  ``%!options(html)`` . De esta forma se utilizará la opcion --style y en el archivo HTML no se generará un índice de materias.
    1639. 

    1640. 

  1640. -----------------------------------------------------------------------
    1641. 

    1642. 

  1642. == Detalles de los filtros PreProc y PostProc ==[filters-details]
    1643. 

    1644. 

  1644. - Los filtros contienen una función de "buscar y sustituir".
    1645. 

  1645. - No son del tipo "utiliza la última encontrada", ya que son acumulativos. Podemos definir tantos filtros como deseemos. Serán aplicados todos, en el orden en que hayan sido definidos.
    1646. 

  1646. - Para los filtros, el orden de definición marca su aplicación y seran aplicadas tanto las reglas genéricas como las específicas al tipo-destino.  En el siguente ejemplo, ambos filtros son aplicados en el documento HTML final:
    1647. 

  1647. ```
    1648. 

  1648. %!postproc      :   this   that
    1649. 

  1649. %!postproc(html):   that   other
    1650. 

  1650. ```
    1651. 

    1652. 

  1652. - Los filtros deben recibir exactamente dos argumentos.
    1653. 

    1654. 

  1654. - Escapes especiales como ``\n`` y ``\t`` también son interpretados.
    1655. 

    1656. 

  1656. - Para eliminar texto, sustitúyelo por una cadena vacía
    1657. 

    1658. 

    1659. 

  1659. ``` %!postproc: "texto no deseado" ""
    1660. 

  1660. 

  1661. - Para evitar problemas, procura siempre indicar explicitamente el destino al que se aplicará el filtro cuando se esté usando
    1662. 

  1662.   PostProc para cambiar marcas: ``%!PostProc(destino): <esto> <aquello>``
    1663. 

  1663. 

  1664. - PreProc es aplicado después de que una línea haya sido leída. PostProc es aplicado después de que todo el tratamiento se haya realizado. Funcionan exactamente como en:
    1665. 

  1665. ``` $ cat file.t2t | preproc.sh | txt2tags | postproc.sh
    1666. 

    1667. 

  1667. - La primera parte de un filtro ( la cadena "busca"), no es leída como una cadena sino como una expresión regular. Si no sabes lo que es ésto, no te preocupes, casi seguro que nunca trendrás necesidad de ello. Pero recuerda que  que debes "escapar" los carácteres para el usuario. "Escapar"significa preceder el carácter con el signo "\". Cómo en la siguiente lista:
    1668. 

  1668. ``` \*  \+  \.  \^  \$  \?  \(  \)  \{  \[  \|  \\
    1669. 

  1669. 

  1670. - Las Expresiones Regulares de Python pueden ser utilizadas. Son similares a las Regex de Perl. Por ejemplo: cambia todas las marcas "B" para "STRONG" en HTML:
    1671. 

  1671. ``` %!postproc(html):   '(</?)B>'   '\1STRONG>'
    1672. 

    1673. 

  1673. - Los argumentos de los filtros pueden ser pasados de tres formas:
    1674. 

  1674.     + Una palabra simple, sin apóstrofes ni comillas, como FOO (sin espacios)
    1675. 

  1675.     + Una cadena con dobles comillas, como en "FOO"
    1676. 

  1676.     + Una cadena ,con comillas o apóstrofes,como en 'FOO'
    1677. 

    1678. 

  1678. - Si la expresión origen tiene apóstrofes, protéjelos con comillas y vice-versa. Algunos ejemplos:
    1679. 

  1679. ```
    1680. 

  1680. %!postproc:   ORIGEN    CAMBIO
    1681. 

  1681. %!postproc:  "ORIGEN"  "CAMBIO"
    1682. 

  1682. %!postproc:  'ORIGEN'  'CAMBIO'  
    1683. 

  1683. %!postproc:   ORIGEN   "CAMBIO"
    1684. 

  1684. %!postproc:  "ORIGEN"  'CAMBIO' 
    1685. 

  1685. ```
    1686. 

    1687. 

    1688. 

  1688. =======================================================================
    1689. 

    1690. 

    1691. 

    1692. 

  1692. = Parte VIII - Mágia Negra =[black-magic]
    1693. 

    1694. 

  1694. Este no es un capítulo recomendado para novatos. Aquí se va a mostrar como hacer cosas "extrańas" con los filtros de txt2tags, "abusando" de patrones complejos y de Expresiones Regulares.
    1695. 

    1696. 

  1696. 	**ĄAtencion!** Los procedimientos detallados a continuación pueden acarrear dańos. Algún texto puede perderse en el procedimiento de conversión, no apareciendo en el documento generado. Usa estos procedimientos sólo si precisas verdaderamentede ellos y/o si sabes exactamente lo que estas haciendo
    1697. 

    1698. 

  1698.  || Los filtros son un procedimiento poderoso, pero pueden ser peligrosos |
    1699. 

    1700. 

  1700.  || Los filtros mal usados generan resultados inesperados |
    1701. 

    1702. 

    1703. 

    1704. 

  1704. -----------------------------------------------------------------------
    1705. 

    1706. 

  1706. == Insertando Múltiples Líneas con  %!PostProc (como reglas CSS) ==[postproc-multiline]
    1707. 

    1708. 

  1708. En los filtros, el patrón de sustitución puede incluir múltiples líneas utilizando el carácter de salto de línea ``\n``
    1709. 

    1710. 

  1710. Esta funcionalidad puede ser útil para incluir reglas CSS en un archivo HTML generado, sin necesidad de crear un archivo separado. Este es el caso de esta Guia del Usuario, que utiliza los siguientes filtros:
    1711. 

    1712. 

  1712. ```
    1713. 

  1713. %!postproc: <HEAD>      '<HEAD>\n<STYLE TYPE="text/css">\n</STYLE>'
    1714. 

  1714. %!postproc: (</STYLE>)  'body     { margin:3em               ;} \n\1'
    1715. 

  1715. %!postproc: (</STYLE>)  'a        { text-decoration:none     ;} \n\1'
    1716. 

  1716. %!postproc: (</STYLE>)  'pre,code { background-color:#ffffcc ;} \n\1'
    1717. 

  1717. %!postproc: (</STYLE>)  'th       { background-color:yellow  ;} \n\1'
    1718. 

  1718. ```
    1719. 

    1720. 

  1720. Todos los filtros están subordinados al primero, para reemplazar una cadena que ha insertado. De esta forma, un simple "<HEAD>" se transforma en:
    1721. 

    1722. 

  1722. ```
    1723. 

  1723. <HEAD>
    1724. 

  1724. <STYLE TYPE="text/css">
    1725. 

  1725. body     { margin:3em               ;}
    1726. 

  1726. a        { text-decoration:none     ;}
    1727. 

  1727. pre,code { background-color:#ffffcc ;}
    1728. 

  1728. th       { background-color:yellow  ;}
    1729. 

  1729. </STYLE>
    1730. 

  1730. ```
    1731. 

    1732. 

  1732. -----------------------------------------------------------------------
    1733. 

    1734. 

  1734. == Creando Contenido  "Específico al Tipo Destino" con  %!PreProc ==[target-specific-contents]
    1735. 

    1736. 

  1736. Algunas veces es necesario insertar algún texto solo para un tipo de destino específico y no para otros. Este tipo de comportamiento "extrańo" puede ser llevado a cabo con PreProc.
    1737. 

    1738. 

  1738. La idea es insertar este texto extra en el archivo original como comentario, pero marcarlo de forma que un filtro especifíco para aquel tipo de destino lo "descomente" 
    1739. 

    1740. 

  1740. Por ejemplo, si debe insertarse un párrafo extra solamente en el tipo de destino HTML, coloca el texto en un comentario especial como este:
    1741. 

    1742. 

  1742. ```
    1743. 

  1743. %html% Esta página HTML fué generada por [txt2tags http://txt2tags.org].
    1744. 

  1744. %html% Vea el archivo fuente TXT [aqui source.t2t].
    1745. 

  1745. ```
    1746. 

    1747. 

  1747. Como todas las líneas comienzan con ``%``, son líneas de comentario y serán ignoradas.
    1748. 

  1748. Pero si ańadimos este filtro especial:
    1749. 

    1750. 

  1750. ``` %preproc(html): '^%html% ' ''
    1751. 

  1751. 

  1752. El signo ``%`` inicial es eliminado, "activando" las líneas que lo contenian, que dejarán de ser comentarios para pasar a integrar el texto del documento final. Como hemos configurado un destino específico, HTML, el filtro sólo se aplicará a él.
    1753. 

  1753. 

  1754. -----------------------------------------------------------------------
    1755. 

  1755. 

  1756. == Cambiando Marcas txt2tags con  %!PreProc ==[creating-marks]
    1757. 

  1757. 

  1758. Si el usuario es un gurú de Expresiones Regulares, podria personalizar la sintaxis del documento, cambiando las marcas txt2tags patrón por algo que le fuere mas confortable.
    1759. 

  1759. 

  1760. Por ejemplo, una TAB es una marca de cita. Si al usuario no le gusta eso, puede definir una nueva marca para el "texto citado". Consideremos que escoja colocar ">>>" . Precisará de este filtro simple:
    1761. 

  1761. 

  1762. ``` %!PreProc: '>>> ' '\t'
    1763. 

    1764. 

  1764. Y en el documento original, el "texto citado"  aparecera como:
    1765. 

    1766. 

  1766. ```
    1767. 

  1767. >>> Este es un texto citado
    1768. 

  1768. >>> El usuario definio esta marca exquisita
    1769. 

  1769. >>> Pero seran convertidas a TABs por PreProc
    1770. 

  1770. ```
    1771. 

    1772. 

  1772. Antes que el analisis del programa comience, las ">>>" seran transformadas en TABs y txt2tags reconocera la marca de cita.
    1773. 

    1774. 

  1774. 	**ĄAtencion!** Las Reglas PreProc extremas pueden ,eventualmente, cambiar toda la sintaxis de marcado y asi mismo, generar conflictos entre marcas. Ten mucho cuidado en la utilizacion de estas reglas.
    1775. 

    1776. 

  1776. =======================================================================
    1777. 

    1778. 

    1779. 

    1780. 

  1780. = Parte IX - História de Txt2tags =[history]
    1781. 

    1782. 

  1782. En júlio de 2001 se lanzó al público la primera versión de txt2tags (v0.1). Pero sus orígenes se remontan a más de un ańo antes de aquel día. 
    1783. 

    1784. 

  1784. Este capítulo ilustra, en pocas palabras, el desarrollo de esta herramienta, desde que la primera línea fué escrita hasta la actual versión. 
    1785. 

    1786. 

  1786. == Enero de1999: Pre-História ==[history-1999-1]
    1787. 

    1788. 

    1789. 

    1790. 

  1790. 	"Mi primera tentativa de hacer una herramienta de conversión comenzó en 1999, como un simple script
    1791. 

  1791. 	 Bourne Shell que convertía texto con marcas en una página HTML. Cómo otra herramienta txt2html. 
    1792. 

  1792. 	Todo el mundo debe haber hecho ya una de estas herramientas......En resumen, reconocia marcas simples, como ``*bold*``, 
    1793. 

  1793. 	``/italic/``, ``_subrayado_``, y escapaba los carácteres especiales ``< & >`` de HTML. Nada impresionante, pero era joven;)"
    1794. 

  1794. 	
    1795. 

    1796. 

    1797. 

  1797. == Júnio de 1999: Todavía Pre-História ==[history-1999-2]
    1798. 

    1799. 

  1799. % scripts/antigos/txt2sgml-bash/txt2sgml  25/06/1999
    1800. 

    1801. 

    1802. 

    1803. 

  1803. 	 "Pasaron algunos meses, y un gran "hype" entorno a Sgml llegó a la compańia en la que 
    1804. 

  1804. 	 estaba trabajando (Conectiva). Txt2tags se transformó en un script txt2sgml. Estaba realmente tentado a aprender
    1805. 

  1805. 	 sobre SED* en aquel tiempo, de forma que txt2tags en aquella época era un script Bourne Shell con mucho código SED"
    1806. 

  1806. 	
    1807. 

  1807. 	
    1808. 

  1808. 	* **SED:** UNIX Stream EDitor - una herramienta de edición automática de textos
    1809. 

    1810. 

  1810. Esta versión mejorada, con soporte Sgml, ofrecía soporte a más estructuras como listas y texto preformateado.
    1811. 

  1811. En el siguiente archivo ejemplo, pueden verse los orígenes delas marcas txt2tags:
    1812. 

    1813. 

  1813. ```
    1814. 

  1814. * Esta es una línea en negrita (żNEGRITA orientada a línea? bien...)
    1815. 

  1815. 

  1816.   --
    1817. 

  1817. - lista no numerada muy semejante a lista de txt2tags
    1818. 

  1818. - pero con éstos -- para iniciar y terminar la lista 
    1819. 

  1819.   --
    1820. 

  1820. 

  1821. =----------------------
    1822. 

  1822. El texto preformateado era delimitado por el patrón =-- .
    1823. 

  1823. Los otros ------- eran cosméticos.
    1824. 

  1824. =----------------------
    1825. 

  1825. ```
    1826. 

    1827. 

  1827. Nada impresionante todavia, pero el gran paso esta al caer...
    1828. 

    1829. 

  1829. == Agosto de 2000: No más Pre-História ==[history-2000]
    1830. 

    1831. 

  1831. % verde666.org/sed/programas/txt2*/txt2sgml.sed  20000816 - 20010514
    1832. 

    1833. 

    1834. 

    1835. 

  1835. 	"Pasó un ańo y, durante este tiempo, estuve realmente encantado con SED.
    1836. 

  1836. 	El escript de shell txt2sgml.sh fué reescrito convirtiéndose en  
    1837. 

  1837. 	a 350 líneas de puro script SED. Fueron ańadidas algunas funcionalidades como subsecciones,
    1838. 

  1838. 	reconocimiento de URL y sublistas. Durante al menos un ańo, usé y probé muchísimo dicho script
    1839. 

  1839. 	
    1840. 

    1841. 

  1841. Un sencillo ejemplo de archivo txt2sgml.sed :
    1842. 

  1842. ```
    1843. 

  1843. * Hey, here are the first 3 magic lines
    1844. 

  1844. * The document title / author / date
    1845. 

  1845. * But they required those asterisks at the beginning
    1846. 

  1846. 

  1847. MAIN TITLE
    1848. 

  1848. 

  1849. Titles were made by uppercase-only lines. Subtitles were identified by
    1850. 

  1850. leading spaces. Each space denoted a new sublevel. The beautifiers:
    1851. 

  1851. *bold*, **strong**, "italic" and `typewriter`.
    1852. 

  1852. 

  1853. - lists
    1854. 

  1854.   + sublists
    1855. 

  1855.     = and subsublists (by identifier, not indentation)
    1856. 

  1856. 

  1857. 

  1858. Two blank lines to close lists. Links as www.example.com and e-mails
    1859. 

  1859. were recognized automagically by regular expressions. And there was a
    1860. 

  1860. strange image mark:
    1861. 

  1861. %%image: path/to/image.jpg
    1862. 

  1862. ```
    1863. 

    1864. 

  1864. == Mayo 2001: Pythonización e Idea Multi Formato de Destino ==[history-2001-1]
    1865. 

    1866. 

    1867. 

    1868. 

  1868. 	"Habia comenzado a escribir mi libro,
    1869. 

  1869. 	[ Expresiones Regulares http://guia-er.sf.net]
    1870. 

  1870. 	y usado el formato de marcado txt2sgml.sed.
    1871. 

  1871. 	De esta forma pude convertirlo a sgml (luego a HTML utilizando una herramienta sgml2html)
    1872. 

  1872. 	y chequear rapidamente en el navegador cómo habia quedado el libro.
    1873. 

  1873. 	Pero cómo "rápido" y "sgml2html" no casan,
    1874. 

  1874. 	modifiqué el script SED de txt2html.sed
    1875. 

  1875. 	generando directamente HTML. [...].
    1876. 

  1876. 	Mi editor usaba Adobe PageMaker para el formateo de libros, lo que era un problema para un chico linux como yo.
    1877. 

  1877. 	Pero me alegré cuando me enteré que PageMaker utilizaba un sistema de marcas semejante al de HTML,
    1878. 

  1878. 	entonces, comencé a cambiar mi script en una herramienta txt2pagemaker.sed.
    1879. 

  1879. 	Habia acabado por tener tres scrips SED similares, convirtiendo mis textos a sgml, HTML y PageMaker.
    1880. 

  1880. 	Se crearon algunos scripts más para extraer el índice de contenidos (TOC) del libro y para realizar post-formateos.  
    1881. 

  1881. 	A mitad redacción del libro, tuve la idea de unirlos en una sóla herramienta y elegir Python como lenguaje. Nació TXT2TAGS"
    1882. 

  1882. 	
    1883. 

  1883. 	
    1884. 

    1885. 

  1885. == Júlio de 2001: séries 0.x: Debut de txt2tags (Lanzamiento Mundial) ==[history-2001-2]
    1886. 

    1887. 

  1887. % v0.1 26 Jul 2001
    1888. 

    1889. 

    1890. 

    1891. 

  1891. 	"El lanzamiento del libro impreso (31 de júlio)
    1892. 

  1892. 	y de la primera versión (0.1) de txt2tags 26 de júlio)fué asunto de días.
    1893. 

  1893. 	Uno dependía de otro, fueron desarrollados juntos. Para ésta entrega, junto con sgml, HTML y Pagemaker, se implementaron otros formatos de archivo destino: MoinMoin, MagicPoint y texto plano. En menos de un ańo se realizaron más versiones de la série 
    1894. 

  1894. 	0.x  y el programa comenzó a crecer: nuevo formato UNIX Man page, macro ""%%date"", soporte para tablas, interfaz Web, alineamiento de imágen y generacón de índices de contenido (TOC).
    1895. 

  1895. 	En la versión 0.2 se ańadió un script de Shell para el manejo de operaciones de archivo y opciones en línea de comando.
    1896. 

  1896. 	Lo ańadí por que yo era un mago del shell y un novato de Python.
    1897. 

  1897. 	No es hasta la versión 0.9 cuando txt2tags se transforma en 100% código Python."
    1898. 

    1899. 

  1899. == Septiembre de 2002: séries 1.x : Crecimiento ==[history-2002]
    1900. 

    1901. 

    1902. 

    1903. 

  1903. 	 "La idea txt2tags resultó ser una buena idea. Decidí tomármela en serio.
    1904. 

  1904. 	 La siguiente etapa fue la de expandir el programa, dándolo a conocer: Ądocumentación!.
    1905. 

  1905. 	 Fué lanzado el site del programa, se configuraron listas de correo (en ingles y portugués) y nació la Guia del Usuario
    1906. 

  1906. 	 La base de usuarios creció y llegaron numerosas contribuciones. Sí!, pensé, está funcionando.
    1907. 

  1907. 	 Las nuevas funcionalidades ańadidas a las versiones de la série 1.x incluyen: Interfaz Gráfica (GUI), compatibilidad Windows & Mac, formato de destino LaTeX, %!style , el comando include  y los potentes filtros de Pre y Post proceso. "
    1908. 

  1908. 	
    1909. 

    1910. 

  1910. == Júlio de 2004:  séries 2.x : Maduración ==[history-2004]
    1911. 

    1912. 

    1913. 

  1913. 	"El crecimiento es duro y extrańo. żRecuerdas que dije que era un novato de Python?.
    1914. 

  1914. 	Ahora estoy mejor, pero los viejos fallos acumulados, y el reescribir la mayor parte del código lo hicieron inevitable. Esto
    1915. 

  1915. 	rompió la compatibilidad con algunas marcas, por lo que se creó un script actualizado. Se lanzó la versión 2.0. Con ella llegó
    1916. 

  1916. 	el formato XHTML, la validación de código W3C, i18n y el archivo RC. Un equipo de traductores hacen que el programa y su documentación sea traducida a varios idiomas. Se ańadió el formato de destino Lout y las nuevas macros ""%%mtime"", ""%%infile"", ""%%outfile"", y ""%%toc"". Continúa......
    1917. 

  1917. 	
    1918. 

    1919. 

  1919. ========================================================================
    1920. 

    1921. 

    1922. 

    1923. 

    1924. 

  1924. The End.
    1925. 

  1925. %nopdf([see source userguide.t2t])
    1926. 

  1926. [../../img/t2tpowered.png]
    1927.