Convention de nommage des attributs et éléments spécialisés
Les attributs et les éléments spécialisés doivent être nommés selon la méthode CamelCase mais avec la première lettre en minuscule.
Lorsque le schéma DITA est spécialisé afin de correspondre à une documentation particulière, le créateur de la spécialisation (le spécialiseur) choisit des noms pour les éléments et les attributs.
Le créateur de spécialisation peut choisir les conventions de nommages suivantes, qui sont toutes techniquement valides : tout en minuscules (nombouton), des minuscules avec un trait d'union (nom-bouton), la méthode CamelCase (NomBouton), des minuscules puis CamelCase (nomBouton), etc. Toutefois, la méthode CamelCase avec la première lettre en minuscule est la convention la plus courante.
- d'ajouter un préfixe au nom de l'élément afin de mieux l'identifier ;
- de nommer les éléments et attributs de la façon suivante : préfixe en minuscules puis CamelCase.
Dans l'exemple précédent, le nommage recommandé serait donc hwNomBouton.
Vous ne devez pas utiliser des noms qui sont déjà présents dans le modèle de contenu DITA.
L'utilisation d'un préfixe vous permettra de reconnaître les éléments spécialisés plus facilement et d'éviter toute possibilité de conflit de nom avec ceux de la base DITA.