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

http://txt2tags.googlecode.com/ · Unknown · 1927 lines · 1271 code · 656 blank · 0 comment · 0 complexity · 873c13a688e736773604a60bc5c4c5c7 MD5 · raw file

Large files are truncated click here to view the full 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 in…
    969.