Beschreibung: Hier kann die kontextbezogene Hilfe für ein spezielles Plug-in definiert werden.
Konfigurationsbefehle:
<!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 übergeben, um den gegenwärtig aktiven Kontext zu kennzeichnen. Die Kontextdefinitionen mit übereinstimmenden IDs werden dann abgerufen. Das Objekt IContext wird anschließend vom Hilfesystem erstellt; es enthält Beschreibungen und Themen von allen Kontextdefinitionen für eine gegebene ID. Die Beschreibung wird für den Benutzer angezeigt; verwandte Themen sind für den Benutzer hilfreich, um den aktuellen Kontext zu verstehen. Die verwandten Themen sind html-Dateien, die in einer doc.zip zusammen mit Themen, die Teil der Onlinehilfe sind, gepackt 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.
API-Informationen: Für die Verwendung dieses Erweiterungspunktes wird kein Code benötigt. Es ist lediglich erforderlich, die entsprechende(n) Manifestdatei(en) bereitzustellen, die in der Datei "plugin.xml" angegeben ist/sind.
Bereitgestellte Implementierung: Die optionale Standardimplementierung der Systembenutzerschnittstelle für die Hilfefunktion, die mit der Eclipse-Plattform ausgeliefert wird, bietet eine vollständige Unterstützung des Erweiterungspunkts contexts.
Copyright (c) 2000, 2003 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden unter den Bedingungen der "Common Public License v1.0" zur Verfügung gestellt, die diese Verteilung begleitet und unter
http://www.eclipse.org/legal/cpl-v10.html abgerufen werden kann.