L'élément prereq

L'élément pré-requis (prereq) décrit le statut ou la situation qui doit être mise en place avant qu'une tâche procédurale ne commence. Il peut contenir des références croisées pour les rubriques de tâches pré-requises.

L'élément pré-requis optionnel (prereq) dans les rubriques task est utilisé pour décrire ce que l'utilisateur a besoin de savoir ou de faire avant de commencer la tâche.

Pendant la sortie vers un format de lecture, l'élément pré-requis doit être étiqueté de façon à ce que le lecteur puisse identifier l'information comme étant pré-requise.

L'élément prereq doit correspondre à une ou plusieurs phrases complètes.

Normalement, vous n'aurez besoin que d'un bloc d'information de pré-requis, et vous ne devez pas imbriquer un élément paragraphe (p), isolé et redondant dans l'élément prereq. Cependant, si vous avez besoin d'inclure plus d'un bloc, vous aurez besoin d’emboîter les paragraphes au sein de l'élément prereq.

Par exemple, un bloc simple de pré-requis doit être structuré comme suit :

<prereq>Assurez-vous...</prereq>

alors qu'un long pré-requis, avec plus d'un bloc, doit être structuré comme suit :

<prereq>
  <p>Assurez-vous...</p>
  <p>Préparez...</p>
</prereq>

Si une rubrique contient des tâches pré-requises, elles doivent être ajoutées comme liens dans la section liens apparentés en bas de la rubrique, avec l'attribut importance de l'élément lien paramétré sur required. Les liens seront donc placés sous le bloc des pré-requis pendant le traitement vers un format de lecture.

L'exemple ci-dessous montre une présentation typique d'un lien requis de la section related-links dans la rubrique de type task traitée en XHTML.

Capture d'écran montrant une sortie XHTML de liens apparentés requis dans la section pré-requis — Figure 1: Document de sortie XHTML typique de *related links* avec un attribut *importance* paramétré sur required