El documento de ejemplo consta de dos capítulos (cap1.xdbk y cap2.xdbk), índice generado automáticamente (indice.xdbk) y bibliografía (biblio.xdbk) incluidos en democracia10.xdbk. El documento emplea la estructura que sugerimos e incluye ejemplos de logros, indicadores, definiciones, citas bibliográficas, ejercicios y gráficas.

Cuenta con un script de configuración (conf.sh) que busca hacer portable las fuentes de los contenidos a diversos sistemas operativos tipo Unix y a diversos ambientes DocBook. Este script, que debe ejecutar antes de procesar por primera vez el documento, detecta las herramientas que haya disponibles en su sistema (e.g procesador de DocBook, ubicación de hojas de estilo, ruta de instalación) y prepara el resto de infraestructura (e.g Makefile, hojas de estilo personalizadas) de acuerdo a estas. Debe ejecutarse desde el directorio del proyecto, por ejemplo:

	      cd democracia10
	      ./conf.sh
	    

Incluye un Makefile que entre otras, busca facilitar la generación del documento en los formatos HTML, PostScript y PDF. Para generar documentación en estos formatos, después de la configuración emplee:

make 

o si desea generar sólo HTML make html/index.html o para generar sólo PostScript make imp/democracia10.ps o para generar sólo PDF make imp/democracia10.pdf. También es posible validar la sintaxis del documento con make valida Puede revisar la ortografía con make ispell que generará un texto plano que es corregido usando el el diccionario democracia10.ispell. Tenga en cuenta que los errores de ortografía debe corregirlos en las fuentes (las correcciones que haga desde la sesión con ispell sólo modificarán el texto plano generado).

El Makefile incluye reglas que facilitan la distribución de fuentes y la publicación de nuevas versiones, actualizando un sitio en red (por ejemplo una página web). Para generar una distribución de fuentes:

	      make dist 

que generará el empaquetado democracia10-1.0.tar.gz con las fuentes de su proyecto. Para liberar una nueva versión, actualizando un sitio en Internet o en una intranet (después de configurar para su caso como se explica más adelante):

	      make act 

que generará y comprimirá el PostScript (democracia10-1.0.ps.gz), preparará un empaquetado con el HTML (democracia10-1.0_html.tar.gz) y copiará a un directorio en otro computador las fuentes comprimidas, el PostScript, el PDF, el comprimido con HTML y las páginas HTML.

Incluye un script (herram/db2rep) que extrae del documento DocBook información de los elementos que siguen las convenciones para periodos, definiciones, ejercicios, logros e indicadores y genera: archivo de definiciones (democracia10.def), archivo de clasificaciones (democracia10.cla) y archivo con secuencia (democracia10.sec). Puede ejecutarlo con:

make repasa	      
	    

Incluye algo de documentación que usted puede modificar para que otras personas que reciban las fuentes de sus contenidos pueda emplearlos o continuar el desarrollo. Tal documentación también puede servirle para complementar la presentada en este capítulo:

Tenga en cuenta que entre la documentación incluida en la plantilla no hay instrucciones para emplear DocBook, ni las convenciones de repasa. Puede consultar ayuda sobre DocBook en [Tutdocbk] o en [TDG] y las convenciones en db2rep(1)