- DocBook
-
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.
Contenido
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 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
Categorías: Aplicaciones informáticas | Lenguajes de marcado | Lenguajes de descripción
Wikimedia foundation. 2010.