<!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>
Kontekstien manifest-tiedostojen merkintärakenne:
<!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 >
Kontekstien manifest-tiedostot sisältävät kaikki tiedot, joita tarvitaan käyttäjän pyytäessä tilannekohtaista ohjetta. Käyttöympäristö välittää ohjejärjestelmän tunnuksen, joka määrittää, missä käyttöyhteydessä (kontekstissa) käyttäjä on pyytänyt ohjetta. Ohjejärjestelmä noutaa tämän jälkeen välitettyä tunnusta vastaavat kontekstimääritykset. Manifest-tiedoston tunnuksissa ei saa käyttää pistettä, koska muistissa niiden tunnuksena käytetään pluginID.contextID-merkkijonoa. Seuraavaksi ohjejärjestelmä luo IContext-objektin, joka sisältää kaikki ne lisäosan kontekstimääritysten kuvaukset ja ohjeaiheet, jotka vastaavat määritettyä tunnusta. Kuvaus näytetään käyttäjälle ja aiheeseen liittyvien ohjeaiheiden avulla käyttäjä voi syventää tietojaan kontekstista, jossa hän teki ohjepyynnön. Aiheeseen liittyvät ohjeaiheet ovat HTML-tiedostoja, jotka on pakattu doc.zip-tiedostoon yhdessä käytönaikaisen ohjeen ohjeaiheiden kanssa.
Lisäosaan määritettyjen kontekstitunnuksien kuvauksia ja liittyviä linkkejä voidaan laajentaa määrittämällä toinen konteksti, jolla on sama tunnus.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(Määritystiedosto xyzContexts.xml)
<contexts>
<context id="generalContextId">
<description> Tämä
on F1-ohjeen mallimerkkijono.</description>
<topic href="contexts/RelatedContext1.html"
label="Ohjeeseen liittyvä aihe 1"/>
<topic href="contexts/RelatedContext2.html"
label="Ohjeeseen liittyvä aihe 2"/>
</context>
</contexts>
Doc.zip-arkistotiedoston sisältämät aiheeseen liittyvät ohjeaiheet voidaan lokalisoida luomalla
doc.zip-tiedostosta käännetyt asiakirjat sisältävä versio ja tallentamalla se
nl/<kieli>/<maa>- tai nl/<kieli>-hakemistoon. Ohjejärjestelmä
etsii tiedostoja ensin näistä hakemistoista ja viimeisenä oletusarvoisesta
lisäosan hakemistosta.
Copyright (c) 2000, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html