Contextos

org.eclipse.help.contexts

Para definir a ajuda sensível ao conteúdo para um plug-in 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 seguir, um exemplo da utilização do ponto de extensão de contextos:
(no arquivo plugin.xml)

   

<extension point=

"org.eclipse.help.contexts"

>

<contexts file=

"xyzContexts.xml"

/>

</extension>

(no arquivo xyzContexts.xml)

    <contexts>
      <contexto  id="generalContextId">
        <descrição> Esta é uma </descrição> da amostra da cadeia de ajuda F1.
        <topic href="contexts/RelatedContext1.html"  label="Help Related Topic 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Help Related Topic 2"/>
      </context>
    </contexts>
 

Externalizando Cadeias Os arquivos XML de contexto podem ser traduzidos e a cópia resultante (com rótulos de descrições traduzidos) deve ser colocada no diretório nl/<idioma>/<país> ou nl/<idioma>.  <idioma> e <país> significam códigos de idioma e país de duas letras, conforme utilizado em códigos de localidade.  Por exemplo, as traduções do chinês tradicional deverão ser colocadas no diretório nl/zh/TW.  O diretório nl/<idioma>/<país> possui prioridade mais alta que o diretório nl/<idioma>.  Apenas se nenhum arquivo for encontrado no diretório nl/<idioma>/<país>, o arquivo que reside no diretório nl/<idioma> será utilizado.  O diretório raiz de um plugin será pesquisado por último.

Os tópicos relacionados contidos em doc.zip podem ser localizados criando um arquivo doc.zip com a versão traduzida de documentos e colocando o doc.zip no diretório
nl/<idioma>/<país> ou nl/<idioma>. O sistema de ajuda procurará os arquivos nesses diretórios antes de padronizar o diretório de plug-in.

Nenhum código é necessário para utilizar esse ponto de extensão. É necessário apenas fornecer o(s) arquivo(s) manifest adequado(s), mencionado(s) no arquivo plugin.xml.

A implementação padrão opcional da UI do sistema de ajuda fornecida com a plataforma do Eclipse suporta totalmente o ponto de extensão contexts.