Konteksty

org.eclipse.help.contexts

Punkt rozszerzenia służący do definiowania pomocy kontekstowej dla określonego modułu dodatkowego.

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


Poniżej przedstawiono przykład punktu rozszerzenia kontekstów:
(w pliku plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(w pliku xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description> To jest przykładowy tekst pomocy powiązany z klawiszem F1.</description>
        <topic href="contexts/RelatedContext1.html"  label="Temat pokrewny 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Temat pokrewny 2"/>
      </context>
    </contexts>
 

Eksternalizacja łańcuchów Pliki XML kontekstu można przetłumaczyć, a wynikową kopię (z przetłumaczonymi etykietami opisów) umieścić w katalogu nl/<język>/<kraj> lub nl/<język>. Oznaczenia <język> i <kraj> reprezentują dwuliterowe kody kraju i języka używane w oznaczeniach ustawień narodowych. Na przykład tłumaczenia na język chiński tradycyjny należy umieścić w katalogu nl/zh/TW. Katalog nl/<język>/<kraj> ma wyższy priorytet niż nl/<język>. Tylko gdy w katalogu nl/<język>/<kraj> nie zostanie znaleziony żaden plik, użyty zostanie plik znajdujący się w katalogu nl/<język>. Katalog główny modułu dodatkowego zostanie przeszukany na samym końcu.

Tematy pokrewne zawarte w pliku doc.zip można zlokalizować przez utworzenie pliku doc.zip z przetłumaczonymi wersjami dokumentów i umieszczenie go w katalogu
nl/<język>/<kraj> lub nl/<język>. System pomocy będzie wyszukiwać pliki w tych katalogach przed domyślnym katalogiem modułu dodatkowego.

Do korzystania z tego punktu rozszerzenia nie jest potrzebny żaden kod. Wystarczy jedynie dostarczyć odpowiedni plik lub pliki manifestu wymienione w pliku plugin.xml.

Opcjonalna domyślna implementacja interfejsu użytkownika systemu pomocy dostarczanego wraz z platformą Eclipse obsługuje w pełni punkt rozszerzenia contexts.