Περιβάλλοντα

org.eclipse.help.contexts

Για τον ορισμό συμφραστικής βοήθειας για μια μεμονωμένη πρόσθετη λειτουργία.

<!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:
(σε αρχείο plugin.xml)

   

<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>
 

Τοπική προσαρμογή σειρών χαρακτήρων Τα XML αρχεία περιβάλλοντος μπορούν να μεταφραστούν και το αντίγραφο που προκύπτει (με μεταφρασμένες ετικέτες περιγραφής) θα πρέπει να τοποθετείται στον κατάλογο nl/<language>/<country> ή nl/<language>.  Τα <language> και <country> θα είναι κωδικοί δύο γραμμάτων για τη γλώσσα και τη χώρα, όπως χρησιμοποιούνται στους κωδικούς τοπικών ρυθμίσεων.   Για παράδειγμα, οι μεταφράσεις σε παραδοσιακή κινεζική θα πρέπει να τοποθετηθούν στον κατάλογο nl/zh/TW.  Ο κατάλογος nl/<language>/<country> έχει υψηλότερη προτεραιότητα από τον κατάλογο nl/<language>.  Εάν δεν βρεθεί το αρχείο του καταλόγου nl/<language>/<country>, μόνο τότε θα χρησιμοποιηθεί το αρχείο του καταλόγου nl/<language>.  Η αναζήτηση στον κεντρικό κατάλογο μιας πρόσθετης λειτουργίας θα πραγματοποιηθεί τελευταία.

Τα σχετικά θέματα που περιέχονται στο doc.zip μπορούν να τροποποιηθούν τοπικά σε ένα αρχείο doc.zip με μεταφρασμένη έκδοση των εγγράφων και το doc.zip να τοποθετηθεί στον κατάλογο
nl/<language>/<country> ή nl/<language>. Το σύστημα βοήθειας θα αναζητά τα αρχεία των καταλόγων αυτών, πριν πραγματοποιήσει αναζήτηση στον προεπιλεγμένο κατάλογο της πρόσθετης λειτουργίας.

Δεν απαιτείται κάποιος κωδικός για τη χρήση του συγκεκριμένου σημείου επέκτασης. Το μόνο που χρειάζεται είναι η παροχή των κατάλληλων αρχείων δήλωσης που αναφέρονται στο αρχείο plugin.xml.

Η προαιρετική προεπιλεγμένη υλοποίηση του περιβάλλοντος χρήστη συστήματος βοήθειας που παρέχεται μαζί με την πλατφόρμα Eclipse υποστηρίζει πλήρως το σημείο επέκτασης contexts.