Noms d'éléments similaires

DITA contient des éléments sémantiques dont les noms sont quasiment identiques à d'autres éléments, tels que keyword et kwd. Ces éléments sont censés être utilisés dans différents scénarios de rédaction.

DITA comprend un élément keyword et un élément kwd, ainsi qu'un élément var et un élément varname.

Ces duplications s'expliquent car les éléments de base DITA sont organisés selon différents domaines :

programmation
logiciel
interface utilisateur
typographie (ou mise en évidence)

L'existence de différents domaines facilite l'identification des éléments selon différents types de documentation. Des concepts similaires (tels que les mots-clés) ont souvent des significations sémantiques différentes selon la documentation. Les différences entre ces éléments sont expliquées dans le tableau ci-dessous, d'après l'ouvrage Spécification DITA (DITA Language Reference) :


Élément	Domaine	Signification
var	Programmation	Dans un diagramme syntaxique, l'élément var définit une variable dans laquelle l'utilisateur doit insérer du contenu, tel que son nom d'utilisateur et son mot de passe.
varname	Logiciel	L'élément varname définit une variable qui doit être fournie par une application logicielle. L'élément varname ressemble beaucoup à l'élément var, à la différence que le premier est utilisé en dehors des diagrammes syntaxiques.
kwd	Programmation	L'élément kwd définit un mot-clé dans un diagramme syntaxique. Le mot-clé doit être saisi par l'utilisateur ou défini par l'application, comme indiqué expressément dans la définition de la syntaxe.
keyword	Pas de domaine particulier ; utilisé dans le corps de texte ou dans le prologue.	Les éléments keyword (mots-clés) représentent un mot ou une phrase ayant une signification spécifique dans un domaine particulier. En général, les éléments keyword ne sont pas associés à une sémantique ou à un traitement spécifique. Cependant, ils peuvent être utiles pour organiser du contenu à réutiliser ou des traitements spécifiques. Les mots-clés décrivant le contenu des rubriques sont généralement utilisés pour effectuer des recherches, des extractions de données et des classifications.