Arquitectura de tipificación de información de Darwin

La especificación de la Arquitectura de tipificación de información de Darwin ( 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 los tipos de documentos. ^[1] Es un estándar abierto ^[2] que está definido y mantenido por el Comité Técnico DITA de OASIS . ^[3]

El nombre deriva de los siguientes componentes:

• Darwin: utiliza los principios de especialización y herencia , lo que en cierto modo es análogo al concepto de adaptación evolutiva del naturalista Charles Darwin .
• Tipificación de la información: esto significa que cada tema tiene un objetivo principal definido (procedimiento, entrada de glosario, información de resolución de problemas) y una estructura.
• Arquitectura: DITA es un conjunto extensible de estructuras. ^[4]

Los temas son la base para la reutilización de contenido ^[5] y pueden reutilizarse en varias publicaciones. Los fragmentos de contenido dentro de los temas pueden reutilizarse mediante el uso de referencias de contenido ( conref o conkeyref ), un mecanismo de transclusión . ^[6]

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 de 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 llevar a cabo una tarea. Enumera una serie de pasos que los usuarios siguen para producir un resultado previsto. Los pasos están contenidos en un elemento taskbody, que es una especialización del elemento body genérico. El elemento steps 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 generalmente contiene material detallado y factual.
• Un tema de entrada de glosario se utiliza para definir un único sentido de un término determinado. Además de identificar el término y proporcionar una definición, este tipo de tema también puede contener información terminológica básica, junto con acrónimos o expansiones de acrónimos que puedan aplicarse al término.
• El tema Solución de problemas describe una condición que el lector puede querer corregir, seguido de una o más descripciones de su causa y soluciones sugeridas.

Un mapa DITA es un contenedor de temas que se utiliza para transformar una colección de contenido en una publicación. Proporciona a los temas una secuencia y una estructura. Un mapa puede incluir tablas de relaciones (reltables) que definen hipervínculos entre temas. ^[7] Los mapas pueden estar anidados: pueden hacer referencia a temas u otros mapas, y pueden contener una variedad de tipos de contenido y 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 aplicar estilo al contenido en función de 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]

DITA permite agregar nuevos elementos y atributos a través de la especialización de los elementos y atributos básicos de DITA. A través de la especialización, DITA puede incorporar 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 semiconductores , se estandarizan a través de 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 especializar DITA definiendo estructuras de información específicas y aun así usar herramientas estándar para trabajar con ellas. La capacidad de definir arquitecturas de información específicas de la empresa permite a las empresas usar DITA para enriquecer el contenido con metadatos que sean significativos para ellas y para aplicar reglas específicas de la empresa sobre la estructura de los documentos. ^[6]

El contenido de DITA se crea en forma de temas, cada uno de los cuales es un archivo XML individual. Normalmente, 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 estructurarse de manera que se parezca a la estructura del archivo en el que se encuentra. ^{[11] [12] [13]}

Los mapas y los documentos temáticos DITA son archivos XML . Al igual que con HTML , las imágenes, los archivos de vídeo u otros archivos que deben aparecer en el resultado se insertan mediante referencia. Se puede utilizar cualquier editor XML o incluso un editor de texto para escribir contenido DITA, según el nivel de soporte necesario durante la creación. Las ayudas para la creación que ofrecen los editores especializados incluyen la representación de vista previa WYSIWYG , la validación y la integración con un procesador DITA, como DITA-OT o ditac.

DITA está diseñado como una arquitectura de extremo a extremo. Además de indicar qué elementos, atributos y reglas forman parte del lenguaje DITA, la especificación DITA incluye reglas para publicar contenido DITA en HTML, ayuda en línea, formato impreso, plataforma de distribución de contenido y otros formatos.

Por ejemplo, la especificación DITA indica que si el atributo conref del elemento A contiene una ruta al elemento B , el contenido del elemento B se mostrará 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 .

DITA ofrece soporte para la traducción a través del grupo de atributos de localización. Los atributos de los elementos 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 del índice y algunos términos que se inyectan al publicar en el 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 "Using XLIFF to Translate DITA Projects" publicado por el DITA Adoption TC en OASIS. ^[17]

Esta sección está en formato de lista , pero puede leerse mejor en prosa . Puede ayudar convirtiendo esta sección, si es necesario. Hay ayuda para editarla . ( Junio ​​de 2017 )

El estándar DITA es mantenido por OASIS. La última versión (actual) es la 1.3, aprobada en diciembre de 2015. En junio de 2018 se aprobó un documento de erratas para DITA 1.3. ^[18]

• Marzo de 2001 Introducción por parte de IBM de los archivos de gramática DTD y XML Schema básicos y material introductorio ^[19]
• Abril de 2004 Se forma el Comité Técnico DITA de OASIS ^[20]
• Febrero de 2005 IBM aporta el proyecto original DITA Open Toolkit a SourceForge; aunque a menudo se confunde con el estándar DITA, DITA-OT no está afiliado al Comité Técnico DITA de OASIS ^[21]
• Junio ​​de 2005 DITA v1.0 aprobado como estándar OASIS
• Agosto de 2007 OASIS aprueba DITA V1.1; sus principales características incluyen:
  • Especialización en mapas de libros
  • Definición formal de la sintaxis DITAVAL para el filtrado de contenidos
• Diciembre de 2010 DITA V1.2 es aprobado por OASIS; sus principales características incluyen:
  • Enlace indirecto 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 valores controlados/taxonomías (especialización en esquemas temáticos)
• 17 de diciembre de 2015, OASIS aprueba DITA V1.3; las principales características incluyen:
  • La especificación ahora se entrega en tres paquetes: Base, ^[22] Contenido técnico, ^[23] y Todo incluido (con aprendizaje y capacitación) ^[24]
  • Nuevo tipo de tema de resolución de problemas
  • Capacidad de utilizar claves con ámbito
  • Nuevos dominios para soportar MathML, ecuaciones y SVG
  • Agrega la sintaxis XML Relax NG como gramática normativa para DITA
• 25 de octubre de 2016, OASIS aprueba la versión 01 de DITA V1.3 ^[25]
• 19 de junio de 2018, OASIS aprueba la versión 02 de DITA V1.3 ^[26]

<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map id= "map" xml :lang= "en" > <topicref format= "dita" href= "sample.dita" navtitle= "Muestra" type= "topic" /> </map>       

<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> <topic xml:lang= "en" id= "sample" > <title> Muestra </title> <body> <p> ¡Hola mundo! </p> </body> </topic>       

<?xml versión="1.0" codificación="utf-8"?> <val> <prop att= "audiencia" val= "novato" action= "include" /> <prop att= "audiencia" val= "experto " acción= "excluir" /> </val>          

Ejemplo de texto condicionalizado:

<p>  Esta  es  información  útil  para  todos  los públicos. </p> <p audience= "novice" > Esta es información útil para un público novato . </p> <p audience= "expert" > Esta es información útil para un público experto . </p>                   

• Comparación de lenguajes de marcado de documentos
• Lista de lenguajes de marcado de documentos

• Sitio web oficial del Consorcio OASIS
• Especificaciones de DITA 1.3
• Sitio web oficial de DITA Open Toolkit