<!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>
Konfigurációs kód annak leírására, hogy mi tartozik a környezetek leírófájlba:
<!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 >
A környezetek leírófájl minden szükséges információt tartalmaz arra az esetre, ha a felhasználó helyzetérzékeny súgót igényel. Az azonosítót a platform adja át a súgórendszernek a pillanatnyilag aktív környezet azonosításához. A megfelelő azonosítóval rendelkező környezetmeghatározások ezután lekérésre kerülnek. A leírófájlban lévő azonosítók nem tartalmazhatják a pont karaktert, mert az azonosítókat a pluginID.contextID karaktersorozat azonosítja egyedileg, amikor a memóriában van. Az IContext objektumot ezután a súgórendszer hozza létre, amely egy bedolgozóban lévő adott azonosítóhoz tartozó valamennyi környezetmeghatározás leírását és témaköreit tartalmazza. A leírás jelenik meg a felhasználó számára, a kapcsolódó témakörök pedig az aktuális környezet megértéséhez nyújtanak hasznos segítséget. A kapcsolódó témaköröket a doc.zip fájlba csomagolt html fájlok és az online súgó témakörei képezik.
Ha egy bedolgozó környezetazonosítókat határoz meg, akkor egy környezet leírása vagy kapcsolódó hivatkozásai kiterjeszthetők ugyanazzal az azonosítóval rendelkező másik környezet meghatározásával.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(az xyzContexts.xml fájlban)
<contexts>
<context id="generalContextId">
<description> Ez egy
F1 súgó minta karaktersorozat.</description>
<topic href="contexts/RelatedContext1.html"
label="1. súgó kapcsolódó témakör"/>
<topic href="contexts/RelatedContext2.html"
label="2. súgó kapcsolódó témakör"/>
</context>
</contexts>
A doc.zip fájlban tárolt
kapcsolódó témakörök a következőképpen honosíthatók: a dokumentációk
lefordított változatának felhasználásával kell létrehozni a doc.zip fájlt,
majd el kell helyezni az
nl/<language>/<country> vagy az
nl<language> könyvtárban. A súgórendszer a fájlokat ezekben a
könyvtárakban fogja keresni mielőtt rátérne az alapértelmezett bedolgozó
könyvtárra.
Copyright (c) 2000, 2003 IBM Corporation és mások.
Minden jog fenntartva. Jelen program és annak kísérőanyagai a csomaghoz
tartozó, illetve a
http://www.eclipse.org/legal/epl-v10.html
címen is elérhető Eclipse Public License 1.0 verziójának hatálya alatt lettek
közzétéve.