Nøgleordsindeks

org.eclipse.help.index

3.2

Til registrering af et nøgleordsindeks til leveret hjælpeindhold

<!ELEMENT extension (index*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT index EMPTY>

<!ATTLIST index

file CDATA #REQUIRED>


Det følgende er et eksempel på brug af et udvidelsespunkt for stikordsregister

(i filen plugin.xml)

 

<udvidelsespunkt=

"org.eclipse.help.index"

>

<registerfil

"index.xml"

/>

</extension>

(i filen register.xml)

<Stikordsregister>
    <entry keyword="Køretøj">
        <topic href="fortegnelse_over_hjul"/>
        <entry keyword="Bil">
            <topic href="bil.html"/>
        </entry>
        <entry keyword="Skib">
            <topic href="skib.html"/>
        </entry>
        <entry keyword="Fly">
            <topic href="fly.html" title="Luftfartens historie"/>
            <topic href="jet.html" title="Jetmotor"/>
        </entry>
    </entry>
    <entry keyword="Motor">
        <entry keyword="Hest">
            <topic href="hest.html"/>
        </entry>
        <entry keyword="Dampskib">
            <topic href="dampskib.html"/>
        </entry>
        <entry keyword="Wankelmotor">
            <topic href="wankel.html"/>
        </entry>
        <entry keyword="Jetmotor">
            <topic href="jet.html"/>
        </entry>
    </entry>
    <entry keyword="Elektricitet">
        <topic href="elektricitet.html"/>
    </entry>
</index>

Internationalisering XML-registerfilen kan konverteres, og den resulterende kopi med konverterede nøgleord skal placeres i biblioteket nl/<sprog>/<land> eller nl/<sprog>. <sprog> og <land> står for en lande- og sprogkode på to bogstaver som i sprogkonventioner. F.eks. skal traditionelt kinesisk placeres i biblioteket nl/zh/TW. Biblioteket nl/<sprog>/<land> har en højere prioritet end /<sprog>. Kun hvis der ikke findes en fil i nl/<sprog>/<land>, anvendes nl/<sprog>. Rodbiblioteket for en plugin søges der i til sidst.

Der kræves ingen kode for at anvende dette udvidelsespunkt. Det eneste, du skal levere, er den relevante manifestfil omtalt i plugin.xml-filen.

Standardimplementeringen af brugergrænsefladen til hjælpen, der leveres sammen med Eclipse-platformen, understøtter udvidelsespunktet til stikordsregister.