Capítulo 4. Usando opciones más avanzadas

Tabla de contenidos

1. Sobre la metainformación
2. Mostrando relaciones
2.1. Referencias dentro del mismo documento
2.2. Vínculos con Internet
3. Capturando la atención del lector
3.1. Marquillas de importancia
3.2. Notas a pie de página
4. Facilitando la búsquedas al usuario
4.1. Glosarios
4.2. Definiendo las palabras claves de un índice
4.3. Generando índices
5. Dando información adicional
5.1. Incluyendo listados de programas
5.2. Preguntas Frecuentes
6. Segundo listado de herramientas.xml

Continuaremos haciendo cambios a nuestro documento con el fin de ir introduciendo características más avanzadas. El resultado de las mejoras que hagamos en este capítulo está en la Sección 6

1. Sobre la metainformación

Además de la información propiamente dicha que brinda un documento, existen características importantes de éste, como lo son el título, los autores, la licencia de publicación o la versión, que reciben el nombre de metainformación.

A continuación incluiremos tal tipo de datos para nuestro en nuestro ejemplo.

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<book lang="es">
  <bookinfo>
    <date>17 de Junio de 2001</date>
    <title><acronym>DocBook</acronym> y
    <application>emacs</application></title>
    <subtitle>Una guía básica</subtitle>
    <releaseinfo>Documentación en progreso</releaseinfo>
    <authorgroup>
      <author>
	<firstname>Jaime Irving</firstname>
	<surname>Dávila</surname>
      </author>
    </authorgroup>
    <address>jadavila@uniandes.edu.co</address>
    <legalnotice>
      <para>Este documento se cede al dominio público.</para>
    </legalnotice>
    <revhistory>
      <revision>
	<revnumber>1.0</revnumber>
	<date>16-06-2001</date>
	<authorinitials>jid</authorinitials>
	<revremark>Documento inicial</revremark>
      </revision>
      <revision>
	<revnumber>1.1</revnumber>
	<date>17-06-2001</date>
	<authorinitials>jid</authorinitials>
	<revremark>Inclusión encabezado</revremark>
      </revision>
      <revision>
	<revnumber>1.2</revnumber>
	<date>23-09-2001</date>
	<authorinitials>jid</authorinitials>
	<revremark>Corrección de legalnotice y jpg's</revremark>
      </revision>
      <revision>
	<revnumber>1.3</revnumber>
	<date>14-04-2002</date>
	<revremark>Inclusión de listados de programas, faq y
	marquillas de importancia</revremark>
      </revision>
  </bookinfo>

Todo documento que se encuentre en la red debe informar quien ejerce sus derechos de reproducción[4]. Para informar el titular del derecho de reproducción de una obra se utiliza la marquilla holder dentro de la marquilla copyright, de igual forma el año (o años) de su publicación se informa a través de la marquilla year. Adicionalmente se deben incluir las condiciones bajo las cuáles dicho documento se puede copiar, modificar y redistribuir (usando la marquilla legalnotice), en este caso dicho ejemplo se cede al dominio público, esto significa que usted puede modificar o hacer con dicho documento lo que usted quiera. Hay razones importantes para ceder las obras al dominio público como son expuestas en este escrito: http://www.tamarapatino.com/vladimir/dominio_publico.shtml".

Otra marquilla importante es el historial de revisiones (revhistory) en el cual a través de las marquillas de revision se hace explícito quien ha hecho modificaciones (authorinitials), en que fecha se han hecho (date), la versión de la revisión (revnumber) y una pequeña descripción de tal revisión (revremark).



[4] Esto se hace en caso de que se desee ejercer tal tipo de derechos. Si no se desea ejercer esta clase de derechos, se dice que tal obra pertenece al dominio público y se deberá dar información explícita de esto, usando la marquilla legalnotice.