Kontekster

org.eclipse.help.contexts

For definering av kontekstavhengig hjelp til en individuell plugin-modul.

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


Nedenfor finner du et eksempel på bruken av utvidelsespunktet for kontekster:
(i filen plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(i filen xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description> This is a sample F1 help string.</description>
        <topic href="contexts/RelatedContext1.html"  label="Help Related Topic 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Help Related Topic 2"/>
      </context>
    </contexts>
 

Gjør strenger eksterne XML-filene for kontekst kan oversettes, og resultatet (med oversatte beskrivelsesetiketter) bør legges i katalogen nl/<språk>/<land> eller nl/<språk>. <språk> og <land> står for språk- og landkoder på to bokstaver som brukes i språkmiljøkoder. Oversettelser til tradisjonell kinesisk legges for eksempel i katalogen nl/zh/TW. Katalogen nl/<språk>/<land> har høyere prioritet enn nl/<språk>. Bare hvis det ikke blir funnet en fil i nl/<språk>/<land>, vil filen som ligger i nl/<språk> bli brukt. Rotkatalogen for en plugin-modul blir søkt i sist.

De beslektede emnene i doc.zip kan lokaliseres ved å opprette en doc.zip-fil med oversatte versjoner av dokumenter, og legge doc.zip i katalogen nl/<språk>/<land> eller nl/<språk>. Hjelpefunksjonen leter etter filene under disse katalogene før standard plugin-katalog brukes.

Det er ikke nødvendig med kode for å bruke dette utvidelsespunktet. Alt som trengs er den eller de riktige manifestfilene som er nevnt i plugin.xml-filen.

Den valgfrie standardimplementeringen av hjelpefunksjonens brukergrensesnitt som leveres med Eclipse-plattformen, har fullstendig støtte for utvidelsespunktet contexts.