<!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>
Konfigurationsmärkord för vad som finns i sammanhangsmanifestfilen:
<!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 >
Sammanhangsmanifestfilerna innehåller all information som behövs när sammanhangsberoende hjälp begärs av användaren. Dess ID skickas från plattformen till hjälpsystemet för att identifiera det för tillfället aktiva sammanhanget. Sammanhangsdefinitionerna med matchande ID hämtas sedan. ID i manifestfilen får inte innehålla punkttecken eftersom ID unikt identifieras av strängen pluginID.contextID string i minnet. IContext-objektet skapas sedan av hjälpsystemet som innehåller beskrivningar och ämnen från alla sammanhangsdefinitioner för ett visst ID i ett insticksprogram. Beskrivningen ska visas för användaren och närliggande ämnen kan vara användbara för användaren för att förstå det aktuella sammanhanget. Det närliggande ämnet är html-filer som är packade i doc.zip tillsammans med ämnen som utgör en del av direkthjälpen.
Om ett insticksprogram definierar några sammanhangs-ID kan du utöka beskrivningen eller de närliggande länkarna för ett sammanhang genom att deklarera ett annat sammanhang med samma ID.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(in file xyzContexts.xml)
<contexts>
<context id="generalContextId">
<description> Detta
är hjälpsträngen för exempel F1.</description>
<topic href="contexts/RelatedContext1.html"
label="Närliggande hjälpämne 1"/>
<topic href="contexts/RelatedContext2.html"
label="Närliggande hjälpämne 2"/>
</context>
</contexts>
De närliggande ämnena i doc.zip kan du lokalisera genom att skapa
en doc.zip-fil med översatta versioner av dokumenten och placera doc.zip
i
katalogen nl/<language>/<country> eller nl/<language>. Hjälpsystemet söker efter filerna under dessa kataloger innan insticksprogrammets katalog används som standard.
Copyright (c) 2000, 2005 IBM Corporation and others.
All Rights Reserved. Detta program och medföljande material tillhandahålls under villkoren för Eclipse Public License v1.0 som medföljer denna distribution och finns tillgänglig på
http://www.eclipse.org/legal/epl-v10.html