Környezetek

org.eclipse.help.contexts

Helyzetérzékeny súgó meghatározására egyéni bedolgozóhoz.

<!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>


Az alábbiakban a környezetek kiterjesztési pont használatára látható példa:
(a plugin.xml fájlban)

   

<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>
 

Karaktersorozatok külsőleg elérhetővé tétele A kontextus XML fájlok lefordíthatók, az eredményül kapott másolatokat (a lefordított címkékkel) pedig az nl/<language>/<country> vagy az nl/<language> könyvtárban kell elhelyezni.   A <language> és <country> két betűs nyelv- és országkódokat képviselnek a helyi kódokban használtak szerint.  Például a hagyományos kínai fordításokat az nl/zh/TW könyvtárban kell elhelyezni.   Az nl/<language>/<country> könyvtár az nl/<language> könyvtárnál magasabb prioritással rendelkezik.   Az nl/<language> könyvtárban található fájl csak akkor kerül felhasználásra, ha az nl/<language>/<country> könyvtár üres.   A bedolgozó gyökérkönyvtárának átnézése az utolsó.

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.

Ez a kiterjesztési pont használatához nem szükséges kód. Mindössze a plugin.xml fájlban említett megfelelő leírófájlokat szükséges biztosítani.

Az Eclipse környezettel biztosított súgórendszer felhasználói felületének elhagyható alapértelmezett megvalósítása teljes mértékben támogatja a contexts kiterjesztési pontot.