3. Cambios al contenido y a la estructura
Anterior | Capítulo 5. Ayudas para DocBook | Siguiente

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

Anterior | Subir | Siguiente
2. Cambios iniciales | Inicio | 4. Siguiendo convenciones