<!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 dann durch die Hilfefunktion erstellt, die Beschreibungen und Themen aller Kontextdefinitionen für angegebene Benutzerschnittstellen 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 in 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.