DocBook

De Wikipedia, la enciclopedia libre

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.

Contenido

[editar] Ejemplos

[editar] 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>

[editar] 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>

[editar] 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.

[editar] 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."

[editar] Enlaces externos

Obtenido de "http://es.wikipedia.org/wiki/DocBook"
Herramientas personales
Crear un libro