Les éléments de prologue représentent les métadonnées associées à un document. La plupart des métadonnées d'un prologue de thème peuvent également être créées dans une carte DITA, dans l'élément <topicmeta> de la carte.
Les principaux types d'information que l'on peut stocker dans le prologue comprennent :
resourceid>) qui permet d'associer un thème à des ressources externes
tel que lier des composants de programmation pour une aide contextuelle.prolog> contient des informations à propos du thème dans son ensemble (par exemple, l'auteur ou la catégorie d'un sujet), entrées par l'auteur ou bien générées par une machine. La plupart des métadonnées dans l'élément <prolog> ne s'afficheront pas avec le thème en sortie, mais seront utilisées par des processus qui génèrent des index de recherche ou personnalisent la navigation.audience> indique le public visé pour un thème au travers de la valeur de son attribut type. Puisqu'un thème peut avoir plusieurs publics, on peut inclure plusieurs éléments <audience>. Pour chaque public spécifié, on peut identifier la tâche de niveau supérieur (<job>) qu'il essaye d'accomplir et le niveau d'expérience (<experiencelevel>) attendu. On peut employer l'élément <audience> pour fournir une définition plus détaillée que l'attribut audience des valeurs utilisées pour la carte ou le thème.author> contient le nom de l'auteur du thème.brand> indique le fabricant ou la marque associés au produit décrit par l'élément parent <prodinfo>.category> représente toute catégorie dans laquelle on peut ranger un thème pour une récupération ou une navigation ; par exemple, on pourrait utiliser des catégories pour regrouper les thèmes dans une barre de navigation générée. Les thèmes peuvent appartenir à plusieurs catégories.component> décrit le composant du produit concerné par ce thème. Par exemple, un produit pourrait avoir plusieurs composants, chacun étant installable séparément. Les composants pourraient aussi être partagés, et le même composant être ainsi proposé en installation avec plusieurs produits. Une mise en œuvre peut (sans obligation) utiliser cette identification pour vérifier les dépendances entre les composants lors de l'installation de certains composants mais pas des autres. Une mise en œuvre peut également (sans obligation) utiliser l'identification afin de cacher, supprimer ou marquer d'une certaine façon les thèmes si le composant décrit n'est pas installé.copyright> est utilisé pour une seule entrée de copyright. Il inclut l'année du copyright et le détenteur des droits. Plusieurs déclarations <copyright> sont permises.copyrholder>) nomme l'entité qui détient les droits légaux sur la matière contenue dans le thème.copyryear> contient l'année de copyright comme indiquée par l'attribut year.created> spécifie la date de création du document avec l'attribut date.critdates> contient les dates critiques dans le cycle de vie d'un document, telles que la date de création et les multiples dates de révision.featnum> contient le numéro de caractéristique d'un produit dans les métadonnées.keywords> contient une liste de mots-clés (utilisant des balises <indexterm> ou <keyword>) exploitable par un moteur de recherche.metadata> du prologue contient des informations à propos d'un thème telles que le public et les caractéristiques du produit. Les métadonnées peuvent être utilisées par des processus informatiques pour sélectionner des thèmes particuliers ou pour préparer des index de recherche ou pour personnaliser la navigation. Les sous-éléments de <metadata> fournissent des informations à propos du contenu et du sujet d'un thème ; les éléments de prologue en dehors de l'élément <metadata> fournissent des informations de cycle de vie pour l'unité de contenu (telles que l'auteur ou les droits d'auteur), qui ne sont pas liées au sujet.othermeta> peut être utilisé pour identifier des propriétés, non incluses par ailleurs dans l'élément <metadata>, et leur affecter des valeurs name/content. L'attribut name identifie la propriété et l'attribut content en spécifie la valeur. Les valeurs de cet attribut sont extraites comme éléments de métadonnée HTML et n'ont pas de signification définie pour d'autres sorties possibles telles que du PDF.permissions> peut indiquer les contrôles préférés pour accéder à un thème. Les thèmes peuvent être filtrés en fonction de l'élément <permissions>. Cette capacité dépend du processus de formatage en sortie.platform> contient une description du système d'exploitation ou du matériel liée au produit décrit par l'élément <prodinfo>. L'élément <platform> peut être employé pour fournir une définition plus détaillée que l'attribut platform des valeurs utilisées à travers la carte ou le thème.prodinfo> dans le prologue contient des informations à propos du produit ou des produits qui sont la matière du thème courant. L'élément <prodinfo> peut être employé pour fournir une définition plus détaillée que l'attribut product des valeurs utilisées à travers la carte ou le thème.prodname> contient le nom du produit soutenu par les données dans ce thème.prognum> identifie le numéro de programme du produit logiciel associé. Il s'agit typiquement d'un numéro d'ordre ou d'un code de suivi de produit qui pourra être remplacé par un numéro d'ordre lorsque que le développement du produit sera terminé.publisher> contient le nom de la personne, compagnie ou organisation responsables de la distribution du contenu ou du sujet du thème.resourceid> fournit un identificateur pour les applications qui les demandent dans un format particulier, lorsque l'attribut id normal du thème n'est pas utilisable. Chaque entrée <resourceid> devrait être unique. C'est l'un des éléments de métadonnée que le prologue d'un thème peut inclure, avec le suivi du document et les données de produit, etc. L'élément n'a pas de contenu mais prend un attribut id et un attribut appname.revised> dans le prologue est utilisé pour conserver les dates de suivi importantes dans le cycle de développement d'un thème, telles que la date de dernière modification, la date de première mise à disposition et la date d'expiration.series> contient des informations à propos de la série de produit que le thème soutient.source> contient la référence d'une ressource de laquelle dérive le thème présent, en partie ou en totalité. L'élément peut contenir une description de la ressource ; la référence href peut être une chaîne ou une adresse URL qui pointe vers elle.vrmlist> contient un ensemble d'éléments <vrm> pour enregistrer les informations de version, de publication et de modification de plusieurs produits ou versions de produit auxquels le thème s'applique.vrm> contient des informations à propos de la version, la modification et la publication d'un seul produit auquel le thème courant s'applique.OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.