<!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 in modo da identificare il contesto correntemente attivo, Le definizioni del contesto vengono quindi recuperate insieme agli ID corrispondenti. 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. La descrizione deve essere visualizzata dall'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 Common Public License v1.0 che sono
distribuiti con il prodotto, e disponibili all'indirizzo
http://www.eclipse.org/legal/cpl-v10.html