Контексты

org.eclipse.help.contexts

Предназначена для определения контекстной справки для отдельного модуля.

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


Ниже приведен пример применения точки расширения контекстов:
(в файле plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(в файле xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description> Это пример справочной строки, выдаваемой при нажатии F1.</description>
        <topic href="contexts/RelatedContext1.html"  label="Связанный раздел справки номер 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Связанный раздел справки номер 2"/>
      </context>
    </contexts>
 

Экспорт строк XML-файлы контекста можно перевести на другие языки; полученную копию (с переведенными метками описаний) следует поместить в каталог nl/<language>/<country> или nl/<language>.   <language> и <country> обозначают двухбуквенные коды языка, используемые в кодах локалей.   Например, перевод на китайский язык (КНР) следует поместить в каталог nl/zh/TW.   Каталог nl/<language>/<country> имеет более высокий приоритет, чем каталог nl/<language>.   Файл в nl/<language> используется только в том случае, если не найден файл в nl/<language>/<country>.   Последним просматривается корневой каталог модуля.

Связанные разделы, содержащиеся в doc.zip, можно перевести на нужный язык, создав файл doc.zip с переведенными документами и поместив его в каталог
nl/<language>/<country> или nl/<language>. Справочная система выполнит поиск файлов в этих каталогах до того, как по умолчанию обратится к каталогу модуля.

Для использования этой точки расширения какой-либо дополнительный код не требуется. Достаточно предоставить соответствующий файл (или файлы) манифеста, указанный в файле plugin.xml.

Дополнительная реализация по умолчанию UI справочной системы, поставляемая в платформе Eclipse, полностью поддерживает точку расширения contexts.