Gestión de contenidos DITA y XML

Preguntas frecuentes

Gestión de contenidos DITA y XML

Gestión experta de contenido DITA y XML para publicación multilingüe. Autoría estructurada, redacción por temas y soluciones para la reutilización de contenido.


¿Qué es el estándar DITA??

DITA (Darwin Information Typing Architecture) es una arquitectura basada en XML para la creación, producción y distribución de información técnica. IBM desarrolló la arquitectura y su correspondiente DTD y esquema W3C.

El nombre completo de la arquitectura combina estas explicaciones:
Darwin: utiliza los principios de especialización e herencia
Information Typing: aprovecha la semántica de los temas (concepto, tarea, referencia) y del contenido (mensajes, frases tipificadas, tablas semánticas)
Architecture: proporciona margen vertical (nuevas aplicaciones) y extensión lateral (especialización en nuevos tipos) para la información

A diferencia de los enfoques orientados al libro que se basan en capítulos y páginas, DITA utiliza temas: fragmentos pequeños de información que pueden reutilizarse fácilmente en diversos contextos y formatos de salida. DITA también incluye compatibilidad de extensibilidad integrada, lo que significa que puede personalizar definiciones de tipos de documentos (o DTDs) sin comprometer la compatibilidad con aplicaciones y procesos existentes. Por estas y otras razones, DITA va más allá de cualquier enfoque anterior para ayudarle a superar las barreras en la adopción de XML, maximizar la reutilización de contenidos y reducir redundancias de información.

DITA especifica varios tipos de temas, como Tarea, Concepto y Referencia. Dentro de DITA, un tema de tipo Tarea está destinado a procedimientos que describen cómo realizar una tarea; enumera una serie de pasos que los usuarios siguen para obtener un resultado especificado; identifica quién hace qué, cuándo, dónde y cómo. Un tema de Referencia se utiliza para temas que describen sintaxis de comandos, instrucciones de programación y otro material de referencia; normalmente material detallado y factual.

Leer más

¿Qué es el estándar DocBook??

DocBook es un lenguaje de marcado para documentación técnica, concebido originalmente para la autoría de documentos técnicos relacionados con hardware y software informático, aunque puede utilizarse para cualquier otro tipo de documentación.

Uno de los principales beneficios de DocBook es que permite a sus usuarios crear contenido de documentos en una forma neutral respecto a la presentación, que captura la estructura lógica del contenido; ese contenido puede entonces publicarse en diversos formatos, incluyendo HTML, PDF, páginas man y HTML Help, sin que los usuarios tengan que realizar cambios en la fuente.

Leer más

¿Qué es DocBook??

DocBook proporciona un sistema para escribir documentos estructurados usando SGML o XML. Es particularmente adecuado para libros y artículos sobre hardware y software informático, aunque no se limita a ellos.
En resumen, DocBook es una DTD fácil de entender y ampliamente utilizada. Decenas de organizaciones utilizan DocBook para millones de páginas de documentación, en diversos formatos impresos y en línea, en todo el mundo.

Leer más

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.

Leer más

¿Qué es la gestión de contenidos XML??

Un sistema de gestión de contenidos XML puede transformar su contenido para dirigirse a diferentes medios y dispositivos, incluyendo la web, CD, presentaciones offline, catálogos impresos, dispositivos PDA y teléfonos inalámbricos. Al crear contenido una sola vez y reutilizarlo en diferentes medios, garantiza la coherencia y relevancia del mensaje en todos los canales de comunicación. De esta manera, la gestión de contenidos XML permite a las empresas participar de forma más efectiva en el comercio electrónico a través de la reutilización de contenido, la separación del contenido de la presentación, el intercambio independiente de plataforma, la integración sin complicaciones y la publicación multicanal.

Leer más

¿Qué es la gestión de contenidos web??

La gestión de contenidos web permite que los usuarios empresariales y el personal no técnico mantengan y desarrollen un sitio web separando su estructura y contenido del diseño. Esto sustituye los métodos tradicionales que requieren conocimientos de HTML y técnicas de diseño, y con reglas a nivel de sistema, garantiza que aspectos como la navegación y los diseños de página se gestionen de forma coherente. Esto le permite controlar el sitio web sin preocuparse por romper el estilo corporativo, cómo añadir una nueva sección al menú o qué costes adicionales podrían conllevar sus cambios, y en su lugar concentrarse en utilizar el sitio web para comunicarse de forma más efectiva con clientes, clientes potenciales y socios.

Leer más