Faire référence à des rubriques non-DITA

Une carte DITA peut inclure des références à des ressources non-DITA, telles que des documents PDF, des fichiers tableurs, des fichiers de présentations, des tutoriels en ligne, des fichiers HTML et des adresses Internet. Utilisez l'élément topicref pour ces références, en y associant les attributs scope et format, qui permettent de décrire le type de ressource.

Parfois, un document livrable dans un projet DITA ne sera pas composé exclusivement de contenu DITA. Par exemple, un manuel utilisateur peut avoir besoin d'inclure un formulaire PDF, ou un site Web peut avoir besoin d'inclure un tutoriel interactif Flash créé par un tiers. Ainsi, lorsque vous définissez la carte DITA (une déclaration du contenu de votre document final), il est possible que vous ayez besoin d'inclure des références à des ressources non-DITA.

Ces ressources non-DITA sont référencées par l'élément standard topicref, mais avec deux attributs paramétrés pour indiquer que les fichiers référencés ne sont pas au format DITA et sont externes au projet. Il s'agit des attributs format et scope. Vous devez également ajouter un titre de navigation (attribut navtitle) et verrouiller le titre (en donnant la valeur yes à l'attribut locktitle) pour que le processeur n'essaie pas de récupérer la rubrique à partir de la ressource référencée.

De plus, si vous souhaitez inclure des liens vers des sites Web ou des adresses électroniques dans la table des matières du document de sortie, générée à partir de la carte DITA, vous pouvez utiliser à nouveau l'élément standard topicref, mais avec l'attribut format défini sur html et l'attribut scope défini sur external.

L'exemple de code suivant présente une référence à un site Web et une référence à un fichier PDF situé dans un dossier relatif au dossier de sortie.

<topicref 
  format="html"
  href="http://www.Supara.com.au/"
  locktitle="yes" navtitle="Site Web Supara pour l'Australie" scope="external"/>
<topicref format="pdf" href="pdf/2006_impre_brochure.pdf" locktitle="yes" navtitle="Brochure Supara 
	 	Impress de 2006" scope="peer"/>

Toutefois, l'attribut format accepte toutes les chaînes de caractère. Ainsi, si vous référencez un autre type de ressource, vous pouvez utiliser l'extension de fichier (sans le .). Par exemple, si vous référencez un document Word 2007, vous utiliserez docx comme valeur de l'attribut format.

L'attribut scope peut également permettre de déterminer la fenêtre utilisée à l'ouverture de la ressource (lorsqu'elle est générée en une sortie hypertexte).