Kontexter

org.eclipse.help.contexts

För definiering av sammanhangsberoende hjälp för ett individuellt insticksprogram.

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


Här följer ett exempel på hur du använder utökningspunkten för sammanhang:
(i filen plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(in file xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description> Detta är hjälpsträngen för exempel F1.</description>
        <topic href="contexts/RelatedContext1.html"  label="Närliggande hjälpämne 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Närliggande hjälpämne 2"/>
      </context>
    </contexts>
 

Externalisera strängar Sammanhangsfilerna med XML-format kan översättas och de resulterande kopiorna (med översatta beskrivningsetiketter) ska placeras i katalogen nl/<language>/<country> eller nl/<language>.  <language> and <country> står för de språk- och landskoder med två tecken som används i språkmiljökoder.  Översättningar till traditionell kinesiska placeras t.ex. i katalogen nl/zh/TW.  Katalogen nl/<language>/<country> har högre prioritet än nl/<language>.  Endast om ingen fil återfinns i nl/<language>/<country> används den fil som finns i nl/<language>.  Rotkatalogen för ett insticksprogram genomsöks sist.

De närliggande ämnena i doc.zip kan du lokalisera genom att skapa en doc.zip-fil med översatta versioner av dokumenten och placera doc.zip i
katalogen nl/<language>/<country> eller nl/<language>. Hjälpsystemet söker efter filerna under dessa kataloger innan insticksprogrammets katalog används som standard.

Ingen kod behöver användas för den här utökningspunkten. Allt som behövs är att tillhandahålla lämpliga manifestfiler som omnämns i filen plugin.xml.

Den valfria standardimplementeringen av hjälpsystemets användargränssnitt som tillhandahålls med Eclipse plattform stödjer fullständigt utökningspunkten sammanhang.