DocBook

DocBook es un aplicación del estándar SGML/XML e incluye una DTD propia y que se utiliza de manera más destacada en el área de la documentación técnica, especialmente para documentar todo tipo de material y programas informáticos. Existe un Comité Técnico de DocBook en OASIS (originalmente SGML Open) que mantiene y actualiza este estándar. DocBook inicialmente comenzó como una DTD de SGML, pero a partir de la versión 4 existe un equivalente para XML.

Ejemplos

Artículo en DocBook SGML/XML

<?xml version="1.0" standalone="no"?>
     <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
       "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

     <article lang="es">
      <title>Creando Documentación Técnica con
      DocBook</title>

      <articleinfo>
       <author>
        <firstname>Leonardo</firstname>
        <surname>Caballero</surname>
       </author>
      </articleinfo>

      <section id="art-intro">

       <title>Introducción</title>

       <para>DocBook es un aplicación del estándar
       SGML/XML e incluye una DTD propia y que se utiliza de manera
       más destacada el área de la documentación
       técnica, especialmente para documentar todo tipo de
       material y programas informáticos, para mayor
       información consultar aquí <ulink
       url="http://www.oasis-open.org/docbook/"/>.</para>

      </section>

     </article>

Libro en DocBook SGML/XML

     <?xml version="1.0" standalone="no"?>
     <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
       "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
     <book lang="es" id="simple_libro">
      <title>Un libro muy simple</title>

       <chapter id="capitulo_1">
        <title>Capitulo 1</title>
        <para>Hola mundo!</para>
        <para>¡Yo espero que tu día sea bueno!</para>
       </chapter>

       <chapter id="capitulo_2">
        <title>Capitulo 2</title>
        <para>Hola otra vez, mundo!</para>
       </chapter>
    </book>

Usos

DocBook es muy utilizado en algunos contextos, entre los que destacan Linux Documentation Project (Proyecto de documentación Linux), las referencias de las APIs de GNOME y GTK+, así como la documentación del núcleo de Linux. Las páginas man del Entorno Operativo Solaris se generan también a partir de documentos que utilizan las DTDs de DocBook.

Referencia

Norman Walsh y el equipo de desarrollo del DocBook Open Repository mantienen un conjunto de hojas de estilo DSSSL y XSL para generar versiones PDF y HTML de documentos DocBook (así como para desarrollar otros formatos, incluyendo páginas de referencia man y de ayuda en HTML). Walsh es también el principal autor del libro DocBook: The Definitive Guide (DocBook: La Guía Definitiva), la documentación oficial de DocBook. Este libro se puede obtener bajo licencia GFDL o en su versión impresa (ISBN 1565925807), editada por O'Reilly & Associates."

Enlaces externos

• DocBook wiki
• DocBook en OASIS (Organization for the Advancement of Structured Information Standards)
• DocBook Open Repository Project en SourceForge
• DocBook Validator + Transformer en SourceForge
• DocBook's Live-DTD
• DocBook: The Definitive Guide
• DocBook Filters - Read and write DocBook xml using OpenOffice.org
• Getting Started With DocBook on OpenOffice, para aquellos que deseen editar DocBook con el OpenOffice.org.
• <oXygen/> DocBook Editor (commercial)
• Documention with DocBook on Win32