Contextos

Identificador: org.eclipse.help.contexts

Descrição: Define o auxílio dependente de contexto para um plug-in individual.

Marcação da Configuração:

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

Exemplos: A seguir, um exemplo de 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 nestes diretórios antes de assumir como padrão o diretório do plug-in.

Informações de API: Não é necessário nenhum código para utilizar esse ponto de extensão. É necessário apenas fornecer o(s) arquivo(s) manifest adequado(s), mencionado(s) no arquivo plugin.xml.

Implementação Fornecida: A implementação padrão opcional do sistema de ajuda da UI fornecido com a plataforma Eclipse suporta completamente o ponto de extensão contexts.

Copyright (c) 2000, 2003 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham são disponibilizados sob os termos da Common Public License v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/cpl-v10.html