El modelo de publicación general de DocBook XML está ilustrado en el gráfico de esta página de la web de Norman Walsh. No todos los elementos del diagrama están presentes en el modelo de publicación que realmente se utiliza. Pero sí los siguientes: Catálogos XML: son la forma de indicar a los procesadores de XSLT (y otras herramientas XML) dónde pueden encontrar las hojas de transformación XSLT y las definiciones de tipo de documento DTD. Se trata de ficheros con sintaxis XML, que se referencian unos a otros (de una forma similar a las construcciones include de muchos lenguajes de programación. El punto de comienzo para los catálogos de esta aplicación es el fichero catalog.xml que reside en el directorio raíz del módulo del CVS. Definiciones de tipo de documento (DTD): son ficheros que describen el vocabulario de los documentos XML válidos, es decir, los nombres de las etiquetas (y sus atributos) y las relaciones entre ellas. Las páginas web están descritas mediante el DTD Website Full (algunas antiguas todavía utilizan la versión reducida, llamada simplemente Website. Una línea en la cabecera de cada documento XML especifica el DTD al que se adscribe el documento. La aplicación utiliza también otros DTD para describir otros documentos XML, como el catálogo, o el layout. Hojas de transformación XSLT: son ficheros (con sintaxis XML) que indican cómo realizar una transformación sobre un documento XML. La aplicación utiliza diversas hojas XSLT, con distintos propósitos, como se describe en una sección posterior. Procesador XSLT: aplicación para transformar un documento XML según las instrucciones de una hoja XSLT. Se utiliza para convertir los documentos XML originales en otros destinados a su publicación. Debido al gran número de veces que hay que aplicarlo y a la complejidad de sus parámetros, se utiliza la herramienta make para invocar las transformaciones. De todos los procesadores XSLT de código libre, se utiliza el xsltproc, aunque podría reemplazarse por cualquier otro.

Se utilizan en esta aplicación distintos conjuntos de hojas de transformación, para los siguientes propósitos: Ayudar en el procesamiento de los documentos, realizando el cálculo de dependencias (generación parcial del fichero Makefile). Reconocer la separación entre la disposición física de los documentos XML en el directorio xml y la disposición de las páginas generadas (es decir, sus URLs). Transformar los documentos XML en páginas XHTML, para lo cual se usa las hojas de estilo de Norman Walsh (con una ligera adaptación que se describe en el siguiente punto) y unas hojas de estilo personales que modifican ciertos parámetros de las anteriores. Adaptar las hojas de estilo de Norman Walsh para que generen XHTML totalmente válido. Las originales están pensadas para HTML, pero como las propias hojas XSLT son a su vez documentos XML, se puede usar otra hoja XSLT para realizar algunas modificaciones sobre ellas. Transformar los documentos XML en otros formatos, como HTML y LaTeX.

FIXME: escribir esta seccción

Algunas particularidades referidas a la configuración de las herramientas necesarias en un sistema Debian GNU/Linux están anotadas en este wiki, incluyendo las listas de paquetes necesarios. El capítulo 3 del libro DocBook XSL: The Complete Guide también contiene información útil sobre las herramientas. También resulta práctico el documento Installing And Using An XML/SGML DocBook Editing Suite. Para los amantes de (X)Emacs, existe un gran soporte para trabajar con DocBook XML y otras tecnologías (como XSLT). En la versión XEmacs ya están integradas en el editor, pero eso no es todo, ya que también se pueden conseguir extensiones como ésta.

Las tres principales formas de invocar a make son las siguientes: make (o también make all) Genera todas las páginas y las deja en el directorio build listas para instalación. make install Instala las páginas. Básicamente, copia el contenido del directorio build (y otros) en los sitios apropiados. make mrproper Limpia todos los restos de la generación de las páginas.

make check-xml Comprueba que las páginas en XML sean documentos bien formados y válidos con respecto a sus correspondientes DTD. Es muy convieniente ejecutar esta tarea antes de subir cualquier cambio al CVS. Si no hay ningún error, el comando no muestra ningún mensaje. make check-xhtml Realiza la misma comprobación, pero para las páginas ya generadas en XHTML. No deberían detectarse errores en esta comprobación, lo contrario indicaría un error en las hojas de estilo. make check-layout Realiza también la comprobación, en este caso sólo para el fichero layout.xml. Es conviente ejecutar esta tarea después de modificar este fichero.

FIXME: escribir esta sección