La especificación Darwin Information Typing Architecture ( DITA ) define un conjunto de tipos de documentos para crear y organizar información orientada a temas, así como un conjunto de mecanismos para combinar, ampliar y restringir tipos de documentos. [1] Es un estándar abierto [2] que es definido y mantenido por el Comité Técnico de OASIS DITA. [3]
| Arquitectura de tipificación de información de Darwin | |
| Estado | Publicado |
|---|---|
| Publicado por primera vez | Junio de 2005 |
| Ultima versión | DITA 1.3 Part0: Descripción general Part1: Base Edition Part2: Technical Content Edition Part3: All-Inclusive Edition 19 de junio de 2018 |
| Organización | OASIS |
| Comité | DITA TC |
| Editores | Robert D. Anderson y Kristen James Eberlein |
| Estándares básicos | XML , HTML |
| Dominio | Escritura de información |
| Abreviatura | DITA |
| Sitio web | docs |
El nombre deriva de los siguientes componentes:
- Darwin: utiliza los principios de especialización y herencia , que en cierto modo es análogo al concepto de adaptación evolutiva del naturalista Charles Darwin .
- Tipificación de información: lo que significa que cada tema tiene un objetivo principal definido (procedimiento, entrada del glosario, información de resolución de problemas) y estructura.
- Arquitectura: DITA es un conjunto extensible de estructuras. [4]
Características y limitaciones
Reutilización de contenido
Los temas son la base para la reutilización de contenido, [5] y se pueden reutilizar en múltiples publicaciones. Los fragmentos de contenido dentro de los temas se pueden reutilizar mediante el uso de referencias de contenido ( conref o conkeyref ), un mecanismo de transclusión . [6]
Mecanografía de información
La última versión de DITA (DITA 1.3) incluye cinco tipos de temas especializados: Tarea , Concepto , Referencia , Entrada de glosario y Solución de problemas . Cada uno de estos cinco tipos de temas es una especialización de un tipo de tema genérico , que contiene un elemento de título, un elemento de prólogo para metadatos y un elemento de cuerpo. El elemento del cuerpo contiene elementos de párrafo, tabla y lista, similares a HTML .
- Un tema de Tarea está destinado a un procedimiento que describe cómo realizar una tarea. Enumera una serie de pasos que siguen los usuarios para producir un resultado esperado. Los pasos están contenidos en un elemento de cuerpo de tareas, que es una especialización del elemento de cuerpo genérico. El elemento de pasos es una especialización de un elemento de lista ordenada.
- La información conceptual es más objetiva y contiene definiciones, reglas y pautas.
- Un tema de referencia es para temas que describen la sintaxis de comandos, instrucciones de programación y otro material de referencia y, por lo general, contiene material fáctico detallado.
- Un tema de Entrada de glosario se utiliza para definir un sentido único de un término determinado. Además de identificar el término y proporcionar una definición, este tipo de tema también puede tener información de terminología básica, junto con cualquier acrónimo o expansión de acrónimo que pueda aplicarse al término.
- El tema Solución de problemas describe una condición que el lector puede querer corregir, seguida de una o más descripciones de su causa y soluciones sugeridas.
Mapas
Un mapa DITA es un contenedor de temas que se utilizan para transformar una colección de contenido en una publicación. Da la secuencia y estructura de los temas. Un mapa puede incluir tablas de relaciones (tablas rel) que definen hipervínculos entre temas. [7] Los mapas se pueden anidar. Los mapas pueden hacer referencia a temas u otros mapas, y pueden contener una variedad de tipos de contenido y metadatos.
Metadatos
DITA incluye una gran cantidad de elementos y atributos de metadatos , tanto a nivel de tema como dentro de los elementos. [8] El texto condicional permite filtrar o diseñar contenido según los atributos de audiencia, plataforma, producto y otras propiedades. El perfil de procesamiento condicional ( archivo .ditaval ) se utiliza para identificar qué valores se utilizarán para el procesamiento condicional. [9]
Especialización
DITA permite agregar nuevos elementos y atributos a través de la especialización de los elementos y atributos base de DITA. A través de la especialización, DITA puede acomodar nuevos tipos de temas, tipos de elementos y atributos según sea necesario para industrias o empresas específicas. Las especializaciones de DITA para industrias específicas, como la industria de los semiconductores , se estandarizan a través de los comités o subcomités técnicos de OASIS . Muchas organizaciones que utilizan DITA también desarrollan sus propias especializaciones.
La extensibilidad de DITA permite a las organizaciones especializarse en DITA mediante la definición de estructuras de información específicas y seguir utilizando herramientas estándar para trabajar con ellas. La capacidad de definir arquitecturas de información específicas de la empresa permite a las empresas utilizar DITA para enriquecer el contenido con metadatos que sean significativos para ellas y hacer cumplir las reglas específicas de la empresa sobre la estructura del documento. [6]
Orientación temática
El contenido de DITA se crea como temas, cada uno de los cuales es un archivo XML individual. Por lo general, cada tema cubre un tema específico con un propósito singular, por ejemplo, un tema conceptual que proporciona una descripción general o un tema de procedimiento que explica cómo realizar una tarea. [10] El contenido debe estar estructurado para parecerse a la estructura del archivo en el que está incluido. [11] [12] [13]
Creando contenido en DITA
Los documentos de mapas y temas de DITA son archivos XML . Al igual que con HTML , las imágenes, los archivos de video u otros archivos que deben aparecer en la salida se insertan mediante referencia. Se puede usar cualquier editor XML o incluso editor de texto para escribir contenido DITA, dependiendo del nivel de soporte requerido durante la creación. Las ayudas a la autoría presentadas en editores especializados incluyen la representación, validación e integración de vista previa WYSIWYG con un procesador DITA, como DITA-OT o ditac .
Publicar contenido escrito en DITA
DITA está diseñado como una arquitectura de extremo a extremo. Además de indicar qué elementos, atributos y reglas son parte del lenguaje DITA, la especificación DITA incluye reglas para publicar contenido DITA en HTML, ayuda en línea, impresión, plataforma de entrega de contenido y otros formatos.
Por ejemplo, la especificación DITA indica que si el conref atributo de elemento A contiene una ruta al elemento de B , el contenido del elemento B se mostrarán en la ubicación del elemento A . Las soluciones de publicación compatibles con DITA, conocidas como procesadores DITA, deben manejar el atributo conref de acuerdo con el comportamiento especificado. También existen reglas para procesar otras características enriquecidas como texto condicional , marcadores de índice y enlaces de tema a tema. Las aplicaciones que transforman el contenido DITA en otros formatos y cumplen con los requisitos de la especificación DITA para interpretar el marcado DITA se conocen como procesadores DITA .
Localización
DITA proporciona soporte para la traducción a través del grupo de atributos de localización. Los atributos del elemento se pueden configurar para indicar si el contenido del elemento debe traducirse. Se puede especificar el idioma del contenido del elemento, así como la dirección de escritura , el filtrado de índices y algunos términos que se inyectan al publicar al formato final. [14] Un proyecto DITA se puede convertir a un archivo XLIFF y volver a sus mapas y temas originales, utilizando la herramienta DITA-XLIFF Roundtrip Tool para DITA-OT [15] [16] y herramientas de traducción asistida por computadora (CAT), como Swordfish Translation Editor o Fluenta DITA Translation Manager , una herramienta diseñada para implementar el flujo de trabajo de traducción sugerido por el artículo "Uso de XLIFF para traducir proyectos DITA" publicado por DITA Adoption TC en OASIS. [17]
Historia
OASIS mantiene el estándar DITA. La última versión (actual) es 1.3, aprobada en diciembre de 2015. En octubre de 2016 se aprobó un documento de erratas para DITA 1.3. [18]
- Marzo de 2001 Introducción por IBM de los archivos de gramática y el material introductorio de DTD y XML Schema principales [19]
- Abril de 2004 Se crea el Comité Técnico de OASIS DITA [20]
- Febrero de 2005 IBM aporta el proyecto original DITA Open Toolkit a SourceForge; aunque se confunde regularmente con el estándar DITA, DITA-OT no está afiliado al Comité Técnico de OASIS DITA [21]
- Junio de 2005 DITA v1.0 aprobado como estándar OASIS
- Agosto de 2007 DITA V1.1 es aprobado por OASIS; las principales características incluyen:
- Especialización en mapas de libros
- Definición formal de la sintaxis DITAVAL para filtrado de contenido
- Diciembre de 2010 DITA V1.2 es aprobado por OASIS; las principales características incluyen:
- Vinculación indirecta con claves
- Nuevas funciones de reutilización de contenido
- Soporte de glosario mejorado, incluidos acrónimos
- Nuevas especializaciones industriales (formación, maquinaria)
- Nuevo soporte para taxonomías / valores controlados (especialización en el esquema temático)
- 17 de diciembre de 2015, OASIS aprueba DITA V1.3; las principales características incluyen:
- Las especificaciones ahora se entregan en tres paquetes: Base, [22] Contenido técnico, [23] y Todo incluido (con aprendizaje y capacitación) [24]
- Nuevo tipo de tema de solución de problemas
- Posibilidad de utilizar claves de ámbito
- Nuevos dominios para admitir MathML, ecuaciones y SVG
- Agrega la sintaxis Relax NG XML como gramática normativa para DITA
- 25 de octubre de 2016, OASIS aprueba DITA V1.3 Errata 01
Muestras de código
Ejemplo de archivo Ditamap (tabla de contenido)
xml version = "1.0" encoding = "utf-8"?> id = "map" xml : lang = "en" > Hola mundo (tema DTD)
xml version = "1.0" encoding = "utf-8"?>