<!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>
Marcação de Configuração para informações contidas no arquivo manifest de contexto:
<!ELEMENT contexts (context)* ) >
<!ELEMENT context (description?,topic*) >
<!ATTLIST context id ID #REQUIRED >
<!ELEMENT description (#PCDATA)>
<!ELEMENT topic EMPTY >
<!ATTLIST topic label CDATA #REQUIRED >
<!ATTLIST topic href CDATA #IMPLIED >
Os arquivos manifest de contextos fornecem todas as informações necessárias quando um auxílio dependente de contexto é solicitado pelo usuário. O ID é transmitido pela plataforma para o sistema de ajuda identificar o contexto ativo atual. Em seguida, as definições do contexto com IDs correspondentes são recuperadas. Os IDs no arquivo de manifesto não devem conter o caractere ponto, pois os IDs são identificados exclusivamente pela cadeia pluginID.contextID quando estão na memória. Em seguida, o objeto IContext é criado pelo sistema de ajuda que contém descrições e tópicos de todas as definições do contexto para um ID fornecido em um plug-in. A descrição será exibida para o usuário e os tópicos relacionados poderão ser úteis para que o usuário entenda o contexto atual. Tópicos relacionados são arquivos html compactados em doc.zip, juntos com os tópicos que fazem parte da ajuda on-line.
Se um plug-in definir um id de contexto, o usuário poderá estender a descrição ou os links relacionados a um contexto declarando outro contexto com o mesmo id.
<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>
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.
Direitos Autorais (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 Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html