3. Cambios al contenido y a la estructura

Para modificar el contenido sugerimos emplear un editor de texto con un modo especial para DocBook. Antes de hacer cambios al documento DocBook, edite el archivo confv.empty que contiene información general sobre el proyecto y las herramientas que usará para generar documentación. De requerirlo, cambie el nombre del proyecto (PROYECTO), la versión (PRY_VERSION[20]), y si es el caso el URL del sitio de desarrollo de su proyecto (URLSITE). Para comenzar no requiere cambiar otras variables, las demás variables mantienen fechas de actualización, ubicación de hojas de estilo, ubicación de programas para procesar documentos DocBook y rutas de instalación; estas variables normalmente serán cambiadas por el script conf.sh de acuerdo a la plataforma del usuario.

Después de hacer cambios a confv.empty borre el archivo confv.sh (note que tiene una 'v' de variables) y vuelva a ejecutar conf.sh.

Puede comenzar a hacer sus cambios a los archivos DocBook (democracia10.xml, cap1.xml y cap2.xml). El archivo principal, es decir raíz de su documento, es democracia10.xml, desde el cual se incluyen los demás. Este es el archivo por modificar para renombrar, agregar o eliminar archivos con capítulos, así mismo incluye la portada del libro (e.g. título, autor, derechos de reproducción). Los archivos de los que conste su proyecto además de ser referenciados en el archivo raíz, deben estar en la variables SOURCES del Makefile.

El primer capítulo del libro de ejemplo está en el archivo cap1.xml, este capítulo tiene ejemplos de todos los elementos DocBook que siguen convenciones de repasa, modifíquelo de acuerdo al contenido que tendrá. Además de estos ejemplos puede consultar las convenciones en el manual del script de conversión de DocBook a archivos para repasa (db2rep(1)).



[20] Si libera nueva versiones cambie PRY_VERSION