4. Siguiendo convenciones
Anterior | Capítulo 5. Ayudas para DocBook | Siguiente

## 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>

Anterior | Subir | Siguiente
3. Cambios al contenido y a la estructura | Inicio | 5. Cambios al makefile