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))
Por ejemplo los logros de este documento, que se presentan en la introducción (ver la sección de nombre Sobre esta documentación en Capítulo 1) 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".
De acuerdo a las convenciones para indicar que un elemento de una lista es un indicador de logro se pone el valor indicador al atributo ... del elemento listitem.
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>
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>
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>