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 es formateada esta 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><marquilla></replaceable> y <replaceable><\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"> <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
Nombre de la marquilla | Descripción de la marquilla |
<book> | Es la más importante, indica el inicio y fin de un libro |
<chapter> | Indica el inicio y fin de un capítulo |
Hay algunos caracteres reservados para DocBook, como lo son < y & , por eso en caso de que uno desee obtener en la salida algunos de esto debe reemplazarlos por < y & correspondientemente como se muestra en este ejemplo [1], un ejemplo de esto se da en el documento para obtener <marquilla>, cabe anotar que replaceable se usa en el caso de indicarse una palabra que puede ser reemplazada.
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 de emacs, la escritura de muchas de éstas marquillas es ahorrada.
[1] | En caso de necesitar teclear <, puede usar Control+c < |