Spiga

Crear documentación con DocBook

February 29, 08 by admin

He desarrollado un pequeño manual para todos aquellos que quieran empezar a crear documentación mediante DocBook.

¿Que es DocBook?
Docbook es un metalenguaje para la generación de documentos que siguiendo una estructura de etiquetas podemos generar una base de contenido que unido a un interprete de este lenguaje es capaz de generar documentos con nuestro contenido en diferentes formatos y estilos.

Para convertir este docbook a pdf hay un millón de formas de hacerlo tanto en Linux como en Windows, además de que según con qué se haga se obtendrá unos resultados u otros. El proyecto más fácil, limpio y con mejores resultados que se ha encontrado para generar pdf es este:
Dblatex
La idea de funcionamiento de esto es DocBook -> Xalan+XSL -> LaTeX -> pdflatex -> pdf y es en Xalan+XSL donde radica el asunto del aspecto que quedará.
¿Esto qué significa?, significa que teniendo en cuenta donde se “compile” el xml para convertirlo en pdf va a tener un aspecto u otro. Es más, hemos probado a compilar con dblatex en dos máquinas con dos linux distintos y hay pequeñas diferencias en el aspecto final.

Descargar: Documentacion DocBook

Fuente de la Documentación:fuente

This entry no have comments... but you can be first.

Leave a Reply