Titres et en-têtes

Les titres sont utilisés dans un certain nombre de structures de balisage dans DITA. Les titres sont un mélange de contenu et de métadonnées. Le balisage des titres doit être le plus simple possible, et les contournements qui permettent d'exécuter le formatage ne sont pas recommandés.

Un titre est différent d'un en-tête. On considère qu'un titre fait partie du contenu (et est typiquement rendu dans le format de sortie comme un en-tête). Il joue également un rôle en tant que conteneur de métadonnées. Par exemple, le titre peut être utilisé comme base textuelle d'un lien, en dehors du contexte de sa rubrique. Dans ce cas, une balisage de note de bas de page (fn) ou de référence croisée (xref) n'auraient aucun sens.

Évitez d'utiliser un balisage de niveau phrase dans les titres, surtout lorsque le but est d'obtenir une bonne présentation. Par exemple, n'utilisez pas les éléments de note de bas de page (fn) dans les titres, puisque la présentation a tendance à être imprévisible lorsqu'un titre s'affiche dans une fenêtre pop-up .

Si un élément title ne permet pas un type particulier d'élément de niveau phrase, n'inventez pas de contournements pour insérer de tels éléments.

Par exemple, il ne peut y avoir d'élément cite dans l'élément title, en revanche, celui-ci peut contenir l'élément de phrase (ph). Cet élément de phrase peut lui-même inclure l'élément cite. Donc même si le code <title>C'est la vie<ph> <cite>Ned Kelly</cite></ph></title> est techniquement correct, il constitue cependant un contournement, et ne devrait pas être utilisé.