Introduction

La conception de l'architecture de typage de l'information Darwin (DITA) se fonde sur la dérivation de types d'information multiples, ou de types de thème, à partir d'un thème générique commun. Cette référence de langage décrit les éléments qui composent la définition DTD du type topic et ses descendants initiaux d'information typée : concept, reference, task et glossentry. Elle décrit également la définition DTD de la carte DITA et sa spécialisation courante (bookmap) ainsi que divers domaines DITA fondés sur des thèmes et des cartes.

Cette spécification décrit les détails spécifiques de chaque élément dans le langage DITA OASIS. La spécification séparée de l'architecture DITA contient des informations détaillées sur la spécialisation DITA, quand utiliser chaque type de thème, comment interagissent les thèmes et les cartes, l'explication de comportements complexes tels que l'attribut conref et le traitement conditionnel, et beaucoup d'autres pratiques exemplaires pour travailler avec DITA.

Les éléments qui constituent la conception DITA représentent un ensemble de différentes matières de création, chacune regroupé dans son chapitre propre. Les sections majeures comprennent :

Les composants principaux d'un thème, d'un concept, d'une référence, d'une tâche, d'un document ;
Les composants principaux d'un document d'entrée de glossaire (glossentry) — nouveau dans DITA 1.1 ;
Les éléments communs disponibles pour créer du contenu dans le corps d'un thème ;
Les éléments qui composent les deux types de table dans DITA ;
Les éléments contenus dans le prologue (<prolog>) d'un thème (beaucoup apparaissent aussi dans l'élément <topicmeta> dans une carte) ;
Les éléments contenus dans la partie des liens apparentés d'un thème ;
Les éléments qui apparaissent dans plusieurs contextes mais n'entrent pas dans des catégories spécifiques ;
Les éléments qui sont disponibles pour spécialiser encore plus ;
Les spécialisations de domaine des éléments de thème qui représentent des domaines (subject domains) différents ;
Les éléments qui composent une carte DITA, suivis de la spécialisation de domaine mapgroup ;
La spécialisation bookmap — nouveau dans DITA 1.1 ;
Le domaine xNAL pour décrire les coordonnées des auteurs (fondé sur le standard extensible Name and Address Language) — nouveau également dans DITA 1.1 ;
La définition DTD du type de document ditaval pour marquer et filtrer le contenu (formalisée pour DITA 1.1) ;
et les descriptions référencées communes.

Outre les thèmes d'entrée de glossaire, la spécialisation bookmap, le domaine xNAL et le format ditaval formalisé, DITA 1.1 inclut également un nouveau domaine d'indexation, des éclaircissements sur les éléments <image> et <object>, les nouveaux attributs props et base pour la spécialisation des attributs et plusieurs autres éléments :

<abstract>
<data> et <data-about>
<foreign> et <unknown>
<index-base>

DITA 1.1 inclut un nouvel attribut dir pour faciliter la localisation. Cet attribut, avec d'autres attributs de localisation, est désormais disponible sur presque tous les éléments DITA. De plus, les attributs communs metadata et id qui étaient disponibles sur plusieurs éléments dans DITA 1.0 le sont sur pratiquement tous les éléments.

Terminologie

Les mots-clés « doit », « ne doit pas », « obligatoire », « devra », « ne devra pas », « devrait », « ne devrait pas », « recommandé », « peut » et « optionnel » doivent s'interpréter comme décrit dans le document [RFC2119].

Références normatives

[RFC2119]: S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, http://www.ietf.org/rfc/rfc2119.txt, IETF RFC 2119, March 1997.

Section suivante 2. Éléments de thème

Retour au sommaire.