Insérer des références croisées vers une étape

Les références croisées vers des étapes sont créées grâce à l'élément xref ayant un attribut type de valeur li.

Lorsque vous renvoyez le lecteur vers une étape de tâche, évitez de coder le numéro de l'étape en dur. Selon les contextes (comme lorsque le contenu est filtré ou transclus), le numéro de l'étape peut être différent. Par ailleurs, si une étape est ajoutée, la référence codée en dur ne sera pas nécessairement mise à jour.

Vous devez toujours utiliser l'élément xref pour insérer des références croisées vers des étapes, avec un attribut type ayant pour valeur li. (li est l'ancêtre de l'élément step.)

Vous pouvez uniquement référencer une étape grâce à son attribut id. Avant de pouvoir insérer une référence croisée vers cette étape, vous devez donc vous assurer que l'attribut id de l'élément step possède bien une valeur.

L'exemple suivant indique comment insérer une référence croisée vers le numéro d'une étape. N'incluez pas de texte dans l'élément xref, sinon, ce texte sera publié (dans la plupart des outils de publication), mais pas le numéro de l'étape.

<task id="keypad1">
... 
<step id="a"> 
	<cmd>..</cmd> 
	</step> 
	<step> 
	<cmd>Répétez cette étape<xref href="#keypad1/a" type="li" /> jusqu'à ce que la lumière rouge s'allume.</cmd> 
	</step> 
...
</task>

La méthode pour insérer une référence croisée vers une étape d'une autre rubrique est quasi-identique, à la différence que l'attribut href inclura le nom de fichier de l'autre rubrique. Vous devez également donner la valeur li à l'attribut type.

<cmd>Étape concernant <xref href="c_panel.dita#keypad2/b" type="li" />la procédure de récupération du code PIN.</cmd>