Differences

This shows you the differences between two versions of the page.

--- docbook:index [2009/02/20 20:56] – rlunaro
+++ docbook:index [2022/12/02 21:02] (current) – external edit 127.0.0.1
@@ Line 4: / Line 4: @@
 Las presentes páginas las he creado para documentar mis progresos: cómo crear desde cero un sistema de procesado de documentos y también cómo conseguir el objetivo propuesto de obtener varios formatos. Además lo quiero en Windows y Linux y que me soporte Unicode (porque soportaré documentos en varios idiomas, no necesariamente Western European).
+**Resumen de pruebas en linux**
+El fichero Makefile funciona prácticamente sin ajustar en Ubuntu 11 64 bit, gracias a que gran parte de los comandos son linux-alike.
 ===== Máquina virtual java =====
@@ Line 10: / Line 15: @@
 que nos hagamos una descarga de http://java.sun.com y procedamos
 con la instalación.
+===== Instalar cygwin ====
+**Añadido recientemente, work in progress**
+He descubierto recientemen cygwin. Cygwin es un conjunto de utilidades Unix que funcionan en windows. Es una excelente idea instalarse cygwin para hacer funcionar docbook: todo resulta mucho más sencillo.
+El sitio web de cygwin es [[http://www.cygwin.com]].
 ===== Necesitamos un procesador de XSLT =====
@@ Line 49: / Line 64: @@
 <code xml>
+<?xml version="1.0" encoding="utf-8"?>
 <book lang="es">
   <bookinfo>
@@ Line 80: / Line 96: @@
-==== Pasos adicionales para generar un fichero rtf o pdf ====
+===== Pasos adicionales para generar un fichero rtf o pdf =====
 Hay que instalarse una utilidad que se llama FOP.
@@ Line 157: / Line 173: @@
 </code>
+===== Fichero makefile =====
+Al final le he dado otro cuarto de vuelta al asunto de docbook, y he hecho lo siguiente:
-==== Otros ficheros que me he descargado ====
+  * he descargado cygwin
+  * he instalado fop
+  * he instalado htmlhelp
+  * he creado un fichero makefile que hace lo de los pasos anteriores, pero un poco más estructurado. lo adjunto aquí.
+<code Makefile>
+#
+# Makefile
+#
+#  make clean : clean out all unnecesary, temporal files
+#
+#  make book my_book=filename-without-extension: will construct the book "auditmap"
+#
+#
+#  make book  : generate all the documentation in various formats:
+#               html single page, html multiple pages, chm, pdf
+#
+#  make book_en : make the book in english
+#
+#  make html_single
+#  make html
+#  make chm
+#  make pdf
+#  make rtf
+#             : generate one specific document
+#
+#
+# my book's name (FILENAME WITHOUT EXTENSION)
+my_book ?= PUT_HERE_THE_FILENAME
+book_version = `cat version.txt`
+# options of the different programs
+xsltproc_options = --nonet
+# directories and programs
+tmp_dir = "tmp"
+xsltproc_dir = "/docbook-xsl-1.76.1"
+hhc = /htmlhelp/hhc.exe
+fop = /fop/fop.bat
+.PHONY: book
+book: chm html html_single pdf
+.PHONY: book_en
+book_en:
+	make book my_book=PUT_HERE_THE_FILENAME_en
+.PHONY: chm
+chm:
+	# make chm directory if don't exist
+	if [ -d chm ] ; then true; else mkdir chm; fi;
+	# copy the content of the gfx and images directory
+	cp -R gfx chm
+	cp -R images chm
+	cp docbook.css chm
+	xsltproc $(xsltproc_options) --output chm/ chm.xsl "$(my_book).xml"
+	# to ignore errors, start the command with a hyphen
+	-$(hhc) chm/htmlhelp.hhp
+	# move the resulting file into the "version" directory
+	if [ -d "$(book_version)" ] ; then true; else mkdir "$(book_version)"; fi;
+	mv "chm/htmlhelp.chm" "$(book_version)/$(my_book).chm"
+.PHONY: pdf
+pdf:
+	# make pdf directory if it don't exist
+	if [ -d pdf ] ; then true; else mkdir pdf; fi;
+	xsltproc $(xsltproc_options) --output "pdf/$(my_book).fo" fo.xsl "$(my_book).xml"
+	$(fop) "pdf/$(my_book).fo" -pdf "pdf/$(my_book).pdf"
+	# move the resulting file into the "version" directory
+	if [ -d "$(book_version)" ] ; then true; else mkdir "$(book_version)"; fi;
+	mv "pdf/$(my_book).pdf" "$(book_version)/$(my_book).pdf"
+.PHONY: rtf
+rtf:
+	# make rtf directory if it don't exist
+	if [ -d rtf ] ; then true; else mkdir rtf; fi;
+	xsltproc $(xsltproc_options) --output "rtf/$(my_book).fo" fo.xsl "$(my_book).xml"
+	$(fop) "rtf/$(my_book).fo" -rtf "rtf/$(my_book).rtf"
+	# move the resulting file into the "version" directory
+	if [ -d "$(book_version)" ] ; then true; else mkdir "$(book_version)"; fi;
+	mv "rtf/$(my_book).rtf" "$(book_version)/$(my_book).rtf"
+.PHONY: html_single
+html_single:
+	# make html_single directory if it don't exist
+	if [ -d html_single ] ; then true; else mkdir html_single; fi;
+	# copy the content of the gfx and images directory
+	cp -R gfx html_single
+	cp -R images html_single
+	cp docbook.css html_single
+	xsltproc $(xsltproc_options) --output "html_single/$(my_book).html" html_single.xsl "$(my_book).xml"
+	# move the resulting file into the "version" directory
+	if [ -d "$(book_version)" ] ; then true; else mkdir "$(book_version)"; fi;
+	cp -R "html_single" "$(book_version)"
+.PHONY: html
+html:
+	# make html directory if it don't exist
+	if [ -d html ] ; then true; else mkdir html; fi;
+	# copy the content of the gfx and images directory
+	cp -R gfx html
+	cp -R images html
+	cp docbook.css html
+	xsltproc $(xsltproc_options) --output "html/$(my_book).html" html.xsl "$(my_book).xml"
+	# move the resulting file into the "version" directory
+	if [ -d "$(book_version)" ] ; then true; else mkdir "$(book_version)"; fi;
+	cp -R "html" "$(book_version)"
+clean:
+	# to ignore errors, start the command with a hyphen
+	-rm -f chm/*
+	-rm -f html/*
+	-rm -f html_single/*
+	-rm -f pdf/*
+	-rm -f rtf/*
+</code>
+===== Otros ficheros que me he descargado =====
 **xmlNotepad**: bloc de notas xml de Microsoft. Puede descargarse
@@ Line 172: / Line 321: @@
 Hay dos ficheros: uno es el fichero "tdg5-en-0.0.20.chm" que viene
 en formato chm, y el otro viene en formato zip: tdg5-0.0.25.zip.
+===== Personalizando la salida de docbook =====
+Para configurar el comportamiento de docbook es necesario definir algunos parámetros que afectan a las
+hojas de estilo xsl.
+Yo he definido esos parámetors en varias hojas xsl que a continuación adjunto.
+==== chml.xsl ====
+<code xml>
+<?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+	<xsl:import href="docbook-xsl-1.76.1/htmlhelp/htmlhelp.xsl"/>
+	<xsl:param name="generate.legalnotice.link" select="1"/>
+	<xsl:param name="suppress.navigation" select="0"/>
+	<xsl:param name="admon.graphics" select="1"/>
+	<xsl:param name="admon.graphics.path">gfx/</xsl:param>
+	<xsl:param name="html.stylesheet" select="docbook.css"/>
+	<xsl:param name="toc.section.depth" select="4"/>
+  <!-- Taken from http://ds9a.nl/docbook/minimal-page.html -->
+  <xsl:param name="use.id.as.filename" select="'1'"/>
+  <xsl:template name="system.head.content">
+    <link rel="stylesheet" href="docbook.css" type="text/css"/>
+  </xsl:template>
+</xsl:stylesheet>
+</code>
+==== html.xsl ====
+<code xml>
+<?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+	<xsl:import href="docbook-xsl-1.76.1/html/chunk.xsl"/>
+	<xsl:param name="generate.legalnotice.link" select="1"/>
+	<xsl:param name="suppress.navigation" select="0"/>
+	<xsl:param name="admon.graphics" select="1"/>
+	<xsl:param name="admon.graphics.path">gfx/</xsl:param>
+	<xsl:param name="html.stylesheet" select="'docbook.css'"/>
+	<xsl:param name="toc.section.depth" select="4"/>
+  <!-- Taken from http://ds9a.nl/docbook/minimal-page.html -->
+  <xsl:param name="use.id.as.filename" select="'1'"/>
+  <xsl:template name="system.head.content">
+    <link rel="stylesheet" href="docbook.css" type="text/css"/>
+  </xsl:template>
+</xsl:stylesheet>
+</code>
+==== html_single.xsl ====
+<code xml>
+<?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+	<xsl:import href="docbook-xsl-1.76.1/html/docbook.xsl"/>
+	<xsl:param name="html.stylesheet" select="/docbook/docbook.css"/>
+	<xsl:param name="generate.legalnotice.link" select="1"/>
+	<xsl:param name="suppress.navigation" select="0"/>
+	<xsl:param name="admon.graphics" select="1"/>
+	<xsl:param name="admon.graphics.path">gfx/</xsl:param>
+	<xsl:param name="toc.section.depth" select="4"/>
+  <!-- Taken from http://ds9a.nl/docbook/minimal-page.html -->
+  <xsl:param name="use.id.as.filename" select="'1'"/>
+  <xsl:template name="system.head.content">
+    <link rel="stylesheet" href="docbook.css" type="text/css"/>
+  </xsl:template>
+</xsl:stylesheet>
+</code>
+==== fo.xsl ====
+<code xml>
+<?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+	<xsl:import href="docbook-xsl-1.76.1/fo/docbook.xsl"/>
+	<xsl:param name="generate.legalnotice.link" select="1"/>
+	<xsl:param name="suppress.navigation" select="1"/>
+	<xsl:param name="admon.graphics" select="1"/>
+	<xsl:param name="admon.graphics.path">gfx/</xsl:param>
+	<xsl:param name="toc.section.depth" select="4"/>
+  <!-- xsl:param name="ignore.image.scaling" select="0"/ -->
+  <xsl:param name="paper.type" select="A4"/>
+  <xsl:param name="paper.size.portrait" select="A4"/>
+  <xsl:param name="default.image.width" select="640"/>
+</xsl:stylesheet>
+</code>
+Es muy importante ese <xsl:template name="system.head.content".... muchos sitios no lo indican, y sin eso, no se incluyen las hojas de estilo.
+Ah!!! que no se nos olvide copiar el fichero docbook.css en el resultado html, ya que de lo contrario, los estilos no se aplicarán.
+==== El fichero docbook.css ====
+<code css>
+/* css 2.0 stylesheet for DocBook generated XHTML                             */
+/* (c) 2002 e-novative GmbH.                                                  */
+/* http://www.e-novative.de                                                   */
+/*
+-02-2012
+  Changes : superman_ha_muerto at yahoo dot com
+  - Minor changes and personalization
+-03-2003 - 21-03-2003
+  Changes : Bruno.Vernay at LaPoste dot net
+  - Replaced the title background with underline (better distinguish from
+    programlisting.)
+  - distinguish the h2 (from chapter) and the h2 from section
+    (div[class=section])
+*/
+/* Note that due to different browser interpretation of the standards, the    */
+/* html pages still do not look exactly the same on every browser and system  */
+/* This css file formats the html generated by the eDE                        */
+/* Please modify this file according to your personal preferences.            */
+/* In many spots, this file is not too well-documented currently. However,    */
+/* we will improve documentation over the time                                */
+/* basic settings for the document body, some elements inherit from these     */
+body
+{
+  /* foreground color = black */
+  color: #000;
+  /* background-color = white */
+  background-color: #fff;
+  /* center the body content in browser window */
+  /* Note: this is different from text-align   */
+  /* margin depends on browser window width    */
+  margin: auto;
+  /* padding ("inner margin") leaves space between */
+  /* browser window border and html body content   */
+  padding: 24px;
+  /* width depends on browser window width */
+  width: auto;
+  /* text-alignment    */
+  /* alternative: left */
+  text-align: justify;
+}
+/* set font for most elements                    */
+/* p: paragraphs (regular text, docbook <para>)  */
+/* (...) */
+/* body: anything else  */
+body, p, td, li, dt, dd, .itemizedlist
+{
+  /* set font size and line height                             */
+  /* list of fonts provides fallbacks if a font is not present */
+  font: 12px/18px  Arial, Helvetica, Sans-Serif;
+}
+/* pararaphs (docbook: <para>) */
+p
+{
+  /* set font size and line height                             */
+  /* list of fonts provides fallbacks if a font is not present */
+  font: 12px/18px Arial, Helvetica, Sans-Serif;
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 0 15px 6px 15px;
+}
+/* images */
+/* docbook: <imageobject> */
+img
+{
+  /* no margin */
+  margin: 0;
+  /* no padding ("inner margin") */
+  padding: 0;
+  /* no border */
+  border: 0;
+}
+/* emphasized text, can occur in most places */
+/* docbook: <emphasis> */
+em
+{
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+  /* italic */
+  font-style: italic;
+}
+/* sect(ion)1 title */
+h2
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 125%;
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+  /* underlined text */
+  text-decoration: none;
+  /* foreground color: dark blue */
+  color: #009;
+  /* background color: gray */
+  /* background-color: #ddd; */
+  border-bottom: solid 2px;
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 15px 0 15px 0;
+  /* padding ("inner margin") settings are top - right - bottom - left */
+  /* (think clockwise)                                                 */
+  padding: 12px 15px 12px 15px;
+}
+/* modif BV 14-03-2003 :
+  permet de distinguer titre de chapitre et titre de section */
+/* section title apr�s un chapitre */
+div[class=section] * h2
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 110%;
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+  /* underlined text */
+  text-decoration: none;
+  /* foreground color: dark blue */
+  color: #00A;
+  /* background color: gray */
+  /* background-color: #f0f0f0; */
+  border-bottom: solid 1px;
+  /* padding ("inner margin") settings are top - right - bottom - left */
+  /* (think clockwise)                                                 */
+  padding: 0 0 0 15px;
+}
+/* sect(ion)2 title */
+h3
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 110%;
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+  /* underlined text */
+  text-decoration: underline;
+  /* foreground color: dark blue */
+  color: #009;
+  /* background-color is a very light grey */
+  /* alternative: #fff = white             */
+  /* background-color: #fafafa; */
+  /* padding ("inner margin") settings are top - right - bottom - left */
+  /* (think clockwise)                                                 */
+  padding: 0 0 0 15px;
+}
+/* sect(ion)3 title */
+h4
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 100%;
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+  /* underlined text */
+  text-decoration: underline ;
+  /* foreground color: dark blue */
+  color: #009;
+  /* background-color is a very light grey */
+  /* alternative: #fff = white             */
+  /* background-color: #fefefe; */
+  /* padding ("inner margin") settings are top - right - bottom - left */
+  /* (think clockwise)                                                 */
+  padding: 0 0 0 15px;
+}
+/* sect(ion)4 title */
+h5
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 100%;
+  /* bold face, higher number is more bold */
+  font-weight: 300;
+  /* not underlined */
+  text-decoration: underline  ;
+  /* foreground color: dark blue */
+  color: #009;
+  /* background-color is a very light grey */
+  /* alternative: #fff = white             */
+  /* background-color: #fefefe; */
+  /* padding ("inner margin") settings are top - right - bottom - left */
+  /* (think clockwise)                                                 */
+  padding: 0 0 0 15px;
+}
+:link,:visited
+{
+  text-decoration: none;
+}
+/* define special font for e-novative logo */
+/* list of fonts provides fallbacks in case selected fonts are not present */
+.logo
+{
+  font-family: Arial, Sans-Serif;
+}
+/* the following formats refer to the docbook tags of the same name           */
+/* for more information, see the docbook reference at                         */
+/* http://www.docbook.org/tdg/en/html/docbook.html                            */
+.mediaobject
+{
+  /* center */
+  text-align: center;
+}
+/*  */
+.calloutlist, .figure, .table
+{
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 15px 30px 15px 30px;
+}
+/*  */
+.itemizedlist, .variablelist
+{
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 15px 30px 15px 15px;
+}
+/* blockquote formatting is a little more complex    */
+/* because block quotes are rendered as a html table */
+/* blockquote block */
+.blockquote
+{
+  /* override bottom margin, the other margins are inherited */
+  margin-bottom: 30px;
+}
+.blockquote p, .blockquote td
+{
+  /* set font size and line height                             */
+  /* list of fonts provides fallbacks if a font is not present */
+  font: 12px/18px Arial, Helvetica, Sans-Serif;
+  /* bold face, higher number is more bold */
+  font-weight: 450;
+}
+.epigraph
+{
+  /* override bottom margin, the other margins are inherited */
+  margin-bottom: 30px;
+}
+.epigraph p, .epigraph td
+{
+  /* set font size and line height                             */
+  /* list of fonts provides fallbacks if a font is not present */
+  font: 10px/14px Arial, Helvetica, Sans-Serif;
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+}
+/* custom e-novative header and footer that are displayed on all pages */
+#customheader, #customfooter
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 80%;
+  /* line height, relative to body font size */
+  line-height: 200%;
+  text-align: center;
+  vertical-align: middle;
+  color: #fff;
+  background-color: #009;
+}
+/* leave more space between last paragraph and footer  */
+/* some browser do not add up the bottom margin of the prior element */
+/* and the top margin of the footer */
+#customfooter {
+  margin-top: 15px;
+}
+/* table { margin: 0 15px 6px 15px; } */
+/* title and navigation links in header and footer */
+.navheader th, .navheader td, .navfooter th, .navfooter td
+{
+  font-size: 11px;
+  font-weight: 450;
+}
+/* table of contents, list of figures and list of tables */
+.toc, .list-of-figures, .list-of-tables
+{
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 15px 30px 15px 15px;
+}
+/* the "headings" are rendered as paragraphs */
+.toc p, .list-of-figures p, .list-of-tables p
+{
+  /* no margin */
+  margin: 0;
+}
+.figure
+{
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 5px 5px 5px 5px;
+  /* no padding ("inner border") */
+  padding: 0;
+  /* no border */
+  border: 0;
+  /* center text */
+  text-align: center;
+}
+/* figure title */
+.figure p, .table p, .example p
+{
+  font-size: 80%;
+}
+/*
+acronym {
+        border-bottom: 1px dashed #00cc00;
+        cursor: help;
+}
+*/
+/* admonition headings */
+div.note, div.important, div.warning, div.caution, div.tip
+{
+  padding: 0px 15px 0px 0px;
+}
+div.note th, div.important th, div.warning th, div.caution th, div.tip th
+{
+  /* set font size and line height                             */
+  /* list of fonts provides fallbacks if a font is not present */
+  font: 12px/18px Arial, Helvetica, Sans-Serif;
+  font-weight: 600;
+  text-decoration: underline;
+  /* left align */
+  text-align: left;
+}
+.note p, .important p, .warning p, .caution p, .tip p
+{
+  margin: 0;
+}
+.note img, .important img, .warning img, .caution img, .tip img
+{
+  margin: 0px 15px 0px 15px;
+}
+/* programlisting */
+pre.programlisting
+{
+  /* non-proportional font */
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: "Courier New", Courier, Monospace;
+  /* color: black */
+  color: #000;
+  /* background color: gray */
+  background-color: #eee;
+  /* no margin */
+  margin: 0;
+  /* gray dotted border, 1 px wide */
+  border: 1px dotted #ddd;
+  /* padding ("inner margin") settings are top - right - bottom - left */
+  /* (think clockwise)                                                 */
+  padding: 6px 6px 6px 6px;
+}
+/* title page */
+/* heading1 is used for document title */
+h1
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 150%;
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+  /* line height, relative to body line height */
+  line-height: 250%;
+  /* center */
+  text-align: center;
+  /* foreground color: dark blue */
+  color: #009;
+  /* background color: gray */
+  background-color: #ddd;
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 15px 0 15px 0;
+  /* no padding ("inner margin") */
+  padding: 0;
+}
+/* author on title page is formatted as h3          */
+/* these settings overwrite the regular h3 settings */
+h3.author
+{
+  /* set font size and line height                             */
+  /* list of fonts provides fallbacks in case selected fonts are not present */
+  font: 12px/18px Arial, Helvetica, Sans-Serif;
+  /* bold face, higher number is more bold */
+  font-weight: 600;
+  /* do not underline */
+  text-decoration: none;
+  /* center text */
+  text-align: center;
+  /* color: black */
+  color: #000;
+  /* background-color is a very light grey */
+  /* alternative: #fff = white             */
+  background-color: #fefefe;
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 0 15px 15px 15px;
+  /* no padding */
+  padding: 0;
+  /* no border */
+  border: 0;
+}
+/* copyright and date */
+.copyright, .pubdate
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 90%;
+  /* center */
+  text-align: center;
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 15px 15px 15px 15px;
+  /* no padding ("inner margin") */
+  padding: 0;
+  /* no border */
+  border: 0;
+}
+/* legal notice box */
+div.legalnotice
+{
+  /* list of fonts provides fallbacks if a font is not present */
+  font-family: Arial, Helvetica, Sans-Serif;
+  /* font size, relative to body font size */
+  font-size: 90%;
+  /* color: black */
+  color: #000;
+  /* background color: gray */
+  background-color: #ddd;
+  /* margin settings are top - right - bottom - left (think clockwise) */
+  margin: 10px 45px 10px 45px;
+  /* padding ("inner margin") settings are top - right - bottom - left */
+  /* (think clockwise)                                                 */
+  padding: 5px 5px 5px 5px;
+  /* solid black border, 1px wide */
+  border: 1px solid #000;
+}
+/*
+Taken from http://ds9a.nl/docbook/minimal-page.html
+*/
+.screen {
+        font-family: monospace;
+        font-size: 1em;
+        display: block;
+        padding: 10px;
+        border: 1px solid #bbb;
+        background-color: #eee;
+        color: #000;
+        overflow: auto;
+        border-radius: 2.5px;
+        -moz-border-radius: 2.5px;
+        margin: 0.5em 2em;
+}
+.programlisting {
+        font-family: monospace;
+        font-size: 1em;
+        display: block;
+        padding: 10px;
+        border: 1px solid #bbb;
+        background-color: #ddd;
+        color: #000;
+        overflow: auto;
+        border-radius: 2.5px;
+        -moz-border-radius: 2.5px;
+        margin: 0.5em 2em;
+}
+.guimenu,
+.guimenuitem
+{
+font-family: Arial;
+color: #0000ff;
+background-color: #c3c3c3;
+}
+.guibutton,
+.guilabel,
+.guiicon
+{
+font-family: Arial;
+color: #0000ff;
+background-color: #c3c3c3;
+border-top: 1px solid #cfcfcf;
+border-left: 1px solid #cfcfcf;
+border-bottom: 1px solid #747474;
+border-right: 1px solid #747474;
+}
+.application
+{
+font-family: Arial, Helvetica, Sans-Serif;
+font-style: italic;
+}
+/*
+class="tip"
+*/
+.tip,
+.caution,
+.note,
+.important
+{
+outline:#c8c8c8 solid thin;
+margin: 20px;
+}
+.tip table,
+.caution table,
+.note table,
+.important table
+{
+  padding: 20px;
+}
+</code>
+===== Starter kit =====
+He compilado lo más esencial en un "starter kit" que contiene:
+  * Un makefile para hacer crear pdf, html, html en una página
+  * Una cheatseet con varios ejemplos
+  * Un comienzo de libro, dividido en varios capitulos
+  * Hojas de estilo y xsl personalizadas (en la carpeta xsl)
+{{:docbook-starter.zip|Descargar docbook start}}