Tutorial de DocBook: Un enfoque integrado y a través de ejemplos | ||||
---|---|---|---|---|
Anterior | Retroceder | Capítulo 3. Escribiendo un documento más complejo | Avanzar | Siguiente |
A continuación mostramos el código de la primera sección de nuestro documento de ejemplo y la manera cómo se le da formato a dicha información. Posteriormente explicaremos algunas de las marquillas y características que este código usa.
<sect1> <title>Marquillas</title> <para>En <acronym>DocBook</acronym>, la estructura de un documento se se marca a través de marquillas de inicio y fin. Dichas marquillas lucen correspondientemente como <replaceable>&lt;marquilla></replaceable> y <replaceable>&lt;\marquilla></replaceable>.</para> <para>A continuación mostramos una tabla con algunas de las marquillas más usadas</para> <table> <title>Algunas marquillas</title> <tgroup cols="2"> <thead> <row> <entry>Nombre de la marquilla</entry> <entry>Descripción de la marquilla</entry> </row> </thead> <tbody> <row> <entry>Nombre de la marquilla</entry> <entry>Descripción de la marquilla</entry> </row> <row> <entry><book>/entry> <entry>Es la más importante, indica el inicio y fin de un libro</entry> </row> <row> <entry><chapter></entry> <entry>Indica el inicio y fin de un capítulo</entry> </row> </tbody> </tgroup> </table> </sect1> |
Hay algunos caracteres reservados para DocBook, como lo son < y & , por eso en caso de que uno desee escribir alguno de éstos debe reemplazarlos por < y &, respectivamente. Las secuencias de texto que, como en el anterior caso, comienzan por & y terminan en ; se llaman entidades en la terminología SGML/XML
En DocBook existen una gran cantidad de entidades para describir todo tipo de carácteres como lo son por ejemplo o distintos tipos de flechas. Desde emacs usted puede encontrar tal tipo de entidades a través de Markup->Insert Entity |
En caso de necesitar teclear <, puede usar C-c < |
De otro lado para hacer una tabla es necesario primero declararla usando table y luego se indica mediante la marquilla tgroup y su atributo cols el número de columnas de tal tabla. Cada fila se indica usando row y para hacer referencia a una celda dentro de una fila se usa entry. Si se usa el modo PSGML de emacs, la escritura de muchas de éstas marquillas es generada automáticamente.