Kontekstit

org.eclipse.help.contexts

Tämän laajennuspisteen avulla voidaan määrittää tilannekohtaiset (kontekstisidonnaiset) ohjeet yksittäisiä lisäosia varten.

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


Seuraavassa on kontekstilaajennuspisteen käyttöesimerkki:
(Määritystiedosto plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(Määritystiedosto xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description> Tämä on F1-ohjeen mallimerkkijono.</description>
        <topic href="contexts/RelatedContext1.html"  label="Ohjeeseen liittyvä aihe 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Ohjeeseen liittyvä aihe 2"/>
      </context>
    </contexts>
 

Merkkijonojen ulkoistaminen Kontekstimäärityksen XML-tiedostot voidaan kääntää ja käännetyt tiedostot (joiden kuvausten nimiöt on myös käännetty) sijoittaa hakemistoon nl/<kieli>/<maa> tai nl/<kieli>. Hakemistopolkujen <kieli>- ja <maa>-osat ovat paikallistunnuskoodien mukaiset kaksikirjaimiset kieli- ja maakoodit. Esimerkiksi perinteisen kiinan käännösten tallennushakemisto olisi nl/zh/TW. Nl/<kieli>/<maa>-hakemisto on ensisijainen nl/<kieli>-hakemistoon verrattuna. Nl/<kieli>-hakemistossa olevaa tiedostoa käytetään vain, jos tiedostoa ei löydy nl/<kieli>/<maa>-hakemistosta. Tiedostoa etsitään viimeisenä lisäosan päähakemistosta.

Doc.zip-arkistotiedoston sisältämät aiheeseen liittyvät ohjeaiheet voidaan lokalisoida luomalla doc.zip-tiedostosta käännetyt asiakirjat sisältävä versio ja tallentamalla se
nl/<kieli>/<maa>- tai nl/<kieli>-hakemistoon. Ohjejärjestelmä etsii tiedostoja ensin näistä hakemistoista ja viimeisenä oletusarvoisesta lisäosan hakemistosta.

Tämän laajennuspisteen käyttö ei edellytä koodia. Riittää, että plugin.xml-tiedoston mukaiset manifest-tiedostot on luotu.

Eclipse-käyttöympäristön mukana toimitettava ohjejärjestelmän käyttöliittymän valinnainen oletustoteutus tukee contexts-laajennuspistettä.