Descrizione: per definire la guida sensibile al contesto di un plug-in individuale.
Tag di configurazione:
<!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 plug-in 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/<language>/<country> o nl/<language>. Il sistema
della Guida ricercherà i file in queste directory prima di impostare come predefinita la directory plugin.
Informazione API: per utilizzare questo punto di estensione non è necessario alcun codice. Occorre soltanto fornire il file manifest appropriato, riportato nel file plugin.xml.
Implementazione fornita: l'implementazione predefinita facoltativa dell'interfaccia utente del sistema della guida, in dotazione con la piattaforma Eclipse, supporta completamente il punto di estensione contexts.
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