Caution = ( Title?, (%admon.mix;)+ ) Important = ( Title?, (%admon.mix;)+ ) Note = ( Title?, (%admon.mix;)+ ) Tip = ( Title?, (%admon.mix;)+ ) Warning = ( Title?, (%admon.mix;)+ ) |
Éléments : Caution, Important, Note, Tip, Warning.
DocBook permet d'utiliser différents types d'avertissements. Tous sont constitués d'un titre (Title), facultatif, suivi d'éléments de type bloc.
Si le titre n'est pas utilisé, un titre pourra être généré automatiquement, relativement à l'élément utilisé. Une icône ou un autre symbole pourra aussi être utilisé pour mettre le passage en valeur.
DocBook n'impose pas de sémantique à ces divers avertissements. Ils pouront par exemple être utilisés dans les cas suivants :
Met le lecteur en garde.
Un passage de texte important.
Une note dans le texte.
Un conseil au lecteur.
Demande l'attention du lecteur.