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