Primeros pasos con DocBook

Alberto Molina Coballes

Primeros pasos con DocBook
Alberto Molina Coballes
Tabla de contenidos
1. Introducción ................................................................................................................... 1
Instalación .................................................................................................................. 1
Configuración del entorno de trabajo – Emacs ................................................................. 1
Documento base .......................................................................................................... 2

iii
Capítulo 1. Introducción
Para realizar presentaciones o documentos de texto, en lugar de utilizar aplicaciones ofimáticas, llevo
muchos años utilizando LaTeX. LaTeX es muy potente y el resultado final es impresionante, es el formato
estándar para publicar documentación científica y era el formato utilizado para crear de forma colaborativa
documentación en proyectos de software libre, sin embargo hace años surgió el formato Docbook, que ha
sustituido a LaTeX en determinados ámbitos, en particular en este último. No tengo todavía una opinión
formada sobre las ventajas de uno sobre otro, creo que voy a empezar a utilizar DocBook para determinadas
cosas e iré aprendiendo de la experiencia.

En esta entrada se explica una manera de empezar a trabajar con DocBook (versión 5), utilizando Emacs
como editor y Debian GNU/Linux (squeeze) como sistema operativo.

Instalación
Instalamos los siguientes paquetes:

# aptitude install xsltproc fop docbook-xsl-ns docbook5-xml

Que incluye los esquemas de Docbook 5 en DTD, xsd, rng y rnc, las hojas de estilo y aplicaciones para
realizar transformaciones a HTML o PDF.

Configuración del entorno de trabajo – Emacs

Ya que Docbook es un dialecto XML del que disponemos de los esquemas, lo más lógico es utilizar algún
editor de textos que soporte la inclusión de esquemas, de manera que el documento se autovalide al vuelo.
Yo voy a utilizar Emacs con nxml-mode (véase Emacs como editor XML de este mismo blog), los pasos
a seguir son los siguientes:

(eval-after-load 'rng-loc '(add-to-list 'rng-schema-locating-files

"~/.schemas/schemas.xml"))

Para que se busquen los esquemas de los diferentes dialectos en el directorio ~/.schemas, de acuerdo a lo
especificado en el fichero schemas.xml, por lo que el siguiente paso es crear el directorio ~/.schemas y
ubicar allí el fichero schemas.xml con el siguiente contenido:

<locatingRules
xmlns="http://thaiopensource.com/ns/locating-rules/1.0">
<namespace ns="http://docbook.org/ns/docbook"
uri="/usr/share/xml/docbook/schema/rng/5.0/docbookxi.rnc"/>
</locatingRules>

1
 Introducción

Documento base
Vamos a utilizar el siguiente documento como base para crear un documento extenso (book):

<?xml version="1.0" encoding="utf-8"?>

<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
version="5.0" xml:lang="es">
</book>

Emacs reconocerá el espacio de nombres y automáticamente validará el formato y nos ayudará con el
autocompletado, con ello podemos crear nuestro primer documento sin tener mucha idea de DocBook,
aunque como es lógico es necesario tener a mano un buen manual, como por ejemplo DocBook 5: The
Definitive Guide, publicado por O’Reilly pero disponible a su vez vía web.