Description : destiné à la définition de l'aide contextuelle d'un plug-in individuel.
Marques de configuration :
<!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 tous les informations requises lorsque l'aide contextuelle est demandée par l'utilisateur. L'ID est transmis par la plateforme pour identifier le contexte actif en cours. Les définitions de contexte correspondant aux ID sont alors extraites. L'objet IContext est ensuite créé par le système d'aide contenant les descriptions et les rubriques de toutes les définitions de contexte pour un ID donné. La description doit être visible par l'utilisateur et les rubriques connexes peuvent servir à comprendre le contexte actuel. Ces rubriques sont des fichiers html rassemblés dans un doc.zip avec les autres 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> This
is a sample F1 help string.</description>
<topic href="contexts/RelatedContext1.html"
label="Help Related Topic 1"/>
<topic href="contexts/RelatedContext2.html"
label="Help Related Topic 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.
Informations d'API : Aucun code n'est requis pour utiliser le point d'extension. Il suffit de fournir le(s) fichier(s) manifeste(s) approprié(s), mentionné(s) dans le fichier plugin.xml.
Implémentation fournie : l'implémentation par défaut facultative de l'interface du système d'aide fournie avec la plateforme Eclipse supporte totalement le point d'extension contexts.
Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. Ce programme et les produits qui l'accompagnent sont
fournis sous licence v1.0 associée à cette distribution et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/cpl-v10.html