<!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>
Konfigurationsbefehle für die Aufnahme in die Manifestdatei für Kontexte:
<!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
>
Die Manifestdateien für Kontexte stellen alle Informationen bereit, die benötigt werden, wenn der Benutzer die kontextbezogene Hilfe anfordert. Die ID wird durch die Plattform an das Hilfesystem übergeben, um den gegenwärtig aktiven Kontext zu kennzeichnen. Die Kontextdefinitionen mit übereinstimmenden IDs werden dann abgerufen. Die IDs in der Manifestdatei dürfen keinen Punkt enthalten, da die IDs, wenn Sie im Speicher sind, eindeutig durch pluginID.contextID gekennzeichnet sind. Das Objekt 'IContext' wird dann durch die Hilfefunktion erstellt, die Beschreibungen und Themen aller Kontextdefinitionen für eine gegebene ID in einem Plug-in enthält. Die Beschreibung muss für den Benutzer angezeigt werden, und verwandte Themen können für den Benutzer hilfreich sein, um den aktuellen Kontext zu verstehen. Das verwandte Thema sind html-Dateien, die in doc.zip-Dateien gepackt sind, zusammen mit Themen, die Teil einer Onlinehilfe sind.
Falls ein Plug-in Kontext-IDs definiert, können die Beschreibung oder die zugehörigen Links eines Kontextes erweitert werden, indem ein anderer Kontext mit derselben ID deklariert wird.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
Angaben in der Datei xyzContexts.xml:
<contexts>
<context id="generalContextId">
<description>Dies ist eine Beispielzeichenfolge für den
Hilfetext zur Taste F1.</description>
<topic href="contexts/RelatedContext1.html"
label="Verwandtes Hilfethema 1"/>
<topic href="contexts/RelatedContext2.html"
label="Verwandtes Hilfethema 2"/>
</context>
</contexts>
Die in doc.zip enthaltenen verwandten Themen können durch Erstellen der Datei
doc.zip mit den übersetzten Versionen von Dokumenten und durch Stellen
von doc.zip in das Verzeichnis
nl/<sprache>/<land>
oder nl/<sprache> lokalisiert werden. Das Hilfesystem sucht nach Dateien in diesem Verzeichnis, bevor das Standardverzeichnis plugin durchsucht wird.
Copyright (c) 2000, 2003 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß den Bedingungen der "Eclipse Public License v1.0" zur Verfügung gestellt, die dieser Lieferung beiliegt und unter
http://www.eclipse.org/legal/epl-v10.html abgerufen werden kann.