Vamos a comenzar a incluir información dentro del capítulo de DocBook de nuestro documento herramientas.sgml. Lo primero que haremos en este sentido será incluir un pequeño párrafo.
Cuando un párrafo supera una línea de longitud, este se puede alinear fácilmente a las marquillas correspondientes (para facilidad de lectura) usando M-q
Además necesitaremos introducir una lista, para lo cual es necesario el uso de las marquillas itemizedlist y listitem.
Nótese que cuando se introduce la marquilla itemizedlist usando C-c C-e, inmediatamente se incluyen marquillas de listitem.
Veamos a continuación dicho ejemplo y como es visualizado.
<sect1>
<title>Historia</title>
<para><acronym>DocBook</acronym> es un lenguaje de marcado, que
permite escribir documentación técnica, nacido en 1991.</para>
<para>Los principales contribuyentes a dicho proyecto han
sido:</para>
<itemizedlist>
<listitem>
<para>Hal Computer Systems y O'Reilly & Associates, de
1991 a 1994</para>
</listitem>
<listitem>
<para>El grupo Davenport, de 1994 a 1998.</para>
</listitem>
<listitem>
<para>El grupo <acronym>OASIS</acronym> de 1998 hasta hoy.</para>
</listitem>
</itemizedlist>
Y se el contenido se ve como:
DocBook es un lenguaje de marcado, que permite escribir documentación técnica, nacido en 1991.
Los principales contribuyentes a dicho proyecto han sido:
Hal Computer Systems y O'Reilly & Associates, de 1991 a 1994
El grupo Davenport, de 1994 a 1998.
El grupo OASIS de 1998 hasta hoy.
En caso de que uno desee una lista numerada, la marquilla de utilidad será orderedlist, el resultado se muestra a continuación.
Hal Computer Systems y O'Reilly & Associates, de 1991 a 1994
El grupo Davenport, de 1994 a 1998.
El grupo OASIS de 1998 hasta hoy.
Para cambiar la marquilla itemizedlist por orderedlist basta que se ubique dentro de la marquilla itemizedlist y haga C-c = y luego escriba orderedlist (recuerde que puede usar autocompletación, así que digitando or y TAB bastará). Puede obtener el mismo resultado con los menús mediante Modify->Change Element Name
El estilo de numeración de tales listas es el atributo numeration de la marquilla orderedlist, en caso de cambiar ésta por <orderedlist numeration="lowerroman"> , el resultado sería:
Hal Computer Systems y O'Reilly & Associates, de 1991 a 1994
El grupo Davenport, de 1994 a 1998.
El grupo OASIS de 1998 hasta hoy.
Una manera adicional de asignar atributos a una marquilla, es ubicándose en ella y usar Modify->Edit Atributes... (C-c C-a), luego se edita el atributo que se desee moviéndose con TAB, borrándolo (C-c C-a) y luego salvándolo (C-c C-c)