2.1. topic

L'élément <topic> est l'élément DITA de niveau supérieur d'un thème ou d'un article à sujet unique. D'autres éléments DITA de niveau supérieur ont un contenu plus spécifique : <concept>, <task>, <reference> et <glossary>.

Pour gérer les applications compatibles avec les espaces de noms, les définitions DTD et schémas DITA fournissent les déclarations d'espace de noms suivantes pour les thèmes et les éléments de niveau thème dérivés de <topic> :

ditaarch:DITAArchVersion="1.0" 
xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" 

Dans les définitions DTD, le préfixe « ditaarch » est paramétré en vue d'une spécialisation future.

Exemple

<topic id="topic">
 <title>Some little topic</title>
 <body>
  <p>Here's a <b><i>cute</i></b>,
  <b>little</b> topic.</p>
  <ul>
   <li>Some item</li>
   <li>Another item</li>
  </ul>
 </body>
</topic>

Contient :

Doctype Modèle de contenu
ditabase ( ( title) puis ( titlealts) (optionnel) puis ( shortdesc ou abstract) (optionnel) puis ( prolog) (optionnel) puis ( body) (optionnel) puis ( related-links) (optionnel) puis ( topic ou concept ou task ou reference ou glossentry) (un nombre quelconque) )
topic ( ( title) puis ( titlealts) (optionnel) puis ( shortdesc ou abstract) (optionnel) puis ( prolog) (optionnel) puis ( body) (optionnel) puis ( related-links) (optionnel) puis ( topic) (un nombre quelconque) )
task ( ( title) puis ( titlealts) (optionnel) puis ( shortdesc ou abstract) (optionnel) puis ( prolog) (optionnel) puis ( body) (optionnel) puis ( related-links) (optionnel) puis ( topic) (un nombre quelconque) )
reference ( ( title) puis ( titlealts) (optionnel) puis ( shortdesc ou abstract) (optionnel) puis ( prolog) (optionnel) puis ( body) (optionnel) puis ( related-links) (optionnel) puis ( topic) (un nombre quelconque) )
concept ( ( title) puis ( titlealts) (optionnel) puis ( shortdesc ou abstract) (optionnel) puis ( prolog) (optionnel) puis ( body) (optionnel) puis ( related-links) (optionnel) puis ( topic) (un nombre quelconque) )
glossary ( ( title) puis ( titlealts) (optionnel) puis ( shortdesc ou abstract) (optionnel) puis ( prolog) (optionnel) puis ( body) (optionnel) puis ( related-links) (optionnel) puis ( topic) (un nombre quelconque) )

Contenu par :

Doctype Parents
ditabase dita, topic, concept, task, reference
topic topic
task topic
concept topic
reference topic
glossary topic, concept

Héritage :

- topic/topic

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
id Cet identificateur permet aux éléments <topicref> de référencer de manière unique les thèmes dans les cartes DITA. ID   oui
conref Cet attribut sert à référencer un identificateur sur un thème réutilisable. Cf. la section 25.10.1. L'attribut conref pour des exemples et des détails à propos de la syntaxe. CDATA #IMPLIED non
xmlns:ditaarch Déclare l'espace de noms DITA par défaut. CDATA #FIXED "http://dita.oasis-open.org/architecture/2005/"  
DITAArchVersion Désigne la version de l'architecture en vigueur. CDATA "1.1" (dépend de la version ; ira en augmentant) non
domains Indique les domaines spécialisés inclus dans la définition DTD ou le schéma. CDATA (topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d) non
%select-atts; (props, base, platform, product, audience, otherprops, importance, rev, status) Un ensemble d'attributs liés, décrit à la section 25.5. %select-atts; entité paramètre sans objet pour une entité paramètre sans objet
%localization-atts; (translate, xml:lang, dir) Un ensemble d'attributs liés, décrit à la section 25.6. %localization-atts;. entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs