4.2. Mostrando relaciones
Es usual que sea necesario mostrar las relaciones existentes entre las diversas partes de un documento y fuentes externas como Internet a través del uso de referencias. En esta sección mostraremos como se resuelve dicho problema usando DocBook
4.2.1. Referencias dentro del mismo documento
Todas las marquillas de DocBook tienen el atributo id, el cual permite asignarles como identificador una cadena determinada. Suele ser una buena idea asignarles identificadores a los elementos como book, chapter, sect1 y sect2 con el objetivo de hacer referencias a dichas divisiones del documento posteriormente. A continuación daremos identificadores a tales partes de nuestro ejemplo.
 | El texto del identificador debe ir entre comillas y no puede contener caracteres propios del castellano como ñ o vocales con tilde |
 | Para facilidad de navegación entre marquillas de DocBook es útil usa Move->Beginning of Element (M-C-a)y Move->End of Element (M-C-e) |
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<book lang="es" id="herramientas">
<chapter id="DocBook">
<title><acronym>DocBook</acronym></title>
<para></para>
<sect1 id="historia">
<title>Historia</title>
<para></para>
</sect1>
<sect1 id="marquillas">
<title>Marquillas</title>
<para></para>
</sect1>
</chapter>
<chapter id="emacs">
<title><application>emacs</application></title>
<para></para>
<sect1 id="invocacion">
<title>Invocación</title>
<para></para>
</sect1>
<sect1 id="persistencia">
<title>Escribiendo y guardando un archivo</title>
</sect1>
</chapter>
</book> |
La marquilla útil para hacer referencias es xref, simplemente en su atributo linkend se coloca el identificador del sitio a donde se hizo la referencia. A continuación presentamos un ejemplo de este tipo de situación.
<sect1 id="persistencia">
<title>Escribiendo y guardando un archivo</title>
<para>Aunque de escasa utilidad en este ámbito, pero con fines
educativos podemos recordar <xref linkend="marquillas"/>.
</para> |
Esto produciría un resultado similar al siguiente
En un hoja HTML dicha referencia serían adicionalmente un enlace a la sección correspondiente.
4.2.2. Vínculos con internet
Es usual tener que hacer vínculos con recursos que se encuentran en internet o que son archivos de un sitio local. En estos casos la marquilla adecuada es ulink. En caso de querer incluir una dirección de correo electrónico, se utiliza la marquilla email. A continuación mostramos un ejemplo que ilustra dicho tipo de situaciones.
<para>Puede conseguir información adicional de <application>emacs</application> en este <ulink url="http://www.emacs.org">enlace</ulink>, o una copia del archivo <ulink url="hola.txt">hola.txt</ulink>. En caso de dudas o comentarios puede enviar un <foreignphrase>email</foreignphrase> a <email>jadavila@uniandes.edu.co</email>.</para> |
Y se ve de la siguiente forma: