<title>Tutorial de Docbook
<h1>Tutorial de Docbook<p>
Por <a href="mailto:ismael@olea.org">Ismael Olea</a>



<h2>Los documentos tienen estructura
<ul>
	<li>El documento es la forma generalizada de intercambio de informacin escrita entre los seres humanos.
	<li>Los documentos se crean mediante convenios lingsticos:
		<ul>
			<li>Gramticos
			<li>Semnticos
			<li>Ortogrficos
			<li>Ortotipogrficos
		</ul>
	<li>Los documentos contienen informacin. Como tal, la informacin es pura, abstracta.
	<li>La informacin de los documentos est estructurada segn unos convenios -ortotipografa- que pueden ser explcitos o implcitos.
	<li>Para que el proceso de comunicacin tenga lugar hay que asegurar la mxima complitud de los convenios.
</ul>

<h2>Ventajas de la documentacin estructurada<p>
<ul>
	<li>Marcacin descriptiva versus marcacin procedimental.
	<li>El autor se centra en la labor de escritura y creacin, sin
	distraerse con asuntos que no son relevantes en el proceso de
	autora.
	<li>El documento es independiente de la plataforma, facilitando su
	manejo, almacenado, consulta y proceso.
	<li>Sencillez de edicin y fcil manejo con cualquier clase de
	herramientas de edicin de textos.
	<li>Apoyado por un adecuado sistema de representacin mejora la
	calidad final de los documentos y unifica el uso de las
	convenciones de estilo de cada idioma y rea de conocimiento.
	<li>Gracias al riguroso diseo tambin se facilita la automatizacin
	del proceso y el intercambio de documentos por medios
	informticos.

</ul>
<h2>SGML
<ul>
	<li>Standard Generalized Mark-up Language
	<li>Estndar internacional: ISO 8879/1986
	<li>Implementa las ventajas propias de la estructuracin de documentos:
		<ul>
			<li>Independiente de la representacin
			<li>Independiente de la plataforma
			<li>Abstraccin pura de la informacin
		</ul>	
	<li>Creado por el programa CALS del DoD su uso est generalizado en la industria aeroespacial y de defensa.	
	<li>Madurado desde 1960 (aplicacin de composicin de textos GML de IBM).
	<li>Charles Goldfard, su inventor, cre la filosofa de los lenguajes de marcas:
	<p><cite>...no limita los documentos a una nica aplicacin, a un estilo
		de formateado o a un sistema de procesamiento. Se basa en dos
		postulados novedosos (en aquel momento):
		<ol>
			<li>El etiquetado debera describir la estructura del
			documento y otros atributos ms que especificar el procesamiento que
			se va a llevar a cabo en dicho documento ya que el etiquetado
			descriptivo necesita efectuarse tan slo una vez, siendo sta
			suficiente para todos los procesamientos futuros.
			<li>El etiquetado debera ser riguroso de manera que las
			tcnicas disponibles para el procesamiento de objetos rigurosamente
			definidos, como por ejemplo los programas y bases de datos, puedan
			utilizarse tambin para el procesamiento de documentos.
		</ol>
		</cite>
	</li>
</ul>

<h2>Estructura de SGML
<dl>
	<dt>Juego de caracteres
	<dd>ASCII < Latin1 (ISO 8859-1) < Unicode (ISO/IEC 10646) <br> El
	juego de caracteres puede declararse explcitamente o, en su omisin,
	usar el juego predeterminado por el sistema.
	<dt>Declaracin de documento
	<dd>La DTD (declaracin de tipo de documento) especifica la
sintaxis y la jerarqua y relacin entre las marcas en las diferentes
formas en las que puede construirse un tipo o familia concreto de
documentos.<br> Como smil puede pensarse que es la definicin
rigurosa de un formulario especialmente flexible.
	<dt>Elementos
	<dd>Las secciones que componen al documento desde el punto de
vista estructural. La jerarqua y relaciones de los elementos est
definida en la DTD.<br> Familiarmente tambin se les llama etiquetas
o marcas.
	<dt>Atributos
	<dd>Los parmetro de cada elemento. Pueden ser opcionales (y
tener o no valores predeterminados) u obligatorios.
	<dt>Entidades
	<dd>De uso mltiple y flexible:
		<ul>
			<li>representacin de signos no recogidos por el juego de
			caracteres
			<li>abreviaturas o macros en el cdigo fuente
			<li>referencia a ficheros externos (como los #includes
			del lenguaje C)
			<li>variables, cuyo valor se especifica en el momento del
			procesamiento.
		</ul>
		Las entidades deben estar declaradas en el documento o en la
		DTD.
	<dt>Contenido
	<dd>El texto introducido entre marcas
	<dt>Instancia
	<dd>El documento SGML compuesto usando una DTD, sus elementos y
	los atributos de estos, las entidades internas/externas y el
	contenido entre marcas.
</dl>


<h2>DSSSL</h2>
<ul> 
	<li>Document Style Semantics Specificacion Language
	<li>Estndar internacional ISO/IEC 10179:1995
	<li>Salto de gigante en la manipulacin de documentos:
		<ul>
			<li>procesamiento de documentos para su representacin;
			<li>transformacin de documentos de una a otra DTD;
			<li>base para la gestin documental completa.
		</ul>
	<li>Proporciona:
		<ul>
			<li>entorno uniforme de manejo y modificacin de documentos;
			<li>entorno de creacin de filtros mediante hojas de estilo
			<li>entorno de programacin uniforme, basado en Scheme (lenguaje imperativo maduro, robusto, sencillo y perfectamente especificado -R4RS-)
		</ul>
</ul>

<h2>Entorno de produccin SGML</h2>

<center> <img src="entorno-sgml-generico.png" alt="Entorno SGML"></center>


<h2>Entorno SGML en Linux</h2>
<center><img src="entorno-sgml-linux.png" alt="Entorno SGML en Linux"></center>

<h2>Ejemplo de uso de aplicacin SGML</h2>
<center><img src="aplicacion-sgml-2.png" alt="Ejemplo de uso de aplicacin SGML">
</center>

<h2>	XML vs. SGML
<ul>
<li>		XML est escrito en SGML
<li>		XML es funcionalmente equivalente a SGML
<li>		es ms sencillo
<li>		no es tan potente:
<ul><li>		 uso obligatorio de comillas en los atributos
	<li>		 distingue maysculas de minsculas en los nombres de los elementos
	<li>		 no permite restricciones en el anidado de los elementos
	<li>		 no permite la minimizacin de elementos
</ul>
</ul>
<h2>	Docbook
<ul>
	<li>	 DTD tcnica de informtica
	<li>		 libros, artculos, pginas de manual y colecciones
		de los mismos
	<li> diseado por la industria
	<li> actualizado
	<li> SGML/XML
	<li> DSSSL/XSL
	<li> estandarizado en todos los proyectos de soft libre
		importantes
	<li> incluido en todas las distribuciones modernas
</ul>		
		
<h2>	Recursos mnimos:
<ul>		<li> Peazo de Libro de docbook
		<li> openjade
		<li> juego de dtds
		<li> juegos de caracteres ISO
		<li> docbook utils

		<li> jadetex + TeX (opcional para imprimir)
<h2> Paquetes:
<p>
Bsicos:
<ul>
	<li>
docbook-dtd30-sgml-1.0-10
<li>docbook-dtd31-sgml-1.0-10
<li>docbook-dtd40-sgml-1.0-10
<li>docbook-dtd41-sgml-1.0-10
<li>docbook-dtd41-xml-1.0-7
<li>docbook-style-dsssl-1.59-8
<li>docbook-utils-0.6-11
<li>docbook-utils-pdf-0.6-12
<li>jadetex-3.6-4
<li>openjade-1.3-12
<li>sgml-common-0.5-7
</ul>
Opcional:
<ul>
<li>psgml-1.2.1-8
</ul>
</ul>

</ul>
<h2>	Creando documentos:
<ul>		<li> eleccin de la DTD
		<li> planificacin del tipo de documento
		<li> estructuracin del documento
		<li> dar contenido
		<li> refine del marcado
		<li> impresin final
</ul>
<h2>Conocer docbook
<ul><li>presentacin del libro y explicacin del mismo
	<ul>
		<li>estructura del libro: intro + referencia (marcas + entidades parmetro + juegos de caracteres) apndices
		<li>explicacin rpida de los juegos de caracteres (por qu hay que tenerlos en cuenta)
		<li>explicacin de las secciones de cada etiqueta en la parte de referencia
	</ul>
	<li>explicacin de un ejemplo relativamente sencillo
	<li>explicacin de las marcas ms comunes que aparecen en el documento usando el Libro
</ul>	

<h2>Usando docbook
<ul>
	<li>Un ejemplo de cmo se escribe un documento
	<ul>
		<li>escribir un pequeo texto a vista de todo el mundo
		<li>uso de figuras
		<li>uso de hiperenlaces internos y externos
		<li>ficheros partidos
		<li>Cadver exquisito en directo?
	</ul>
	<li>Mostrar cmo se obtienen diversos formatos de impresin
	<li>Cmo se usa y se modifica una hoja de estilo aparte
</ul>

<h2>Referencias
<ul>	<li>Paquetes necesarios para usar docbook
	<li>El libro de docbook
	<li>Para saber ms
	<dl>
		<dt>Referencia principal
		<dd><a href="http://www.docbook.org">http://www.docbook.org</a>
		<dt>Material relacionado de Norman Walsh
		<dd><a href="http://www.nwalsh.com">http://www.nwalsh.com</a>
		<dt>Material en mi webo (incluido este tutorial)
		<dd> <a href="http://www.olea.org">http://www.olea.org</a>
		<dt>Tutorial en espaol
		<dd><a href="http://lucas.hispalinux.es/Tutoriales/DOCBOOK/doctut/single-html/dbktut.html">para practicar con l</a>
		<dt>Lista oficial de consulta de Docbook (ingls)
		<dd><a href="http://www.xml.org/archives/docbook/">http://www.xml.org/archives/docbook/</a>
		<dt>Lista oficial de consulta de aplicaciones Docbook (ingls)
		<dd><a href="http://www.xml.org/archives/docbook-apps/">http://www.xml.org/archives/docbook-apps/</a>
		<dt>Lista de ayuda en espaol
		<dd><a href="http://listas.hispalinux.es/mailman/listinfo/docbook-ayuda/">http://listas.hispalinux.es/mailman/listinfo/docbook-ayuda/</a>
	</dl>
</ul>

<h2>Preguntas
<p><center>Atrvase a preguntar todo lo que siempre quiso saber sobre
Docbook</center>

<h2>Despedida y cierre
<p>
<center>Esto es to... esto es to... esto es todo amigos!</center>