Création d'entités

Une entité est un raccourci utilisé pour représenter des chaînes complexes ou des symboles dont l'insertion manuelle se révélerait répétitive, difficile, voire impossible.

Par exemple, vous devez placer une notification de droit d'auteur (par exemple, Copyright 2004. MyCompany publishing.) à la fin de chaque page d'un manuel. Au lieu de l'écrire à chaque fois, vous pouvez créer une entité représentant ce texte : <!ENTITY copyright "Copyright 2004. MyCompany publishing.">copyright est le nom de l'entité et "Copyright 2004. MyCompany publishing" est le texte que l'entité copyright représente.

Pour créer une entité, effectuez les opérations suivantes :

  1. Ouvrez votre DTD dans l'éditeur de DTD.
  2. Dans la vue Structure, cliquez avec le bouton droit de la souris sur la DTD Ce symbole graphique représente l'icône DTD. et cliquez sur Ajouter une entité.
  3. Dans la vue Propriétés, saisissez le nom de l'entité dans la zone Nom.
  4. A partir de la liste Type d'entité, sélectionnez Général ou Paramètre. Les entités générales sont utilisées dans les fichiers XML, alors que les entités de paramètre ne sont utilisées que dans la DTD et ne sont pas utilisables dans un fichier XML.
  5. Cochez la case Externe si vous voulez déclarer votre entité comme entité externe. Une entité externe référence des données ou un document externes.
  6. Si vous avez déclaré l'entité comme étant externe, les zones suivantes apparaissent :
    • ID public (facultatif). Saisissez le chemin de la DTD que vous voulez référencer. Vous pourrez ensuite utiliser les ressources du fichier que vous référencez.
    • ID système. Naviguez jusqu'au chemin des données ou du document externes que vous voulez référencer ou saisissez-le. Vous pourrez ensuite utiliser les ressources du fichier que vous référencez.

    Il suffit de spécifier ID public ou ID système, pas les deux. Si, dans votre DTD, vous voulez utiliser n'importe quelle ressource (éléments ou attributs) contenue dans le document que vous avez référencé, vous devez faire de cette entité une entité de Paramètre et "développer" l'entité en créant une référence d'entité de paramètre externe (cliquez avec le bouton droit de la souris sur la DTD Ce symbole graphique correspond à l'icône de DTD., cliquez sur Ajouter une référence d'entité de paramètre externe et sélectionnez l'entité que vous venez de créer).

  7. Si vous n'avez pas fait de l'entité une entité externe, vous pouvez spécifier la valeur de l'entité dans la zone Valeur d'entité.
  8. Cliquez sur l'onglet Documentation si vous voulez fournir des informations au sujet de cette entité. La page Documentation fournit des documents faciles à lire pour l'utilisateur comme une description de l'entité.
Les liens suivants expliquent les différentes manières de réutiliser des entités :
Tâches associées
Suppression d'éléments, d'attributs, d'entités, de notations et de commentaires

Retour d'informations