Edici�n Estructurada en Emacs


Tabla de contenidos
1. Introducci�n
2. La Fantas�a de los Procesadores de Texto
3. El Mundo del Formateo de Textos
3.1. �Por qu� SGML?
3.2. Breve vistazo a SGML
4. SGML usando Emacs
4.1. Requisitos del Sistema
4.2. Hola Mundo
4.3. Primer Paso: La declaraci�n del Documento
4.4. Empezar a usar PSGML
4.5. Gran introducci�n, pero Emacs sigue sin gustarme demasiado...
4.5.1. Colores de las Fuentes
4.5.2. �Quiero ver lo que estoy seleccionando!
4.5.3. �Dios m�o! �C�mo hago para desactivar el est�pido ajuste de l�nea?
4.5.4. Guardando nuestras personalizaciones.
5. M�s all� de Hola Mundo
5.1. Dividir nuestros documentos en diferentes archivos.
5.2. Validar nuestros documentos
5.2.1. Validar un documento simple
5.2.2. Validar partes (entidades) de un documento
5.3. Manteniendo nuestros documentos bonitos
5.3.1. La Tecla Tab
5.3.2. Sangrar una regi�n
5.3.3. Otros detalles sobre el sangrado
5.4. Ortograf�a
5.5. Formatos y Gr�ficos
5.6. Referencias Cruzadas, Enlaces y URLs
5.6.1. XRef
5.6.2. URL
5.7. Otros trucos bonitos
5.7.1. Etiquetado no planeado
5.7.2. Par�metros de las Etiquetas
6. Sobre este art�culo
6.1. Sobre el autor
6.2. Sobre la traducci�n al espa�ol
 

Una gu�a de novato a novato sobre DocBook y otros est�ndares SGML/XML haciendo hincapi� en el uso de la edici�n directa y estructurada utilizando Emacs.

1. Introducci�n

Este art�culo se centra en el uso de Emacs para editar archivos SGML y sus derivados, como por ejemplo XML y HTML. Si nunca ha usado Emacs o este programa le desagrada por alguna raz�n, no se preocupe, a m� tambi�n me desagradaba. Siempre me pregunt� qu� era lo que la gente ve�a en una cosa tan complicada y poco amigable como Emacs. Sin embargo, cuando empec� a escribir en Docbook comprend� inmediatamente la necesidad de una herramienta m�s sofisticada que un simple editor de textos a color. En un principio yo hac�a mis trabajos utilizando Nedit, uno de mis editores de texto favoritos, pero no lleg� a las expectativas de lo que deb�a ser, para m�, el perfecto editor de texto estructurado: con sangrado autom�tico, que dejara bonitos los p�rrafos, que pudiera chequear la ortograf�a solamente de los datos y, lo m�s importante, que tuviera medios para la validaci�n contextual en tiempo de ejecuci�n de cualquier DTD. Ahora bien, �sta quiz� parezca una lista de deseos muy larga y dif�cil de satisfacer, pero descubr� que Emacs puede hacer f�cilmente todo esto y mucho, pero mucho m�s. Nunca advert� el poder y la flexibilidad de Emacs ya que nunca me impresion� como entorno, lo advert� en la edici�n de documentos SGML. De hecho, luego de descubrir Emacs gracias a la edici�n estructurada, este programa se ha convertido en mi navaja suiza y espero que, cuando usted termine de leer este art�culo, tambi�n se convierta en la suya.

Recientemente he probado LyX con Docbook y ahora puedo concluir que este intento tambi�n tiene futuro y facilita la transici�n de editores WYSIWYG [1]a la manera estructurada de editar textos. Sin embargo, esta clase de cosas nunca nos dar�n la libertad, el poder y la flexibilidad que nos pueden dar herramientas como Emacs + PSGML, especialmente si nos encontramos en un ambiente de programaci�n y estamos habituados a encarar los proyectos desde ese punto de vista.

Sobre el alcance de este art�culo s�lo dir� que no se trata de una gu�a para SGML, Docbook o Emacs. Como ya dir� m�s adelante, el principal objetivo es introducir y discutir el modo principal[2] PSGML de Emacs y las dificultades m�s importantes con las que se encontrar�a cualquier usuario al editar documentos SGML y XML. Este art�culo trata de ser una gu�a para principiantes por lo que la informaci�n que se proveer� aqu� deber�a ser suficiente para poder entender todo sin necesidad de conocimientos previos. De todos modos espero poder estimular al lector lo suficiente como para investigar a�n m�s en el tema. Es por esto que se dan algunas referencias y enlaces a otros art�culos y libros al final de este art�culo.

Recordemos tambi�n que Docbook, SGML y XML se est�n moviendo a un ritmo muy r�pido y que ya han surgido varias tendencias. Recomiendo la lectura del excelente art�culo de Eric Raymond sobre Docbook en el cual se explica en qu� etapa se encuentra Docbook actualmente y hacia d�nde apuntan varias de las tendencias (hay un enlace al final). Tambi�n deseo aclarar que este documento discute sobre el uso de SGML Docbook y no de XML Docbook, formato que parece ser una nueva tendencia. De todos modos, cualquier cosa que aparezca en este art�culo probablemente se aplique tambi�n para XML Docbook que en esencia es la misma cosa. Por lo que entiendo, el modo principal PSGML es capaz de analizar sint�cticamente DTD de tipos SGML y XML (o esquemas[3] que es el nombre que se le da en el mundo XML), lo que es otro motivo para pensar que todo lo que sea mostrado en este art�culo se aplicar� a ambas variantes de Docbook.

Notas

[1]

WYSIWYG son las siglas de "What You See Is What You Get" ("Lo que ves es lo que obtienes"). Esto hace referencia a la filosof�a de editores de textos como MS-Word, Word Perfect, Kword, o Writer de OpenOffice, en los que el usuario debe preocuparse por la apariencia y estructuraci�n del formato del documento.

[2]

De aqu� en adelante se traducir� "major mode" y "minor mode" al espa�ol como "modo principal" y "modo secundario", respectivamente. Nota del Traductor.

[3]

del t�rmino "schemes". Nota del Traductor.