Contexten

org.eclipse.help.contexts

Voor het definiëren van contextgevoelige Help voor afzonderlijke plugins.

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


Dit is een voorbeeld van het extensiepunt contexts:
(in bestand plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(in bestand xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description>Dit is een voorbeeld van Help-tekst voor F1.</description>
        <topic href="contexts/RelatedContext1.html"  label="Verwant Help-onderwerp 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Verwant Help-onderwerp 2"/>
      </context>
    </contexts>
 

Internationalisering De XML-contextbestanden kunnen worden vertaald. Vertaalde versies (met vertaalde beschrijvingslabels) moeten in de directory's nl/<taal>/<land> of nl/<taal> worden geplaatst. De <taal> en het <land> worden aangeduid door een code van twee letters (zoals in locales). Een vertaling in traditioneel Chinees moet bijvoorbeeld in de directory nl/zh/TW worden geplaatst. De directory nl/<taal>/<land> heeft meer prioriteit dan nl/<taal>. Het bestand in de directory nl/<taal> wordt alleen gebruikt als de directory nl/<taal>/<land> leeg is. De hoofddirectory van de plugin wordt als laatste doorzocht.

U kunt de verwante onderwerpen in het bestand doc.zip lokaliseren door de vertaalde versies in te pakken in het bestand doc.zip en dit ZIP-bestand in de directory nl/<taal>/<land> of nl/<taal> te plaatsen. Het Help-systeem zoekt eerst naar de bestanden in deze directory's voordat de plugindirectory als standaardinstelling wordt gebruikt.

Voor dit extensiepunt is geen code nodig. U hoeft alleen de juiste manifestbestanden te leveren, die in het bestand plugin.xml zijn vermeld.

De optionele standaardimplementatie van de Help-systeeminterface, die bij het Eclipse-platform wordt geleverd, biedt volledige ondersteuning voor het extensiepunt contexts.