L'attribut href

Un élément topicref (références aux rubriques) dans une carte DITA référence la rubrique (ou une autre ressource) à inclure dans la publication grâce à l'attribut href.

Les éléments topicref (référence aux rubriques) référencent généralement une rubrique DITA, mais peuvent également référencer des ressources externes, comme les sites Web. Les ressources référencées dans l'élément topicref sont déclaré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.