<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT index EMPTY>
<!ATTLIST index
file CDATA #REQUIRED>
Описание конфигурации файла индекса:
<!ELEMENT index (entry)* >
<!ELEMENT entry (entry | topic)* >
<!ATTLIST entry keyword CDATA #REQUIRED >
<!ELEMENT topic EMPTY >
<!ATTLIST topic href CDATA #REQUIRED >
<!ATTLIST topic title CDATA #IMPLIED >
Элемент index
Элемент index представляет экземпляр индекса. Индекс состоит из записей, каждая из которых соответствует определенному ключевому слову. Все дополняемые индексы объединяются в один главный индекс, который предоставляется пользователю справочной системой. При построении индекса записи добавляются в алфавитном порядке.
Элемент entry
Элемент entry представляет ключевое слово индекса. Каждая запись может содержать несколько ссылок на разделы справки, связанные с этим ключевым словом. Запись может также являться контейнером для других записей (вложенных записей) для формирования иерархии ключевых слов. Это позволяет записи являться контейнером для вложенных записей и одновременно иметь разделы.
Элемент topic
Элемент topic предоставляет ссылку на содержимое справки, связанное с данным ключевым словом. Атрибут href указывается относительно модуля, которому принадлежит файл манифеста. Если вам необходимо указать файл в другом модуле, воспользуйтесь следующим форматом:
<topic label="раздел в другом модуле" href="../other.plugin.id/concepts/some_other_file.html">
Атрибут title применяется для именования ссылки на содержимое справки, если несколько разделов связаны с с одним ключевым словом. Если этот атрибут не указан, то заголовок берется из оглавления, которому принадлежит ссылка. Если ссылка не принадлежит ни оному оглавлению, то необходимо указать атрибут title. В противном случае заголовок останется неопределенным.
(в файле plugin.xml)
<extension point=
"org.eclipse.help.index"
>
<index file=
"index.xml"
/>
</extension>
(in file index.xml)
<index>
<entry keyword="Vehicle">
<topic href="inventory_of_wheel.html"/>
<entry keyword="Car">
<topic href="car.html"/>
</entry>
<entry keyword="Ship">
<topic href="ship.html"/>
</entry>
<entry keyword="Airplane">
<topic href="airplane.html" title="History of aviation"/>
<topic href="jet.html" title="Jet engine"/>
</entry>
</entry>
<entry keyword="Engine">
<entry keyword="Horse">
<topic href="horse.html"/>
</entry>
<entry keyword="Steamer">
<topic href="steamer.html"/>
</entry>
<entry keyword="Wankel engine">
<topic href="wankel.html"/>
</entry>
<entry keyword="Jet engine">
<topic href="jet.html"/>
</entry>
</entry>
<entry keyword="Electricity">
<topic href="electricity.html"/>
</entry>
</index>
Экспорт строк XML-файлы оглавления можно перевести на другие языки; полученную копию (с переведенными ключевыми словами) следует поместить в каталог nl/<language>/<country> или nl/<language>. <language> и <country> обозначают двухбуквенные коды языка, используемые в кодах локалей. Например, перевод на китайский язык (КНР) следует поместить в каталог nl/zh/TW. Каталог nl/<language>/<country> имеет более высокий приоритет, чем каталог nl/<language>. Файл в nl/<language> используется только в том случае, если не найден файл в nl/<language>/<country>. Последним просматривается корневой каталог модуля.
Copyright (c) 2006 Intel Corporation и других фирм.
Все права защищены.
Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте
http://www.eclipse.org/legal/epl-v10.html