Tutorial de DocBook: Un enfoque integrado y a través de ejemplos
AnteriorRetrocederCapítulo 5. Mejorando la presentación y organización del documentoAvanzarSiguiente

5.4. ¿Donde ir por más?

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.

  1. ¿Es una característica semántica?

    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 Sección 5.3.

  2. ¿Se encuentra en el listado de marquillas?

    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.

  3. Usar la marquilla systemitem

    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

AnteriorInicioSiguiente
Acerca del estiloSubirÍndice