| Tutorial de DocBook: Un enfoque integrado y a través de ejemplos | ||
|---|---|---|
| Anterior | Capítulo 5. Mejorando la presentación y organización del documento | Siguiente |
Existen diversas oportunidades en las cuáles uno desea saber si existe una determinada marquilla con una cierto significado. A continuación presentamos una serie de pasos que pueden ayudar en esta labor.
Esta es quizás la primera pregunta que uno tiene que hacerse puesto que DocBook es un lenguaje de marcado semántico o de contenido. Algunas características de contenido recurrentes son por ejemplo denotar que una palabra determinada representa una aplicación, un archivo o un comando. Características de presentación son por ejemplo el tipo de letra o el espaciamiento, tal tipo de características se controlan usando una hoja de estilo personalizada como es descrito en la la sección de nombre Acerca del estilo.
Para ello es muy útil tener a mano una copia del libro DocBook: The Definitive Guide y consultar el apéndice, en el cuál se describen con lujo de detalles todas las posibles marquillas. DocBook tiene marquillas para entradas bibliográficas, clases, métodos, descripción de parámetros de comandos y un gran número de posibilidades.
A pesar de que existan cerca de 400 marquillas en DocBook, a veces no existe una marquilla adecuada, como por ejemplo si uno quiere hacer referencia a un sistema operacional. En tales casos se usa la marquilla systemitem con un atributo role apropiado. Un ejemplo de dicha situación es el siguiente <systemitem role="os">Windows</systemitem>.
De igual forma existen en DocBook los medios de comunicación usuales en la comunidad del software libre y de fuentes abiertas para resolver dudas como lo son
Una lista de correo en castellano, docbook-ayuda
Una faq (Frequently Asked Questions) disponible en http://www.dpawson.co.uk/docbook/
Listas de correo en inglés, como lo son docbook (en ella se responden preguntas referentes al lenguaje de marcado como tal) y docbook-apps (en ella se habla de temas como presentación y herramientas que apoyan el proceso de DocBook). Para más información ver http://www.oasis-open.org/docbook/mailinglist/index.shtml.
Una aplicación que le permite enviar su documento escrito en formato DocBook por correo electrónico y luego le permite obtener dicho documento en formato html o en texto plano. Para las instrucciones de su uso consulte este mensaje del autor de la aplicación.
Una página Wiki-Wiki, donde se puede encontrar mucha información sobre DocBook y a su vez se puede editar o corregir de forma fácil.
En caso de que desee una charla en tiempo real, puede entrar al canal #docbook en irc.openprojects.net