5.1. Dividiendo el documento
Cuando el documento adquiere un tamaño considerable es usual querer distribuir el texto que contiene a lo largo de diversos archivos distintos. En nuestro caso dividiremos a nuestro documento en cuatro archivos distintos, herramientas.sgml que contendrá la metainformación del documento, docbook.sgml y emacs.sgml que contendrán los capítulos 1 y 2 respectivamente y apéndices.sgml que contendrá los apéndices.
A continuación mostramos el listado de herramientas.sgml
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN"[
<!ENTITY genindice.sgml SYSTEM "genindice.sgml">
<!ENTITY docbook.sgml SYSTEM "docbook.sgml">
<!ENTITY emacs.sgml SYSTEM "emacs.sgml">
<!ENTITY apendices.sgml SYSTEM "apendices.sgml">
]>
<book lang="es" id="doc-emacs">
<bookinfo>
<date>17 de Junio de 2001</date>
<title><acronym>DocBook</acronym> y
<application>emacs</application></title>
<subtitle>Una guía básica</subtitle>
<releaseinfo>Documentación en progreso</releaseinfo>
<authorgroup>
<author>
<firstname>Jaime Irving</firstname>
<surname>Dávila</surname>
</author>
</authorgroup>
<address>jadavila@uniandes.edu.co</address>
<legalnotice>
<para>El siguiente documento se cede al dominio público</para>
</legalnotice>
<revhistory>
<revision>
<revnumber>1.0</revnumber>
<date>16-06-2001</date>
<authorinitials>jid</authorinitials>
<revremark>Creación del documento inicial</revremark>
</revision>
<revision>
<revnumber>1.1</revnumber>
<date>17-06-2001</date>
<authorinitials>jid</authorinitials>
<revremark>Inclusión del encabezado del documento</revremark>
</revision>
<revision>
<revnumber>1.2</revnumber>
<date>23-09-2001</date>
<authorinitials>jid</authorinitials>
<revremark>Corrección de legalnotice y jpg's</revremark>
</revision>
<revision>
<revnumber>1.3</revnumber>
<date>14-04-2002</date>
<revremark>Inclusión de listados de programas, faq y
marquillas de importancia</revremark>
</revision>
<revision>
<revnumber>1.4</revnumber>
<date>15-04-2002</date>
<revremark>Partición en varios documentos</revremark>
</revision>
</revhistory>
</bookinfo>
&docbook.sgml;
&emacs.sgml;
&apendices.sgml;
&genindex.sgml;
</book> |
Notemos que el procedimiento es en general definir entidades por cada uno de los archivos a incluir a través de <!ENTITY ..> y luego incluir el contenido de dichas entidades en la estructura del documento, a través de un comando como &arch.sgml;
 | Es útil decir en los archivos que se dividió el documento (en este caso docbook.sgml, emacs.sgml y apendices.sgml) cuál es el documento principal al que pertenecen (en este caso herramientas.sgml). Esto se hace a través de un comentario al final del documento del siguiente estilo Incluir dichas línes permite que el modo PSGML de emacs funcione correctamente. |