<!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>
Configuratiemarkup voor de inhoud van de contextmanifestbestanden:
<!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 >
De contextmanifestbestanden bevatten alle gegevens die nodig zijn wanneer de gebruiker contextgevoelige Help opvraagt. Het ID wordt door het platform doorgegeven aan het Help-systeem om de actieve context aan te duiden. De contextdefinities met overeenkomende ID's worden vervolgens opgehaald. De ID's in het manifestbestand mogen geen punt bevatten, omdat ze in het geheugen uniek herkenbaar zijn aan de tekenreeks pluginID.contextID. Het object IContext wordt vervolgens gemaakt door het Help-systeem, dat de beschrijvingen en onderwerpen bevat van alle contextdefinities voor een bepaald ID in een plugin. De beschrijving wordt afgebeeld en verwante onderwerpen kunnen voor de gebruiker nuttig zijn, zodat deze de huidige context kan begrijpen. De verwante onderwerpen zijn HTML-bestanden die in het bestand doc.zip zijn ingepakt bij de onderwerpen die deel uitmaken van de online Help.
Als in een plugin bepaalde context-ID's zijn gedefinieerd, kunnen de beschrijving of verwante links van die contexten worden uitgebreid door een andere context met hetzelfde ID te declareren.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(in bestand xyzContexts.xml)
<contexts>
<context id="generalContextId">
<description>Dit is een voorbeeld van Help-tekst voor F1.</description>
<topic href="contexts/RelatedContext1.html"
label="Verwant Help-onderwerp 1"/>
<topic href="contexts/RelatedContext2.html"
label="Verwant Help-onderwerp 2"/>
</context>
</contexts>
U kunt de verwante onderwerpen in het bestand doc.zip lokaliseren door de vertaalde versies in te pakken in het bestand doc.zip en dit ZIP-bestand in de directory nl/<taal>/<land> of nl/<taal> te plaatsen. Het Help-systeem zoekt eerst naar de bestanden in deze directory's voordat de plugindirectory als standaardinstelling wordt gebruikt.
Copyright (c) 2000, 2005 IBM Corporation en anderen.
Alle rechten voorbehouden. Dit programma en het begeleidende materiaal zijn beschikbaar gesteld onder de voorwaarden van de Eclipse Public License v1.0 die bij deze distributie is geleverd en beschikbaar is op http://www.eclipse.org/legal/epl-v10.html.