Diferencia entre revisiones de «Usuario:Lmorillas/modulo lenguajes de marcas/aplicaciones/intro docbook»
De WikiEducator
Línea 10: | Línea 10: | ||
; Alguna presentación interesante: | ; Alguna presentación interesante: | ||
: * http://www.hardy.com.bo/files/seminarios/docBook-tutorial-congreso.pdf | : * http://www.hardy.com.bo/files/seminarios/docBook-tutorial-congreso.pdf | ||
+ | : * http://www.e-ghost.deusto.es/docs/2006/cursillos/edicion_digital/DocBook.pdf | ||
: * Presentación Norman Walsh: http://nwalsh.com/docs/tutorials/xml2005/slides.pdf | : * Presentación Norman Walsh: http://nwalsh.com/docs/tutorials/xml2005/slides.pdf | ||
: * http://www.vogella.de/articles/DocBook/article.html | : * http://www.vogella.de/articles/DocBook/article.html | ||
; Documentación principal de docbook: | ; Documentación principal de docbook: | ||
: * http://www.docbook.org/tdg/index.html | : * http://www.docbook.org/tdg/index.html | ||
+ | : * Esquemas oficiales: http://www.oasis-open.org/docbook/xml/ | ||
: * http://wiki.docbook.org | : * http://wiki.docbook.org | ||
; Ejemplos de etiquetas | ; Ejemplos de etiquetas | ||
Línea 21: | Línea 23: | ||
: * http://www.sagehill.net/docbookxsl/ | : * http://www.sagehill.net/docbookxsl/ | ||
: * http://openwritings.net/public/docbook/docbook | : * http://openwritings.net/public/docbook/docbook | ||
+ | ; Hojas de estilo oficiales para transformación | ||
+ | : http://sourceforge.net/projects/docbook/files/docbook-xsl-ns/ | ||
}} | }} | ||
Revisión de 22:10 1 mar 2012
Contenido
Introducción
|
¿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
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
- Crea la hoja de estilos para el html en una documento aparte.
- 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