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:
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 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]
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]
<?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>