Kontexty

org.eclipse.help.contexts

Pro definování kontextově citlivé nápovědy pro individuální plug-in.

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


Následuje příklad použití bodu rozšíření kontextů:
(v souboru plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(v souboru xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description> This is a sample F1 help string.</description>
        <topic href="contexts/RelatedContext1.html"  label="Související heslo nápovědy 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Související heslo nápovědy 2"/>
      </context>
    </contexts>
 

Externalizace řetězců Kontextové soubory XML mohou být přeloženy a výsledná kopie (s přeloženými označeními popisů) by měla být umístěna v adresáři nl/<jazyk>/<země> nebo nl/<jazyk>.  <Jazyk> a <země> představují dvoupísmenné kódy jazyka a země, jaké se používají v kódech národních prostředí.  Například překlady do tradiční čínštiny by měly být umístěny v adresáři nl/zh/TW.  Adresář nl/<jazyk>/<země> má vyšší prioritu než adresář nl/<jazyk>.  Pouze když nebude v adresáři nl/<jazyk>/<země> nalezen žádný soubor, použije se soubor umístěný v adresáři nl/<jazyk>.  Nakonec bude prohledán kořenový adresář modulu plug-in.

Související témata obsažená v doc.zip je možné lokalizovat vytvořením souboru doc.zip s přeloženou verzí dokumentů a tento doc.zip umístit do
adresáře nl/<jazyk>/<země> nebo nl/<jazyk>. Systém nápovědy bude hledat soubory nejprve v těchto adresářích a teprve potom přejde do adresáře modulů plug-in.

Pro použití tohoto bodu rozšíření není třeba žádný kód. Stačí jen dodat odpovídající soubor(y) s manifestem uvedené v souboru plugin.xml.

Volitelná výchozí implementace uživatelského rozhraní systému nápovědy dodávaná s platformou Eclipse plně podporuje bod rozšíření kontextů.