Indice di parole chiave

org.eclipse.help.index

3.2

Per registrare un indice di parola chiave per gli argomenti della guida aggiunti.

<!ELEMENT extension (index*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT index EMPTY>

<!ATTLIST index

file CDATA #REQUIRED>


Di seguito è riportato un esempio di utilizzo del punto di estensione index.

(nel file plugin.xml).

 

<extension point=

"org.eclipse.help.index"

>

<index file=

"index.xml"

/>

</extension>

(nel 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>

Internazionalizzazione È possibile convertire i file index XML e posizionare la copia risultante (con le parole chiave tradotte) nella directory nl/<language>/<country> o nl/<language>. <language> e <country> indicano i codici a due lettere di lingua e paese utilizzati nei codici delle impostazioni internazionali. Ad esempio, le traduzioni in italiano saranno collocate nella directory nl/it/IT. La directory nl/<language>/<country> ha priorità sulla directory nl/<language>. Solo se non viene individuato alcun file in nl/<language>/<country>, saranno utilizzati i file della directory nl/<language>. La directory principale del plugin sarà esaminata per ultima.

Non è richiesto alcun codice per questo punto di estensione. Occorre soltanto fornire i file manifest appropriati, menzionati nel file plugin.xml.

L'implementazione predefinita dell'interfaccia utente del sistema della guida, in dotazione con la piattaforma Eclipse, supporta completamente il punto di estensione index.