L'attribut copy-to

L'attribut copy-to de l'élément topicref est utilisé dans le cas peu commun où vous avez besoin de créer deux copies d'une même rubrique et de lier séparément chaque copie de la rubrique de sortie. La valeur de l'attribut correspond au nom de fichier de la copie.

Vous pouvez utiliser l'attribut copy-to de l'élément topicref de la carte DITA lorsque vous souhaitez que le nom du fichier de sortie soit différent du nom qui aurait été automatiquement généré, ou lorsque vous souhaitez générer au moins deux copies identiques ou quasi-identiques de la même rubrique. Les copies de la rubrique d'origine peuvent se voir générer des descriptions et textes de liens différents.

La valeur définie dans l'attribut copy-to est le nom de la copie, avec une extension .dita. Si vous nommez le fichier ej25_special.dita et que vous le générez en XHTML, le nom du fichier de sortie sera ej25_special.html. Le nom d'origine du fichier d'une rubrique sera toujours généré dans le document de sortie ; copy-to permet de dupliquer le nom du fichier, il ne le modifie pas.

L'attribut copy-to vous permet également d'appliquer différents attributs de métadonnées (y compris navtitle) à chaque référence de la carte. Par exemple, vous pouvez très bien avoir une rubrique traitant de la sauvegarde des données et l'utiliser deux fois dans la carte DITA dans Sauvegarde des enregistrements des clients et Sauvegarde des enregistrements du personnel.

Vous pouvez utiliser l'attribut copy-to à la fois dans la section hiérarchie de la carte DITA et dans la section reltable.

Vous pourrez trouver ci-dessous un exemple d'utilisation de l'attribut copy-to dans le cadre de la création de deux rubriques identiques. Un système Microsoft HTML Help est en cours de développement, dans lequel la même rubrique doit être affichée en tant qu'enfant de deux nœuds parents différents dans différentes parties de la hiérarchie de la table des matières. Microsoft HTML Help possède une fonction synchronise TOC et une fonction de navigation séquentielle. Si la même rubrique HTML est utilisée dans deux parties différentes de la table des matières, la fonction synchronise sélectionnera toujours la première occurrence du nom de fichier de la rubrique dans le volet de la table des matières, troublant ainsi l'utilisateur qui s'attend à trouver la rubrique dans une autre section du système Help. L'utilisation de l'attribut copy-to pour spécifier un nom de fichier alternatif pour la deuxième instance du fichier de carte DITA va entraîner la génération de deux rubriques au cours du processus et réglera les problèmes de synchronisation ou de tout autre problème d'ordre séquentiel dans le fichier de sortie.

Vous devez uniquement utiliser l'attribut copy-to dans les éléments topicref des tables des relations lorsque vous avez besoin de créer un second fichier de sortie et que vous avez besoin de modifier les caractéristiques des liens ou la description d'une rubrique dans la deuxième copie.

<topicref href="turbo.dita" copy-to="xrw_turbo.dita">
  <topicmeta>
    <linktext>Turbocompresseur XRW Expliqué</linktext>
  </topicmeta>
</topicref>

N'utilisez pas l'attribut copy-to lorsque vous avez seulement besoin de modifier le texte d'un lien ; dans ce cas l'élément linktext peut être utilisé seul.