Contextos

org.eclipse.help.contexts

Permite definir ayuda contextual para un conector individual.

<!ELEMENT extension (contexts*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contexts EMPTY>

<!ATTLIST contexts

file   CDATA #REQUIRED

plugin CDATA #IMPLIED>


A continuación figura un ejemplo de utilización del punto de extensión de contextos:
(en el archivo plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(en el archivo xyzContexts.xml)

    <contexts>
      <context  id="generalContextId">
        <description> Esta es una serie de ayuda F1 de ejemplo.</description>
        <topic href="contexts/RelatedContext1.html"  label="Tema 1 relacionado con la ayuda"/>
        <topic href="contexts/RelatedContext2.html"  label="Tema 2 relacionado con la ayuda"/>
      </context>
    </contexts>
 

Externalizar series Los archivos XML de contexto pueden traducirse y la copia resultante (con las etiquetas de las descripciones 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 conector.

Los temas relacionados que hay en un archivo doc.zip se pueden adaptar al entorno local creando un archivo doc.zip que tenga la versión traducida de los documentos y colocando el archivo doc.zip en
el directorio nl/<idioma>/<país> o nl/<idioma>. El sistema de ayuda buscará los archivos en estos directorios antes de tomar por omisión el directorio plugin (de conectores).

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 contexts está totalmente soportado por la implementación opcional por omisión de la UI del sistema de ayuda que se proporciona con la plataforma Eclipse.