Tabla de contenidos
En este capítulo introduciremos la manera de crear un pequeño documento en DocBook, usando emacs. Trataremos de ser didácticos, por lo cuál existirán a veces demasiadas instrucciones sobre todo referentes a la interacción con emacs. El lector más aventajado podrá omitir tales instrucciones con toda tranquilidad.
A continuación listamos las herramientas que usamos así como sus últimas versiones a la fecha de la escritura de este documento:
| Aplicación | DTD de DocBook | Versión | 4.1 | |
| Enlace | http://www.oasis-open.org/committees/docbook/sgml/4.1/index.shtml | |||
| Aplicación | DSSL de DocBook | Versión | 1.76 | |
| Enlace | http://docbook.sourceforge.net/projects/dsssl/ | |||
| Aplicación | OpenJade | Versión | 1.3 | |
| Enlace | http://openjade.sourceforge.net/ | |||
| Aplicación | Jadetex | Versión | 4.1 | |
| Enlace | http://sourceforge.net/projects/jadetex/ | |||
| Aplicación | docbook-utils | Versión | 0.6.10 | |
| Enlace | ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/docbook-utils-0.6.10.tar.gz | |||
| Aplicación | emacs | Versión | 21.2 | |
| Enlace | http://www.gnu.org/software/emacs/emacs.html | |||
| Aplicación | PSGML | Versión | 1.2.5 | |
| Enlace | http://www.lysator.liu.se/~lenst/about_psgml/ y http://psgml.sourceforge.net/ | |||
| Aplicación | make | Versión | 3.78.1 | |
| Enlace | http://www.gnu.org/software/make/make.html | |||
Es usual que cualquier distribución de Linux traiga dichas herramientas instaladas, en caso contrario puede encontrar información general de como instalarlas en Linux en el DocBook Install mini-HOWTO o en DocBook XML Install HOWTO si bien hay también información específica en el caso de las distribuciones Debian y RedHat. De igual forma hay paquetes integrados en los cuales ya vienen todas las herramientas necesarias como lo son los del TEI y XAE
Cabe aclarar que dichas herramientas se encuentran también disponibles para Windows. Se pueden encontrar instrucciones detalladas de como instalarlo en la página de SGML for Windows NT (en inglés) o en la página de Camilo Camacho (en castellano). De igual forma hay paquetes como los del TEI y XAE, en los cuales vienen preinstaladas dichas utilidades.
Para que tenga facilidades adicionales de edición, a las que tiene el modo PSGML de emacs, es necesario modificar el archivo de configuración .emacs. Una manera de hacer esto es bajar el archivo dotemacs y usar un comando como el siguiente:
[irving@abadon e1]$ cat dotemacs >>~/.emacs
Dicho comando simplemente añade algunas líneas al archivo ~/.emacs, creándolo si no existe. El archivo dotemacs de configuración está basado en la página PSGML tricks, en dicho sitio podrá encontrar más información al respecto