Usando referencias y vínculos

En esta sección mostraremos como se pueden hacer referencias a partes internas del documento, así como a hipervínculos en el caso de internet.

Referencias dentro del mismo documento

Todas las marquillas de DocBook tiene el atributo id que 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, cabe anotar que para facilidad de navigación entre marquillas de DocBook es útil usar Move->Beginning of Element (ESC Control+a) y Move->End of Element (ESC Control+e)

Importante: El texto del identificador debe ir entre comillas y no puede contener caracteres propios del castellano como ñ o vocales con tilde

<!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 produciriría un resultado similar al siguiente

Aunque de escasa utilidad en este ámbito, pero con fines educativos podemos recordar la sección de nombre Marquillas en Capítulo 1.

En un hoja HTML dicha referencia serían adicionalmente un enlace a la sección correspondiente.

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, para ello la marquilla adecuada es ulink. También es a veces necesario incluir la dirección de correo electrónico, para lo cual es útil 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>j-davila@uniandes.edu.co</email>.</para>

Y se ve de la siguiente forma:

Puede conseguir información adicional de emacs en este enlace, o una copia del archivo hola.txt. En caso de dudas o comentarios puede enviar un email a .