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)).