Introducción a Docbook

Introducción

Lectura

¿Qué es docbook? http://es.wikipedia.org/wiki/DocBook Alguna presentación interesante * http://www.hardy.com.bo/files/seminarios/docBook-tutorial-congreso.pdf * Presentación Norman Walsh: http://nwalsh.com/docs/tutorials/xml2005/slides.pdf * http://www.vogella.de/articles/DocBook/article.html Documentación principal de docbook * http://www.docbook.org/tdg/index.html * http://wiki.docbook.org Ayudas para hacer transformaciones * http://www.sagehill.net/docbookxsl/

¿Cómo escribo un documento con docbook?

Un documento docbook es un texto escrito en xml siguiendo unas reglas. Ejemplo:

<?xml version="1.0" encoding="utf-8"?>
<article xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
  <title>Sample article</title>
  <para>This is a very short article.</para>
</article>

Ejemplos

• Modelo de artículo para xmlprague: http://www.xmlprague.cz/2012/files/article-template.xml
• Documentación de inkscape: http://bazaar.launchpad.net/~inkscape.dev/inkscape-docs/trunk/files/head:/ https://inkscape.svn.sourceforge.net/svnroot/inkscape/doc-docbook/trunk/

Transformaciones

En Ubuntu

Instalamos: xsltproc, docbook5-xml y docbook-xsl-ns

En la carpeta donde has creado el fuente .xml:

$ DB=/usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html
$ xsltproc  $DB/docbook.xsl fuente.xml > salida.html
 
# múltiples archivos
$ xsltproc  $DB/chunk.xsl fuente.xml

Herramientas

http://docbookpublishing.com/ https://fedorahosted.org/publican/