| Tutorial de DocBook: Un enfoque integrado y a través de ejemplos | ||
|---|---|---|
| Anterior | Capítulo 3. Escribiendo un documento más complejo | 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>En DocBook, la estructura de un documento se se marca a través de marquillas de inicio y fin. Dichas marquillas lucen correspondientemente como <marquilla> y </marquilla>.
A continuación mostramos una tabla con algunas de las marquillas más usadas
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
Sugerencia: 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
Sugerencia: 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.