Diferencia entre revisiones de «Usuario:Lmorillas/modulo lenguajes de marcas/aplicaciones/intro docbook»
De WikiEducator
(11 revisiones intermedias por el mismo usuario no mostrado) | |||
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 | ||
+ | : * http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html.es | ||
+ | : * http://www.neodoc.biz/es/index.html | ||
+ | : * http://www.disca.upv.es/magustim/val/pfcs_anteriors/autoriaXMLDocBook/pfc.pdf (a partir de pág. 29) | ||
; Ayudas para hacer transformaciones | ; Ayudas para hacer transformaciones | ||
: * http://www.sagehill.net/docbookxsl/ | : * http://www.sagehill.net/docbookxsl/ | ||
+ | : * http://openwritings.net/public/docbook/docbook | ||
+ | ; Hojas de estilo oficiales para transformación | ||
+ | : http://sourceforge.net/projects/docbook/files/docbook-xsl-ns/ | ||
}} | }} | ||
Línea 29: | Línea 38: | ||
* Taller docbook: http://www.polinux.upv.es/drupal/files/taller_docbook.pdf | * Taller docbook: http://www.polinux.upv.es/drupal/files/taller_docbook.pdf | ||
* http://xml.web.cern.ch/XML/goossens/dbatcern/ | * http://xml.web.cern.ch/XML/goossens/dbatcern/ | ||
+ | |||
+ | * http://dev.mysql.com/doc/mysqldoc-guide/en/fg-introduction.html | ||
+ | * http://dev.mysql.com/doc/mysqldoc-guide/en/index.html | ||
+ | * http://dev.mysql.com/doc/mysqldoc-guide/en/mysqldoc-guide-formats-processes-pdf.html | ||
+ | |||
+ | * http://www.ling.helsinki.fi/kit/2002s/ctl230/assignments/assignment5.html | ||
+ | |||
+ | * http://developer.gnome.org/gdp-handbook/stable/gettingstarted.html.en | ||
+ | |||
+ | |||
--> | --> | ||
Línea 42: | Línea 61: | ||
===Ejemplos=== | ===Ejemplos=== | ||
− | * Modelo de artículo para xmlprague: http:// | + | * Modelo de artículo para xmlprague: http://archive.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/ | * 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/ | ||
+ | * http://dev.mysql.com/doc/mysqldoc-guide/en/index.html | ||
+ | * http://developer.gnome.org/gdp-handbook/stable/gettingstarted.html.en | ||
+ | |||
== Transformaciones == | == Transformaciones == | ||
Línea 61: | Línea 83: | ||
</source> | </source> | ||
+ | ===En Windows=== | ||
+ | * http://openwritings.net/public/docbook/install-xsltproc-and-fop-generate-pdf-docbook-document | ||
+ | |||
+ | === 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 | ||
{{Puntos clave| | {{Puntos clave| | ||
Title=Herramientas| | Title=Herramientas| | ||
+ | TOCdepth=2| | ||
* http://docbookpublishing.com/ | * http://docbookpublishing.com/ | ||
* https://fedorahosted.org/publican/ | * https://fedorahosted.org/publican/ | ||
}} | }} | ||
+ | |||
+ | == Creación Epubs== | ||
+ | [[../creacion epubs | Creación de epubs]] | ||
+ | |||
+ | |||
+ | ==Hacks == | ||
+ | === Insertar un mapa como un iframe en html === | ||
+ | <ol><li>Crea un documento de docbook usando una instrucción de proceso para el mapa: | ||
+ | <source lang="xml"> | ||
+ | <?xml version="1.0" encoding="utf-8"?> | ||
+ | <article xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en"> | ||
+ | <title>Ejemplo de uso de mapa de google en un documento docbook</title> | ||
+ | <para>Este hack ha sido sugerencia de Jirka Kosek </para> | ||
+ | <para>Coloco una instrucción de proceso en el lugar donde tiene que aparecer el mapa</para> | ||
+ | <?google-map?> | ||
+ | <para>Después edito la hoja de estilos ...</para> | ||
+ | <para>Y proceso usando mi hoja de estilos modificada ...</para> | ||
+ | </article> | ||
+ | </source> | ||
+ | </li> | ||
+ | <li>Escribe una adaptación para las hojas de estilo: | ||
+ | <source lang="xml"> | ||
+ | <?xml version='1.0'?> | ||
+ | <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> | ||
+ | <!-- 1. Importo las hojas de estilo de docbook que voy a usar --> | ||
+ | <xsl:import href="/usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/docbook.xsl"/> | ||
+ | |||
+ | <!-- 2. Template que va a mostrar el mapa de google que me interesa --> | ||
+ | <xsl:template match="processing-instruction('google-map')"> | ||
+ | <iframe width="425" height="350" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" | ||
+ | src="http://maps.google.es/?ie=UTF8&ll=41.645158,-0.923731&spn=0.003263,0.004823&t=k&z=18&output=embed"> | ||
+ | </iframe> | ||
+ | <br /> | ||
+ | <small><a href="http://maps.google.es/?ie=UTF8&ll=41.645158,-0.923731&spn=0.003263,0.004823&t=k&z=18&source=embed" style="color:#0000FF;text-align:left"> | ||
+ | Ver mapa más grande</a> | ||
+ | </small> | ||
+ | </xsl:template> | ||
+ | </xsl:stylesheet> | ||
+ | </source> | ||
+ | </li> | ||
+ | <li>Proceso usando la nueva hoja de estilos: | ||
+ | <source lang="bash"> | ||
+ | $ xsltproc -o mapa.html a_html_mapa.xsl ejemplo_mapa.xml | ||
+ | </source> | ||
+ | </li> | ||
+ | </ol> |
Última revisión de 21:10 21 feb 2013
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://archive.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/
- http://dev.mysql.com/doc/mysqldoc-guide/en/index.html
- http://developer.gnome.org/gdp-handbook/stable/gettingstarted.html.en
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
Creación Epubs
Hacks
Insertar un mapa como un iframe en html
- Crea un documento de docbook usando una instrucción de proceso para el mapa:
<?xml version="1.0" encoding="utf-8"?> <article xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en"> <title>Ejemplo de uso de mapa de google en un documento docbook</title> <para>Este hack ha sido sugerencia de Jirka Kosek </para> <para>Coloco una instrucción de proceso en el lugar donde tiene que aparecer el mapa</para> <?google-map?> <para>Después edito la hoja de estilos ...</para> <para>Y proceso usando mi hoja de estilos modificada ...</para> </article>
- Escribe una adaptación para las hojas de estilo:
<?xml version='1.0'?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> <!-- 1. Importo las hojas de estilo de docbook que voy a usar --> <xsl:import href="/usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/docbook.xsl"/> <!-- 2. Template que va a mostrar el mapa de google que me interesa --> <xsl:template match="processing-instruction('google-map')"> <iframe width="425" height="350" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="http://maps.google.es/?ie=UTF8&ll=41.645158,-0.923731&spn=0.003263,0.004823&t=k&z=18&output=embed"> </iframe> <br /> <small><a href="http://maps.google.es/?ie=UTF8&ll=41.645158,-0.923731&spn=0.003263,0.004823&t=k&z=18&source=embed" style="color:#0000FF;text-align:left"> Ver mapa más grande</a> </small> </xsl:template> </xsl:stylesheet>
- Proceso usando la nueva hoja de estilos:
$ xsltproc -o mapa.html a_html_mapa.xsl ejemplo_mapa.xml