Por qué se necesita docbook

por qué se necesita docbook?

El formato DocBook fue diseñado por el consorcio OASIS específicamente para documentación técnica. Proporciona un conjunto completo de etiquetas para describir el contenido de su documento.
A continuación se presentan varios puntos clave que ayudan a comprender qué es DocBook:

• DocBook es un lenguaje de marcado
  Es muy similar a HTML en este aspecto. Las etiquetas dan estructura a su documento y aparecen intercaladas con el texto informativo.
  Este particular punto supone una revolución en la traducción de documentación, porque la fase de autoedición (dar aspecto profesional al texto) se realiza una sola vez indirectamente mediante el etiquetado del texto original. Los traductores solo tienen que traducir «entre las etiquetas» y presionando una sola tecla se genera el documento traducido.
• Está diseñado para documentación técnica
  DocBook es perfectamente adecuado para documentación de piezas de motores de vehículos. Sin embargo, está claramente orientado hacia la documentación de programas informáticos.
• Técnicamente, DocBook es un DTD SGML o XML
  Esto significa que se pueden aprovechar las muchas herramientas compatibles con SGML y XML. Aunque DocBook como implementación XML es relativamente reciente, tiene un largo historial como implementación SGML.
• DocBook no es un lenguaje de presentación
  DocBook se preocupa cuidadosamente de no especificar cómo debe verse la documentación final. Esto permite al redactor concentrarse en la organización y el significado del documento que escribe. Todos los aspectos de presentación se delegan en hojas de estilos.
  Esto garantiza que todos sus documentos tengan una apariencia coherente, independientemente de quién sea el redactor técnico.
• DocBook es personalizable
  Es bastante sencillo personalizar el DTD para adaptarse a sus necesidades gracias a su organización modular. Sin embargo, debe ser consciente de que esto debe hacerse respetando las convenciones SGML/XML y que podría introducir incompatibilidades.
  Si DocBook se utiliza junto con las hojas de estilos modulares de Norman Walsh, también es posible personalizar la forma en que un archivo DocBook puede imprimirse o publicarse en línea.
• DocBook es exhaustivo
  El gran número de etiquetas definidas en DocBook garantiza que pueda adaptarse a una amplia gama de situaciones y expectativas de procesamiento.
  Esto lo hace un poco difícil de aprender, pero es posible redactar documentación conociendo solo un conjunto limitado de etiquetas y consultando la documentación de referencia cuando sea necesario.

Comments