Contextos

Identificador: org.eclipse.help.contexts

Descripción: permite definir ayuda contextual para un conector individual.

Códigos XML de configuración:

   <!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
   >

Ejemplos: 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).

Información sobre las API: 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.

Implementación suministrada: 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.

Copyright (c) 2000, 2003 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están disponibles bajo los términos de la licencia pública común (Common Public License) v1.0 que acompaña a esta distribución, y está disponible en http://www.eclipse.org/legal/cpl-v10.html