<!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>
Tag di configurazione per il contenuto nel file manifest:
<!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
>
I file manifest dell'estensione contexts forniscono tutte le informazioni necessarie quando la guida sensibile al contesto viene richiesta dall'utente. L'id viene trasferito dalla piattaforma al sistema della guida in modo da identificare il contesto attualmente attivo. Le definizioni di contesto con ID corrispondenti sono successivamente richiamate. Gli ID nel file manifest non devono contenere il carattere punto, dal momento che gli ID sono identificati univocamente dalla stringa pluginID.contextID quando si trovano in memoria. L'oggetto IContext viene quindi creato dal sistema della guida che contiene descrizioni e argomenti di tutte le definizioni di contesto per un determinato ID in un plugin. La descrizione verrà visualizzata all'utente e gli argomenti correlati possono essere utili per comprendere il contesto corrente. Gli argomenti correlati sono costituiti da file HTML in pacchetti doc.zip forniti insieme agli argomenti che fanno parte della Guida in linea.
Se un plugin definisce alcuni id di contesto, la descrizione o i collegamenti correlati di un contesto possono essere estesi dichiarando un altro contesto con lo stesso id.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(nel file xyzContexts.xml)
<contexts>
<context id="generalContextId">
<description> This
is a sample F1 help string.</description>
<topic href="contexts/RelatedContext1.html"
label="Help Related Topic 1"/>
<topic href="contexts/RelatedContext2.html"
label="Help Related Topic 2"/>
</context>
</contexts>
È possibile localizzare gli argomenti correlati contenuti nel pacchetto doc.zip mediante la creazione di un file doc.zip con la versione convertita dei documenti da posizionare nella directory
nl/<lingua>/<paese> o nl/<lingua>. Il sistema
della Guida ricercherà i file in queste directory prima di impostare come predefinita la directory plugin.
Copyright (c) 2000, 2003 IBM Corporation e altri.
Tutti i diritti riservati. Questo programma e il materiale di accompagnamento sono disponibili secondo i termini della Eclipse Public
License v1.0 che sono distribuiti con il prodotto, e disponibili all'indirizzo
http://www.eclipse.org/legal/epl-v10.html