<!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 o conteúdo do ficheiro manifest de contextos:
<!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 ficheiros manifest de contextos facultam todas as informações necessárias quando a ajuda sensível a contextos é solicitada pelo utilizador. O id é transmitido pela plataforma ao sistema de ajuda para identificar o contexto actualmente activo. As definições de contexto com IDs correspondentes são então obtidas. Os IDs no ficheiro manifest não podem conter o carácter de ponto final, dado que os IDs, quando na memória, são exclusivamente identificados pela sequência pluginID.contextID. O objecto IContext é então criado pelo sistema de ajuda que contém as descrições e tópicos de todas as definições de contexto para um ID estabelecido num plug-in. A descrição deve ser apresentada ao utilizador e os tópicos relacionados podem ser úteis ao utilizador para compreender o contexto actual. O tópico relacionado são ficheiros html compactados em doc.zip, juntamente com tópicos que fazem parte de uma ajuda online.
Caso um plugin defina o id de um contexto, é possível expandir a descrição ou ligações relacionadas de um contexto declarando outro contexto com o mesmo id.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(no ficheiro xyzContexts.xml)
<contexts>
<context id="generalContextId">
<description> Esta é uma sequência de ajuda F1 exemplo.</description>
<topic href="contexts/RelatedContext1.html"
label="Tópico 1 Relacionado com a Ajuda"/>
<topic href="contexts/RelatedContext2.html"
label="Tópico 2 Relacionado com a Ajuda"/>
</context>
</contexts>
Os tópicos relacionados contidos num ficheiro doc.zip podem ser localizados criando um ficheiro doc.zip com a versão traduzida de documentos e colocando o doc.zip no directório
nl/<idioma>/<país> ou nl/<idioma>. O sistema de ajuda irá buscar ficheiros nos directórios antes de utilizar o directório predefinido do plugin.
Copyright (c) 2000, 2005 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis sob os termos da Eclipse Public License v1.0, que acompanha esta distribuição, e estão disponíveis em http://www.eclipse.org/legal/epl-v10.html