<!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>
Описание конфигурации содержимого файла манифеста контекстов:
<!ELEMENT contexts (context)* ) >
<!ELEMENT context (description?,topic*) >
<!ATTLIST context id ID #REQUIRED >
<!ELEMENT description (#PCDATA)>
<!ELEMENT topic EMPTY >
<!ATTLIST topic label CDATA #REQUIRED >
<!ATTLIST topic href CDATA #IMPLIED >
Файлы манифеста контекстов предоставляют всю информацию, необходимую при запросе контекстной справки пользователем. Платформа передает идентификатор для определения текущего активного контекста. Затем извлекаются определения контекста с соответствующими идентификаторами. Идентификаторы в файле манифеста, не должны содержать в себе точку, т.к. они могут объединяться с другими идентификаторами, в частности, с идентификаторами модулей, к которым они принадлежат. Затем справочная система создает объект IContext, содержащий описания и разделы из всех определений контекста с заданным идентификатором. Описание предназначено для показа пользователю, и связанные разделы могут помочь пользователю понять текущий контекст. Связанный раздел - это файлы html, упакованные в doc.zip, вместе с разделами электронной справки.
Если модуль определяет несколько идентификаторов контекста, то можно расширить описание или связанные ссылки контекста, объявив другой контекст с тем же идентификатором.
<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>
Связанные разделы, содержащиеся в doc.zip, можно перевести на нужный
язык, создав файл doc.zip с переведенными документами и поместив его в
каталог
nl/<language>/<country> или nl/<language>. Справочная система
выполнит поиск файлов в этих каталогах до того, как по умолчанию обратится
к каталогу модуля.
Copyright (c) 2000, 2003 IBM Corporation и другие.
Все права защищены. Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте
http://www.eclipse.org/legal/epl-v10.html