Индекс ключевых слов

org.eclipse.help.index

3.2

Для регистрации индекса ключевых слов для дополняемого содержимого справки.

<!ELEMENT extension (index*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT index EMPTY>

<!ATTLIST index

file CDATA #REQUIRED>


Ниже приведен пример использования точки расширения индекса.

(в файле 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>. Последним просматривается корневой каталог модуля.

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

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