Keyword Index

org.eclipse.help.index

3.2

Για την καταχώρηση ενός ευρετηρίου με λέξεις-κλειδιά για περιεχόμενο βοήθειας που έχει προκύψει από συνεισφορά.

<!ELEMENT extension (index*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT index EMPTY>

<!ATTLIST index

file CDATA #REQUIRED>


Ακολουθεί ένα παράδειγμα χρήσης του σημείου επέκτασης ευρετηρίου.

(σε αρχείο plugin.xml)

 

<extension point=

"org.eclipse.help.index"

>

<index file=

"index.xml"

/>

</extension>

(σε αρχείο index.xml)

<index>
    <entry keyword="Vehicle">
        <topic href="inventory_of_wheel.html"/>
        <entry keyword="Car">
            <topic href="car.html"/>
        </entry>
        <entry keyword="Ship">
            <topic href="ship.html"/>
        </entry>
        <entry keyword="Airplane">
            <topic href="airplane.html" title="History of aviation"/>
            <topic href="jet.html" title="Jet engine"/>
        </entry>
    </entry>
    <entry keyword="Engine">
        <entry keyword="Horse">
            <topic href="horse.html"/>
        </entry>
        <entry keyword="Steamer">
            <topic href="steamer.html"/>
        </entry>
        <entry keyword="Wankel engine">
            <topic href="wankel.html"/>
        </entry>
        <entry keyword="Jet engine">
            <topic href="jet.html"/>
        </entry>
    </entry>
    <entry keyword="Electricity">
        <topic href="electricity.html"/>
    </entry>
</index>

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

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

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