Kontekster

org.eclipse.help.contexts

Bruges til at definere kontekstafhængig hjælp til en individuel plugin.

<!ELEMENT extension (contexts*)>

<!ATTLIST-udvidelse

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT contexts EMPTY>

<!ATTLIST contexts

file   CDATA #REQUIRED

plugin CDATA #IMPLIED>


Det følgende er et eksempel på, hvordan du bruger udvidelsespunktet til kontekster:
(i filen plugin.xml)

   

<udvidelsespunkt=

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

Strengeksternalisering XML-kontekstfilerne kan oversættes, og den resulterende kopi (med oversatte beskrivelsesetiketter) skal placeres i biblioteket nl/<language>/<country> eller nl/<language>. <language> og <country> står for sprog- og landekoder på to bogstaver, som anvendt i forbindelse med koder for sprogkonventioner.  Oversættelser til uforkortet kinesisk skal f.eks. placeres i biblioteket nl/zh/TW. Biblioteket nl/<language>/<country> har højere prioritet end nl/<language>. Det er kun, hvis der ikke findes nogen fil i nl/<language>/<country>, at filen i nl/<language> bliver benyttet. Der vil blive søgt i rodbiblioteket for en plugin til sidst.

De relaterede emner i doc.zip kan lokaliseres ved at oprette en doc.zip-fil med de oversatte versioner af dokumenterne og placere doc.zip i
biblioteket nl/<language>/<country> eller nl/<language>. Hjælpen vil lede efter filer under disse biblioteker, inden det anvender plugin-biblioteket.

Der kræves ingen kode for at anvende dette udvidelsespunkt. Det eneste, du skal levere, er den relevante manifestfil omtalt i plugin.xml-filen.

Den valgfrie standardimplementering af brugergrænsefladen til hjælpen, der leveres sammen med Eclipse-platformen, understøtter udvidelsespunktet til kontekster.