<!ELEMENT extension (contexts*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT contexts EMPTY>
<!ATTLIST contexts
file CDATA #REQUIRED
plugin CDATA #IMPLIED>
Marques de configuration pour ce qui entre dans le fichier manifeste des contextes :
<!ELEMENT contexts (context)* ) >
<!ELEMENT context (description?,topic*) >
<!ATTLIST context id ID #REQUIRED >
<!ELEMENT description (#PCDATA)>
<!ELEMENT topic EMPTY >
<!ATTLIST topic label CDATA #REQUIRED >
<!ATTLIST topic href CDATA #IMPLIED >
Les fichiers manifestes des contextes fournissent toutes les informations requises lorsque l'aide contextuelle est demandée par l'utilisateur. L'ID passe de la plateforme au système d'aide afin d'identifier le contexte actif en cours. Les définitions de contexte avec les ID correspondants sont ensuite récupérées. Les ID du fichier manifeste ne doivent pas contenir le signe point puisque les ID sont uniquement identifiés par une chaîne pluginID.contextID en mémoire. L'objet IContext est ensuite créé par le système d'aide contenant des descriptions et des rubriques provenant de toutes les définitions de contexte pour un ID donné dans un plug-in. La description doit être affichée pour l'utilisateur et les rubriques associées peuvent lui être très utiles afin de comprendre le contexte en cours. Les rubriques associées sont des fichiers html avec l'extension doc.zip, ainsi que des rubriques faisant partie de l'aide en ligne.
Si un plug-in définit des ID de contexte, l'un peut étendre la description ou les liens connexes d'un contexte en déclarant un autre contexte avec le même ID.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(dans le fichier xyzContexts.xml)
<contexts>
<context id="generalContextId">
<description> Voici un exemple de chaîne d'aide F1.</description>
<topic href="contexts/RelatedContext1.html"
label="Rubrique d'aide 1"/>
<topic href="contexts/RelatedContext2.html"
label="Rubrique d'aide 2"/>
</context>
</contexts>
Les rubriques connexes se trouvant dans le doc.zip peuvent être
localisées en créant un fichier doc.zip avec la version traduite des
documents et en le plaçant dans le répertoire
nl/<langue>/<pays>
ou nl/<langue>. Le système d'aide recherchera les fichier dans ces
répertoires avant d'aller par défaut dans le répertoire du plug-in.
Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. Ce programme et les produits associés sont
distribués sous licence publique Eclipse v1.0 et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/epl-v10.html