PageRenderTime 98ms CodeModel.GetById 54ms app.highlight 28ms RepoModel.GetById 1ms app.codeStats 1ms

/doc/Spanish/writing-book-es.html

http://txt2tags.googlecode.com/
HTML | 290 lines | 274 code | 13 blank | 3 comment | 0 complexity | 56e99cc1198fad0c2f305f87f342fb20 MD5 | raw file
  1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  2<HTML>
  3<HEAD>
  4<META NAME="generator" CONTENT="http://txt2tags.org">
  5<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
  6<TITLE>Escribiendo Libros con Txt2tags</TITLE>
  7
  8<!-- Included ./Spanish/../English/writing-book.css -->
  9<STYLE TYPE="text/css">
 10body
 11	{
 12	font: normal 14pt sans-serif;
 13	text-align:justify;
 14	margin: 3em;
 15	padding: 3em 4em 2em 4em;
 16	border: 1px solid black;
 17	}
 18#toc ol
 19	{
 20	padding: 2em;
 21	}
 22#body h1
 23	{
 24	border-width: 0px 0px 1px 0px;
 25	border-style: solid;
 26	margin-top: 3em;
 27	}
 28#body p, #body ul, #body ol
 29	{
 30	margin-left: 3em;
 31	}
 32#body li
 33	{
 34	/* to make IE happy */
 35	margin-top: 1em;
 36	}
 37a
 38	{
 39	text-decoration: none;
 40	}
 41blockquote
 42	{
 43	margin-left: 5em;
 44	margin-top:2em;
 45	font-style:italic;
 46	}
 47code
 48	{
 49	font-style:italic;
 50	}
 51hr
 52	{
 53	margin-top:3em;
 54	}
 55</STYLE>
 56
 57</HEAD>
 58<BODY>
 59
 60<DIV CLASS="header" ID="header">
 61<H1>Escribiendo Libros con Txt2tags</H1>
 62<H3>por Aurelio Jargas</H3>
 63</DIV>
 64
 65<DIV CLASS="toc" ID="toc">
 66  <OL>
 67  <LI><A HREF="#toc1">Prefacio</A>
 68  <LI><A HREF="#toc2">Editores Visuales vs Lenguajes de Marcas</A>
 69  <LI><A HREF="#toc3">Una Aproximación a Txt2tags</A>
 70  <LI><A HREF="#toc4">Rápido y Vigoroso</A>
 71  <LI><A HREF="#toc5">Organizar las Fuentes en Carpetas</A>
 72  <LI><A HREF="#toc6">Fácil Control de la Versión</A>
 73  <LI><A HREF="#toc7">La Calidad en Primer Lugar</A>
 74  <LI><A HREF="#toc8">Otras Ventajas</A>
 75  <LI><A HREF="#toc9">Ninguna Herramienta Cubre Todas las Necesidades</A>
 76  </OL>
 77
 78</DIV>
 79<DIV CLASS="body" ID="body">
 80	<BLOCKQUOTE>
 81	Este documento es una breve guía que nos presenta los beneficios que puede reportarnos el uso de la herramienta 
 82	txt2tags en el proceso de escritura de libros. Lo que aquí se exponga es también aplicable a la redacción de 
 83	documentos extensos, tales como Guias y  Tesis.
 84	</BLOCKQUOTE>
 85<P></P>
 86<A NAME="toc1"></A>
 87<H1>1. Prefacio</H1>
 88<P>
 89Soy el autor de txt2tags <CODE>[1]</CODE> y he escrito dos publicaciones con él:  <A HREF="http://guia-er.sourceforge.net/">Regular Expressions book</A> (96 páginas) y Shell Programming Course (108 páginas). El proceso de su redacción fué tranquilo y nada doloroso, por lo que quisiera haceros partícipes de esta experiencia.
 90</P>
 91<P>
 92Escribir un libro comporta realmente un importante esfuerzo, pero no tiene porqué ser un esfuerzo complicado. Escribir consiste, esencialmente, en organizar las ideas en estructuras de texto, tales como párrafos, secciones, listas, etc. Txt2tags es una herramienta que facilita y simplifica dicha tarea.
 93</P>
 94<P>
 95Escribir sólo o en equipo, con o sin gestión de versión, un contenido técnico o no, sólo texto o con gráficos ......, en todos los casos txt2tags puede ser utilizada como la principal herramienta para la creación de un libro. 
 96</P>
 97<P>
 98<CODE>[1]</CODE> Txt2tags lee un archivo de texto con un mínimo de marcas tales como **bold** e  //italic// y lo convierte en documentos tipo HTML,LaTeX y Adobe PageMaker. Más información en : <A HREF="http://txt2tags.org">http://txt2tags.org</A>.
 99</P>
100<A NAME="toc2"></A>
101<H1>2. Editores Visuales vs Lenguajes de Marcas</H1>
102<P>
103Las dos formas principales de escribir un libro son, o bién utilizando un Editor Visual (<I>Microsoft Word</I>, <I>Adobe PageMaker</I>) o un Lenguaje de Marcas (<I>LaTeX</I>, <I>docbook</I>).
104</P>
105<P>
106Con los Editores Visuales se escribe y se formatea el contenido al mismo tiempo. Esto puede ser conveniente para textos cortos, pero para textos largos de, por ejemplo, 300 páginas, la labor de ir dando formato al texto que se va escribiendo consume una considerable cantidad de tiempo a la vez que distrae del proceso mismo de redacción.
107</P>
108<P>
109Con los Lenguajes de Marcas, se escribe el contenido y, posteriormente, se insertan las marcas. Un programa externo se encargará de convertir el archivo inicial al formato deseado. El redactor no debe preocuparse por el formato final del texto, pero el proceso, que comporta la inclusión de <CODE>&lt;tags&gt;&lt;/tags&gt;</CODE> y <CODE>\más{tags}</CODE> , facilita el error y ocasiona que el archivo fuente sea de dificil lectura.
110</P>
111<P>
112Txt2tags también utiliza marcas, pero con la gran diferencia que las marcas son mínimas y tan naturales como pueda ser la utilización del guión para el marcado de los elementos de una lista. De esta forma, el redactor puede centrarse sólo en el contenido generando, además, un archivo fuente facilmente legible. 
113</P>
114<A NAME="toc3"></A>
115<H1>3. Una Aproximación a Txt2tags</H1>
116<P>
117Utilizando txt2tags, el proceso de redacción de un libro sigue las siguientes etapas:
118</P>
119<OL>
120<LI>El autor(es) aprende(n) una série de marcas y reglas de marcado muy simples.
121<P></P>
122<LI>El autor escribe el contenido, sin preocuparse de aspectos del formato, tales como márgenes, fuentes, colores, tamaños etc.
123<P></P>
124<LI>El autor (o el editor) abre el contenido con un procesador de texto gráfico que lea HTML ( o LaTeX, o PM, o...) y finaliza el formateado del libro.
125<P></P>
126La etapa 1 dura apenas unos minutos. La etapa 2 puede durar meses y la etapa 3 puede comportar algunos dias o semanas.
127<P></P>
128Escribir el contenido es la tarea que consumirá la mayor parte del tiempo. Es, por lo tanto, importante conseguir que dicha tarea sea fácil, productiva e, incluso, placentera.
129<P></P>
130Seguidamente se expondrán argumentos que nos indicarán como la utilización txt2tags puede ayudar a conseguir los mencionados propósitos.
131</OL>
132
133<A NAME="toc4"></A>
134<H1>4. Rápido y Vigoroso</H1>
135<P>
136El tiempo es lo más importante. Utilizando txt2tags puedes lograr una gran productividad ya que podrás centrarte en el contenido, dejando en un plano muy secundario los aspectos formales.
137</P>
138<UL>
139<LI><B>Primera Revisión Rápida</B>
140<P></P>
141Suele ser dificil iniciar cualquier cosa, pero txt2tags aborda de forma amable esta dificultad. Acomódate y escribe en texto plano. Una vez hayas acabado, bastan unos pocos minutos para añadir las marcas al texto y tenerlo listo para su conversión y publicación.
142<P></P>
143<LI><B>Previsualización Rápida</B>
144<P></P>
145El formato final no tiene importancia; HTML es el formato preferido durante la redacción del texto. En cualquier momento puedes tener una imagen de lo que estás realizando, mediante la conversión del texto plano en una página HTML, visualizable con cualquier browser. Si necesitas una versión imprimible , puedes convertirla a PDF mediante la excelente herramienta   <A HREF="http://www.easysw.com/htmldoc/">htmldoc</A>.
146<P></P>
147<LI><B>Revisión del Contenido</B>
148<P></P>
149Para tener una rápida visión global del contenido del libro, puedes utilizar la opción de txt2tags <I>TOC Only</I> . El programa te mostrará la tabla de matérias, con la lista de los capítulos, secciones,subsecciones.... etc, numerados o no, sea cual sea su "profundidad".
150<P></P>
151<LI><B>Escritura Rápida</B>
152<P></P>
153Las marcas de txt2tags son simples y mínimas, muy fáciles de aprender. Sin nombres, opciones o parámetros. No tendrás necesidad de parar de escribir para insertar las marcas, se integran naturalmente en el flujo de escritura. Si en un momento dado no te acuerdas de una marca específica, olvídala y sigue escribiendo. Al final, durante una revisión rápida podrás insertar facilmente las marcas que falten.
154<P></P>
155<LI><B>Conversión Rápida</B>
156<P></P>
157Incluso si estás escribiendo un libros de 500 páginas la conversión es muy rápida. Ello es debido a que txt2tags actúa como un filtro, convirtiendo de un formato a otro. No necesita indexar, compilar, comprimir, calcular, trazar, ni de ningún otro pesado procesamiento del texto fuente. Nada de librerias, catálogos, esquemas o complejos DTDs.
158</UL>
159
160<A NAME="toc5"></A>
161<H1>5. Organizar las Fuentes en Carpetas</H1>
162<P>
163Txt2tags nos provee de una orden interna que nos permite insertar archivos externos en cualquier parte del documento. Ello nos permite dividir el documento fuente en múltiples archivos.
164</P>
165<UL>
166<LI><B>Cada Capítulo en una Carpeta</B>
167<P></P>
168Puedes crear una carpeta para cada capítulo, organizando la fuente en una estructura arborescente. Cada carpeta (capítulo) puede contener a su vez subcarpetas en donde emplazar imágenes, configuraciones o archivos a incluir en el documento.
169<P></P>
170<LI><B>Sin Conflictos</B>
171<P></P>
172Separando los capítulos en carpetas, distintas personas pueden trabajar sobre distintos capítulos sin interferir entre ellas. Cada equipo trabaja en su propio dossier, sin los conflictos que puedan derivarse del intercambio de archivos.
173<P></P>
174<LI><B>Control de Acceso Flexible</B>
175<P></P>
176Con la organización de las carpetas y los archivos, puede implementarse un sistema de control, estableciendo prioridades y privilegios para cada uno de los archivos y carpetas(capítulos). Pueden utilizarse las herramientas estándar del sistema para el establecimiento de los permisos de lectura/escritura, asi como para el establecimiento de un esquema de "usuarios y grupos".
177<P></P>
178<LI><B>Visión Global de las Fuentes</B>
179<P></P>
180Estructurar las fuentes nos ayuda también a tener una visión global del libro, utilizando un browser para ver rápidamente la cantidad de texto y de imágenes de cada capítulo. ( Truco: en UNIX, los comandos <CODE>tree</CODE> y <CODE>du</CODE> ).
181<P></P>
182<LI><B>Trabaja en Tu Capítulo; Olvida los Otros</B>
183<P></P>
184Separando los capítulos en archivos, puede procederse a la conversión de un sólo capítulo, sin necesidad de esperar que el libro este terminado. Además de la rapidez en la conversión que nos proporciona este tipo de organización, un capítulo puede ser remitido a los relectores o correctores, o ser publicado aisladamente como muestra del libro completo.
185<P></P>
186<LI><B>Tú Separas, Txt2tags Une</B>
187<P></P>
188Durante el proceso de conversión, txt2tags unirá automaticamente los capítulos para formar el libro final, sea cual fuere el tamaño o el nivel de la estructura en que se encuentren las distintas carpetas.
189</UL>
190
191<A NAME="toc6"></A>
192<H1>6. Fácil Control de la Versión</H1>
193<P>
194Txt2tags facilita el control de la versión del libro mediante herramientas en línea, tales como (<I>CVS</I> and <I>Subversion</I>). Las fuentes son texto plano, no datos compilados.
195</P>
196<UL>
197<LI><B>Trabaja con Líneas Cortas</B>
198<P></P>
199Puede acortar las líneas, cortándolas a 72 carácteres. Ello facilita el control de la versión ya que este se basa en la línea. Si el formato final necesita que un párrafo este compuesto por una línea larga ( como en PageMaker), txt2tags las concatenará automaticamente.  
200<P></P>
201<LI><B>Fuentes Legibles</B>
202<P></P>
203Con las marcas mínimas de txt2tags, el texto fuente es perfectamente legible. Se puede ver facilmente aquello que cambia de una versión a otra. En definitiva, las marcas no "polucionan" el texto.
204<P></P>
205<LI><B>Grandes Contenidos, Archivos Fuente Pequeños</B>
206<P></P>
207Con el texto plano pueden tenerse grandes contenidos con muy poca ocupación de espacio de disco. Pueden realizarse completos <I>checkouts</I> y <I>commits</I> , incluso con conexiones lentas.
208<P></P>
209<LI><B>Versionado de Capítulos</B> 
210<P></P>
211Mediante la organización de los capítulos en carpetas separadas, puede realizarse un control de versión separadamente por capítulos o secciones, dependiendo de la "granularidad" deseada.
212</UL>
213
214<A NAME="toc7"></A>
215<H1>7. La Calidad en Primer Lugar</H1>
216<P>
217Puedes escribir un libro o puedes escribir EL libro. Txt2tags te proporciona distintas posibilidades que te permitirán aumentar la calidad del trabajo.
218</P>
219<UL>
220<LI><B>Corrección Ortográfica</B>
221<P></P>
222Como las marcas de txt2tags son símbolos y no palabras, es posible utilizar un corrector ortográfico sobre el texto fuente.El corrector se ocupará exclusivamente del texto, sin intentar corregir las marcas.
223<P></P>
224<LI><B>Base de Datos de Alias</B>
225<P></P>
226Txt2tags tiene un <I>Pre Processing Filters</I> (filtro previo a la conversión), en el cual pueden definirse parejas <B>palabra-clave/valor</B>. Allá donde es encontrada la palabra-clave, es sustituida por el valor en el momento de la conversión. Por ejemplo, si en el texto fuente utilizas la cadena <CODE>URL_GOOGLE</CODE> , (palabra-clave), a la que se le ha asignado el valor:  <CODE>http://www.google.com</CODE> ; en el texto convertido aparecerá como <CODE>http://www.google.com</CODE>. Si la URL de Google cambiara, bastará con cambiar la definición del filtro para actualizar el texto. Pueden definirse tantas palabras-clave como se deseen, sin limitación alguna.
227<P></P>
228<LI><B>Contenido Dinámico</B>
229<P></P>
230Txt2tags tiene también un comando para incluir texto pre-formateado en el documento mientras se esta convirtiendo. Por ejemplo, una muestra de código fuente de programa. Se puede separar el código fuente del documento y actualizarlo, ya sea automaticamente o manualmente. Una buena idea consiste en marcar el código fuente de programa mediante marcas de comentario y un programa específico extraerá estas partes marcadas en ficheros separados.
231<P></P>
232<LI><B>Control Sobre el Resultado</B>
233<P></P>
234Txt2tags tiene un <I>Post Processing Filters</I> ( filtro posterior a la conversión) donde pueden definirse reglas que ajusten el documento generado en el proceso de conversión. De esta forma, si el resultado del proceso de conversión estandar de txt2tags no te gusta, puedes "mejorarlo" mediante tus propios filtros. Para la creación de los filtros pueden utilizarse las Expresiones Regulares.
235</UL>
236
237<A NAME="toc8"></A>
238<H1>8. Otras Ventajas</H1>
239<P>
240¡ Hay más !
241</P>
242<UL>
243<LI><B>Separar el Formato del Contenido</B>
244<P></P>
245Utilizado HTML como formato de salida, pueden usarse archivos CSS para probar distintas presentaciones finales del libro. Mediante CSS controlamos el formato de las hojas HTML. Existen distintos editores gráficos que nos permiten crear archivos CSS. Un equipo de diseño puede trabajar en archivos CSS (forma), mientras que el equipo de escritores puede dedicarse por entero a la redacción (contenido).
246<P></P>
247<LI><B>Incluir Estructuras Complejas</B>
248<P></P>
249Txt2tags  soporta todas las estructuras comunmente utilizadas en los textos: listas, definiciones, citas, área verbatim y tablas. Pero si una parte de tu libro requiriese la utilización de estructuras mas complejas, puedes recurrir a la opción <I>Pass-Thru Include</I> (inclusiones marcadas) en la cual pueden incluirse , por ejemplo, un texto HTML ya marcado. ¡ Con txt2tags las excepciones no son un problema!.
250<P></P>
251<LI><B>Utiliza Cualquier Editor</B>
252<P></P>
253Como los archivos fuente son de texto plano, puede utilizarse cualquier editor para generarlos. Incluso con el mas modesto editor del mundo puede generarse un libro. No se necesitan más capacidades que la de escritura y la de guardar el texto escrito. Si se utiliza un editor con soporte txt2tags, dispondremos de la <I>Coloración Sintáctica</I> , que nos permitirá identificar las marcas de txt2tags. Los editores con soporte txt2tags son : Vim, Emacs, Kate y Nano.
254<P></P>
255<LI><B>Soporte Técnico</B>
256<P></P>
257Txt2tags tiene distintos canales de soporte técnico: dos mailing lists ( una en inglés y otra en portugués), un canal IRC e, incluso, una comunidad <I>ORKUT</I>. Para proyectos de libros, puedes dirigirte directamente al autor del programa mediante e-mail; te responderá prioritariamente.
258</UL>
259
260<A NAME="toc9"></A>
261<H1>9. Ninguna Herramienta Cubre Todas las Necesidades</H1>
262<P>
263Existen algunos casos especiales en los cuales txt2tags no es una buena herramienta para escribir libros.
264</P>
265<UL>
266<LI><B>Libros Muy Complejos</B>
267<P></P>
268Los libros que incluyen tablas complicadas, fórmulas, estructuras específicas, precisan de un editor gráfico o de un lenguaje de marcas mas complejo, como LaTeX. Si este es el caso de tu libro, txt2tags no es tu herramienta.
269<P></P>
270<LI><B>Notas a Pié de Página</B>
271<P></P>
272Txt2tags no da soporte para notas a pié de página. Si en tu libro las utilizas poco, puedes añadirlas a posteriori. Si debes hacer un uso intensivo de ellas, txt2tags no puede ayudarte.
273<P></P>
274<LI><B>Referencias para Páginas, Tablas e Imágenes</B>
275<P></P>
276Si se desea incluir índices para las páginas, las tablas y las imágenes, puede utilizarse un editor gráfico en el momento de la edición;  sin ningún problema. Pero si lo que se pretende es referirse a ellas en el texto al modo de "<I>Ver tabla 4.11 en página 35</I>", txt2tags no puede ayudarte.
277<P></P>
278<HR NOSHADE SIZE=1>
279<I>Writing Books with Txt2tags - Oct/2004</I>
280(<A HREF="writing-book-es.t2t">see source</A>)
281<P></P>
282Traducido por: Antoni Serra Devecchi.
283<P></P>
284</UL>
285
286</DIV>
287
288<!-- html code generated by txt2tags 2.5 (http://txt2tags.org) -->
289<!-- cmdline: txt2tags -t html ./Spanish/writing-book-es.t2t -->
290</BODY></HTML>