4. Siguiendo convenciones

En esta sección presentamos ejemplos del uso de las convenciones, la documentación completa sobre las mismas la encuentra en el manual del script que genera los archivos para repasa a partir de fuentes DocBook: db2rep (db2rep(1))

4.1. Logros e indicadores

Por ejemplo los logros de este documento, que se presentan en la introducción (ver Sección 2, “Sobre esta documentación”) se escribieron en las fuentes DocBook así:

<itemizedlist>
  <listitem role="logro" id="formato">
    <para>Escribe bancos de definiciones, los clasifica y 
      organiza las clasificaciones en secuencias empleando los formatos 
      XML. Además chequea los diversos archivos que crea.</para>
  </listitem>
  <listitem role="logro" id="herram-repasa">
    <para>Emplea las herramientas <command>repasa</command> y
      <command>repasatk</command> bien para repaso personal o para
      realizar autoevaluaciones, y en los archivos que escribe tiene
      en cuenta las características disponibles para estas herramientas.
    </para>
  </listitem>
  <listitem role="logro" id="docbook">
    <para>Emplea las convenciones y herramientas para DocBook que
      permiten extraer bancos de definiciones clasificados y su
      secuencia. </para>
  </listitem>
</itemizedlist> 

Los indicadores se escribirían de forma análoga pero empleando role="indicador" en lugar de role="logro".

4.2. Definiciones

Una definición introducida en este documento y cuya palabra puede ver en el índice es:

<indexterm role="pal">
  <primary>.def</primary>
 </indexterm>
 <para role="sig" id="formato.def.def" userlevel="3:indist">
   Extensión sugerida para archivos de definiciones
 </para>

y una definición introducida en [AA1.1] cuya palabra no puede verse en el índice es:

<para role="nipal:/home/patricio/cfil.txt"
    id="arch.gnome.ejruta1" userlevel="3">Ruta completa de  
    un archivo con nombre <filename>cfil.txt</filename> ubicado
    en el directorio del usuario patricio.</para>

4.3. Ejercicios

El siguiente ejemplo de ejercicio es extraído de [AA1.1]:

<qandaset>
  <qandaentry>
    <question role="ejer" id="gnome.conf.e1">
      <para>Abra un editor de texto, escriba algo
	de texto, y después cópielo y péguelo empleando el ratón (para
	pegar emplee el botón del centro).</para>
    </question>
    <answer>
      <para>Menú; gedit; escribir; marcar presionando botón
	izquierdo y arrastrando; pegar ubicando el cursor y
	presionando botón del centro.</para> 
    </answer>
  </qandaentry>
  <qandaentry>
</qandaset>

4.4. Periodos

En este documento se ha especificado que cada capítulo corresponda a un periodo, por esto el capítulo que está consultando inicia con:

<chapter id="ayudas-para-docbook" role="periodo" userlevel="p4">
  <title>Ayudas para DocBook</title>