DocBook
| ||||||
DocBook. Dialecto de SGML que permite la escritura de documentacion técnica y que día a día gana más seguidores dentro de la comunidad del software libre y de fuente abierta.
Sumario
Descripción
Es un esquema (disponible en varios idiomas incluyendo RELAX NG DTD SGML y XML, y el esquema XML de W3C) mantenida por el Comité Técnico de DocBook de OASIS.
Es particularmente bien adaptado a los libros y artículos sobre hardware y software. Como lenguaje semántico que es, DocBook nos permite crear documentos en un formato neutro, independiente de la presentación.
En este formato neutro, se recogen tanto el contenido como la estructura lógica del mismo. Permitiendo así que pueda ser publicado automáticamente en multitud de formatos: HTML, XHTML, EPUB, PDF, man pages , HTML Help, etc. Simplemente aplicando "plantillas" de presentación, sin que sea necesario ningún cambio sobre el documento original.
Historia
Nació en 1991, de un proyecto conjunto de HAL Computer Systems y O'Reilly & Associates. Evolucionando posteriormente hasta tener su propia organización (el Grupo Davenport). Para acabar, en 1998, siendo gestionado por el consorcio SGML Open; que más tarde se convertiría en la organización OASIS. En cuyo seno existe actualmente el DocBook Technical Committee, encargado del mantenimiento del estándar DocBook.
La especificación DocBook está disponible tanto en el formato SGML como en el formato XML. Estando definida tanto por un documento DTD, como por un esquema RELAX NG - W3C XML Schema.
Nació como una aplicación de SGML, pero actualmente su adaptación XML la ha sustituido en la mayoría de usos. (A partir de la versión 4 del DTD SGML, la versión DTD XML ha tomado su propio camino y su propio esquema de numeración.)
En un principio, el uso del formato DocBook estaba prácticamente reducido al grupo de compañías participantes en su diseño. Pero en estos momentos, ha sido ampliamente adoptado por toda la comunidad de Software libre y por un amplio espectro de compañías. Existiendo en el mercado multitud de herramientas que hacen uso de él.
Uso
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 o los esquemas de docBook.
Escritura
Como documentos XML que son, los documentos DocBook pueden ser escritos con cualquier editor de texto. Aunque siempre será más sencillo escribirlos con un editor XML. O, mejor aún, con un editor XML que lleve integrados los esquemas específicos de DocBook.
Por ejemplo Emacs, trabajando en modo nXML, o XML Copy Editor. También existen editores más "visuales" (WYSIWYG). Tales como XMLmind Editor ("XXE"); Oxygen XML Editor, capaz de representar los documentos DocBook formateandolos con CSS; o Syntext Serna, que realiza transformaciones XSL en tiempo real.
