Por motivos profesionales tengo que aprender a usar DocBook. Ando buscando un sistema que me permita generar documentación (por supuesto con imágenes, me encantan las imágenes) a varios formatos: html, pdf, chm.

Parece ser que Docbook satisface mis necesidades, además de ser una herramienta de código abierto que funciona en Windows y en Linux.

Las presentes páginas las he creado para documentar mis progresos: cómo crear desde cero un sistema de procesado de documentos y también cómo conseguir el objetivo propuesto de obtener varios formatos. Además lo quiero en Windows y Linux y que me soporte Unicode (porque soportaré documentos en varios idiomas, no necesariamente Western European).

Bueno, no sé muy bien lo que es, pero necesitamos un procesador de xslt. Hay varios disponibles ¹⁾:

Saxon

Saxon (http://saxon.sourceforge.net/) was written by Michael Kay, the author of XSLT Reference, one of the best books on XSLT. Saxon is a free processor written in Java, so it can be run on any operating system with a modern Java interpreter. Saxon now comes in two flavors: Saxon 6 which handles the XSLT 1.0 standard, and Saxon 8 which handles the newly emerging XSLT 2.0 and other new XML standards.

Xalan

Xalan (http://xml.apache.org/xalan-j/index.html) is part of the Apache XML Project. It has versions written in both Java and C++, both of them free. The Java version is described in this book because it is highly portable and easier to set up. Generally Xalan is used with the Xerces XML parser, also available from the Apache XML Project.

xsltproc

The xsltproc (http://xmlsoft.org/XSLT/) processor is written in C by Daniel Veillard. It is free, as part of the open source libxml2 library from the Gnome development project. It is considered the fastest of the processors, and is highly conformant to the specification. It is much faster than either of the Java processors. It also processes XIncludes.

Me he decantado por xsltproc. Puede descargarse para windows aquí. Al descargarlo, lo he instalado en mi ordenador y lo he puesto en el PATH, de forma que cuando ejecute:

c:\> xsltproc

desde cualquier punto, se ejecutará el programa.

Me queda la duda de si la instalación ha ido bien, me dejo pendiente este punto para adivinar cómo debe comprobarse que funciona y que no me faltan librerías.

http://www.pnotepad.org/devlog/archives/000173.html

Un bloc de notas de una persona que ha tenido el mismo problema que yo: hacer un documento en DocBook desde cero: buscar software, hacer las primeras pruebas, construir un entorno “estable” de trabajo en docbook….

http://www.sagehill.net/docbookxsl/XSLprocessors.html#XSLTprocessors

Un libro que habla de DocBook XSLT, donde me he enterado de lo fundamental sobre el software que necesito.