<!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>
Konfigurační markup pro to, co patří do souboru s manifestem kontextů:
<!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 >
Soubory s manifestem kontextů poskytují všechny informace potřebné, když uživatel požaduje kontextově citlivou nápovědu. Id se předává platformou systému nápovědy, aby bylo možné určit právě aktivní kontext. Poté se načtou definice kontextu s odpovídajícími Id. Identifikátory v souboru s manifestem nesmí obsahovat znak tečky, protože Id jsou v paměti jednoznačně identifikovány pomocí řetězce pluginID.contextID. Systém nápovědy pak vytvoří objekt IContext, který obsahuje popisy a hesla ze všech definic kontextů pro dané ID v rámci modulu plug-in. Popis má být zobrazen uživateli a související hesla mu mohou být užitečná pro porozumění aktuálnímu kontextu. Související hesla jsou soubory html zabalené v doc.zip, spolu s hesly, která jsou součástí online nápovědy.
Pokud plug-in definuje nějaké kontextové identifikátory, může některý rozšířit popis nebo související odkazy kontextu deklarováním jiného kontextu se stejným ID.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(v souboru xyzContexts.xml)
<contexts>
<context id="generalContextId">
<description> This
is a sample F1 help string.</description>
<topic href="contexts/RelatedContext1.html"
label="Související heslo nápovědy 1"/>
<topic href="contexts/RelatedContext2.html"
label="Související heslo nápovědy 2"/>
</context>
</contexts>
Související témata obsažená v doc.zip je možné lokalizovat vytvořením souboru doc.zip s přeloženou verzí dokumentů a tento doc.zip umístit do
adresáře nl/<jazyk>/<země> nebo nl/<jazyk>. Systém nápovědy bude hledat soubory nejprve v těchto adresářích a teprve potom přejde do adresáře modulů plug-in.
Copyright (c) 2000, 2003 IBM Corporation a další.
Všechna práva vyhrazena.
Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html