3.1. concept

L'élément <concept> est l'élément de niveau supérieur d'un thème qui répond à la question « Qu'est-ce que c'est… ? » Les concepts fournissent l'information de base que doivent connaître les utilisateurs pour bien travailler avec un produit ou une interface. Un concept est souvent une définition étendue d'une abstraction majeure telle qu'un processus ou une fonction. Il peut également avoir un exemple ou un graphique, mais la structure d'un concept est généralement assez simple.

Exemple

<concept id="concept">
 <title>Introduction to Bird Calling</title>
 <shortdesc>If you wish to attract more birds to your Acme Bird Feeder,
learn the art of bird calling. Bird calling is an efficient way
to alert more birds to the presence of your bird feeder.</shortdesc>
 <conbody>
   <p>Bird calling requires learning:</p>
   <ul>
    <li>Popular and classical bird songs</li>
    <li>How to whistle like a bird</li>
   </ul>
 </conbody>
</concept>

Contient :

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

Contenu par :

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

Héritage :

- topic/topic concept/concept

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