<!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>
Μορφοποίηση ρυθμίσεων για τα περιεχόμενα του αρχείου δήλωσης contexts:
<!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 >
Τα αρχεία δήλωσης contexts παρέχουν όλες τις πληροφορίες που είναι απαραίτητες όταν ο χρήστης υποβάλλει ένα αίτημα συμφραστικής βοήθειας. Η ταυτότητα μεταβιβάζεται από την πλατφόρμα στο σύστημα βοήθειας για τον προσδιορισμό του τρέχοντος ενεργού περιβάλλοντος. Στη συνέχεια, ανακτώνται οι ορισμοί περιβάλλοντος των οποίων οι ταυτότητες συμφωνούν με τα κριτήρια. Οι ταυτότητες στο αρχείο δήλωσης δεν πρέπει να περιέχουν τελείες, καθώς οι ταυτότητες προσδιορίζονται με μοναδικό τρόπο από τη σειρά χαρακτήρων pluginID.contextID, όταν βρίσκονται στη μνήμη. Στη συνέχεια το σύστημα βοήθειας δημιουργεί το αντικείμενο IContext, το οποίο περιέχει περιγραφές και θέματα από όλους τους ορισμούς περιβάλλοντος για μια δεδομένη ταυτότητα σε μια πρόσθετη λειτουργία. Η περιγραφή εμφανίζεται στον χρήστη και τα σχετικά θέματα βοηθούν τον χρήστη στην κατανόηση του τρέχοντος περιβάλλοντος. Τα σχετικά θέματα είναι αρχεία html που συμπεριλαμβάνονται σε ένα doc.zip, μαζί με θέματα που ανήκουν στην ηλεκτρονική βοήθεια.
Εάν μια πρόσθετη λειτουργία ορίζει κάποιες ταυτότητες περιβάλλοντος, μπορεί κανείς να επεκτείνει την περιγραφή ή τις σχετικές διασυνδέσεις για ένα περιβάλλον, δηλώνοντας ένα άλλο περιβάλλον με την ίδια ταυτότητα.
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(σε αρχείο 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>
Τα σχετικά θέματα που περιέχονται στο doc.zip μπορούν να τροποποιηθούν τοπικά σε ένα αρχείο doc.zip με μεταφρασμένη έκδοση των εγγράφων και το doc.zip να τοποθετηθεί στον κατάλογο
nl/<language>/<country> ή nl/<language>. Το σύστημα βοήθειας θα αναζητά τα αρχεία των καταλόγων αυτών, πριν πραγματοποιήσει αναζήτηση στον προεπιλεγμένο κατάλογο της πρόσθετης λειτουργίας.
Copyright (c) 2000, 2005 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.