Liens vers les ressources non-DITA

Les références croisées peuvent servir à lier des rubriques DITA à des ressources non-DITA, comme les URL Web, les adresses e-mail et les documents stockés sur des serveurs. Les attributs scope et format de la référence croisée servent à définir la nature de la ressource liée et donc, de façon indirecte, la manière dont le lien va se comporter.

Les quatre principaux attributs d'un élément de référence croisée (xref) sont href, type, scope et format.

Lorsqu'un lien renvoie à une ressource non-DITA telle qu'un fichier PDF ou une adresse Web, l'attribut scope définit si la ressource ciblée doit ou non être traitée comme faisant partie d'une collection DITA. Ce paramètre définira la façon dont le document de sortie HTML sera formé pendant le processus de publication et la façon dont votre navigateur utilisera le lien. L'attribut format décrit le type de ressource lié.

Les principales valeurs de l'attribut scope sont :
local
La ressource fait partie de la collection de contenu (et sera généralement ouverte dans le navigateur en cours d'utilisation lorsque le document de sortie est au format hypertexte).
external
La ressource est gérée indépendamment de la collection de contenu (et sera généralement ouverte dans une nouvelle fenêtre ou un nouvel onglet du navigateur en cours d'utilisation lorsque le document de sortie est au format hypertexte).
Remarque : La valeur peer, qui est également valide pour l'attribut scope, est identique à la valeur local mais concerne les ressources qui ne sont pas disponibles lors de la compilation. Cette valeur est uniquement adaptée lors de la création de liens vers des ressources DITA.
Les valeurs valides de l'attribut format pour les ressources non-DITA sont :
html
Le format de fichier non-DITA de la ressource cible est HTML ou XHTML
pdf
Le format de fichier non-DITA de la ressource cible est PDF
txt
Le format de fichier non-DITA de la ressource cible contient uniquement du texte brut
file type
Concerne les extensions en trois lettres des formats de fichier non-DITA des ressources cibles (par exemple, ppt et odt)
Voici un exemple de code pour des liens de références croisées internes et externes.
<xref href="unfichier.html" format="html" scope="local" />
<xref href="unfichier.doc" format="doc" scope="external" />
<xref href="http://abc.com/intro.htm" format="html" scope="external" />