Diferencia entre revisiones de «Usuario:Lmorillas/modulo lenguajes de marcas/aplicaciones/intro docbook»
De WikiEducator
(→En Ubuntu) |
(→Hojas de estilo CSS) |
||
Línea 70: | Línea 70: | ||
{{Puntos clave| | {{Puntos clave| | ||
Title=Herramientas| | Title=Herramientas| | ||
+ | TOCdepth=2| | ||
* http://docbookpublishing.com/ | * http://docbookpublishing.com/ | ||
* https://fedorahosted.org/publican/ | * https://fedorahosted.org/publican/ | ||
}} | }} |
Revisión de 05:01 24 feb 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
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