Format de l'attribut href dans les références croisées
L'adresse de la ressource référencée dans l'attribut href doit être au format standard URI.
Les ressources référencées dans les éléments xref, link, lq, glossref et source sont précisées dans l'attribut href.
Un URI, ou Identifiant uniforme de ressource (Uniform Resource Indicator), est un standard de référencement des ressources sur le Web. Le terme similaire URL, ou Localisateur uniforme de ressource (Uniform Resource Locator), est un type spécifique d'URI où l'emplacement et la manière de récupérer les ressources sont inclus dans l’adresse. Par exemple, l'URL http://store.scriptorium.com/items/Books/list.htm désigne l’adresse de la ressource et le protocole à utiliser afin de la retrouver (dans ce cas, http). Toutefois, ces termes sont utilisés de façon interchangeable.
Les fichiers d'un serveur ou le disque réseau d'un réseau local peuvent être référencés grâce à une convention URI. La plupart des outils de rédaction DITA vous permettront d'accéder à la ressource que vous souhaitez référencer et formateront l’adresse dans le format UNC correspondant. Par exemple, l’adresse d’un fichier sur un serveur réseau doit être précédée du protocole smb://.
Vous devez utiliser le slash comme séparateur de chemins. N’utilisez pas l’antislash. Ces références aux fichiers sont des URI dans DITA, pas des chemins d’accès aux fichiers. Les antislashs ne sont pas autorisés dans les URI. Lors du référencement des ressources sur un serveur réseau, indiquez smb:// avant le chemin UNC.
Vous ne pouvez pas utiliser l'esperluette (&) dans un attribut
href. Si l’URL référencée contient une esperluette,
utilisez à la place le caractère d’échappement &
pour
remplacer ce caractère.