Índice de palabras clave

org.eclipse.help.index

3.2

Para registrar un índice de palabras clave del contenido de la ayuda contribuido.

<!ELEMENT extension (index*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT index EMPTY>

<!ATTLIST index

file CDATA #REQUIRED>


A continuación figura un ejemplo de utilización del punto de extensión index.

(en el archivo plugin.xml)

 

<extension point=

"org.eclipse.help.index"

>

<index file=

"index.xml"

/>

</extension>

(en el archivo index.xml)

<index>
    <entry keyword="Vehículo">
        <topic href="invento_de_rueda.html"/>
        <entry keyword="Coche">
            <topic href="coche.html"/>
        </entry>
        <entry keyword="Barco">
            <topic href="barco.html"/>
        </entry>
        <entry keyword="Avión">
            <topic href="avión.html" title="Historia de la aviación"/>
            <topic href="reactor.html" title="Motor a reacción"/>
        </entry>
    </entry>
    <entry keyword="Motor">
        <entry keyword="Caballo">
            <topic href="caballo.html"/>
        </entry>
        <entry keyword="Vapor">
            <topic href="vapor.html"/>
        </entry>
        <entry keyword="Motor Wankel">
            <topic href="wankel.html"/>
        </entry>
        <entry keyword="Motor a reacción">
            <topic href="reactor.html"/>
        </entry>
    </entry>
    <entry keyword="Electricidad">
        <topic href="electricidad.html"/>
    </entry>
</index>

Internacionalización Los archivos XML pueden traducirse y la copia resultante (con las palabras clave traducidas) debe colocarse en el directorio nl/<idioma>/<país> o nl/<idioma>. <idioma> y <país> corresponden a códigos de idioma y país de dos letras utilizados en los códigos de entorno local. Por ejemplo, las traducciones al Chino tradicional deben colocarse en el directorio nl/zh/TW. El directorio nl/<idioma>/<país> tiene una prioridad más alta que el directorio nl/<idioma>. Sólo se utilizará el archivo que resida en el directorio nl/<idioma> si no se encuentra ningún archivo en el directorio nl/<idioma>/<país>. En último lugar, se buscará en el directorio raíz de un plug-in.

No se necesita código adicional para utilizar este punto de extensión. Tan solo hay que suministrar los archivos de manifiesto apropiados que se mencionan en el archivo plugin.xml.

El punto de extensión index está totalmente soportado por la implementación por omisión de la UI del sistema de ayuda que se proporciona con la plataforma Eclipse.