Introducción a Docbook

De WikiEducator
Saltar a: navegación, buscar



Introducción



Icon reading.jpg

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/
* http://openwritings.net/public/docbook/docbook





¿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

Transformaciones

Ayudas para instalar un procesador xslt: http://www.sagehill.net/docbookxsl/InstallingAProcessor.html

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

En Windows

Hojas de estilo CSS

  1. Crea la hoja de estilos para el html en una documento aparte.
  2. Añade el parámetro a la instrucción del procesador: 
 xsltproc --stringparam html.stylesheet  hoja_estilos.css  chunk.xsl  miarticulo.xml

Más info: http://www.sagehill.net/docbookxsl/UsingCSS.html


Herramientas

Icon key points.gif

Herramientas



Obtenido de «https://es.wikieducator.org/index.php?title=Usuario:Lmorillas/modulo_lenguajes_de_marcas/aplicaciones/intro_docbook&oldid=7371»