Επέκταση περιεχομένου βοήθειας

org.eclipse.help.contentExtension

Αυτό το σημείο επέκτασης προορίζεται για την υποστήριξη δυναμικού και επαναχρησιμοποιήσιμου περιεχομένου στις σελίδες του συστήματος βοήθειας. Επιτρέπει τη συνεισφορά περιεχόμενου σε μια υπάρχουσα σελίδα συστήματος βοήθειας. Οποιαδήποτε σελίδα XHTML στο σύστημα βοήθειας μπορεί να "δηλώσει" ότι αποδέχεται συνεισφορές περιεχομένου καθορίζοντας ρητά αυτά τα σημεία επέκτασης, χρησιμοποιώντας ένα στοιχείο anchor. Τα τμήματα κώδικα XHTML μπορούν στη συνέχεια να εισαχθούν δυναμικά σε αυτά τα έγγραφα κατά το χρόνο εκτέλεσης.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Καθορίζει την επέκταση περιεχόμενου σε μία ή περισσότερες σελίδας συστήματος βοήθειας. Η θέση του αρχείου επέκτασης περιεχομένου καθορίζεται από το γνώρισμα file.



Παρακάτω δίνεται ένα παράδειγμα χρήσης του σημείου επέκτασης contentExtension.

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

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

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

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

"org.xxx.yyy.somePluginId/xhtml/someHelpPage.xhtml/topicAnchor"

/>

</contentExtension>

Η παραπάνω συνεισφορά εισάγει το περιεχόμενο του αρχείου XHTML, topicA.xhtml, στη σελίδα προορισμού του συστήματος βοήθειας που καθορίζεται από το γνώρισμα path. Σε αυτή την περίπτωση, η επέκταση περιεχομένου θα εισαχθεί στη θέση ενός σημείου αγκύρωσης που ονομάζεται topicAnchor στη σελίδα someHelpPage.xhtml στην πρόσθετη λειτουργία org.xxx.yyy.somePluginId.

Η παραπάνω συνεισφορά εισάγει το περιεχόμενο του αρχείου XHTML, topicA.xhtml, στη σελίδα προορισμού του συστήματος βοήθειας που καθορίζεται από το γνώρισμα path. Σε αυτή την περίπτωση, η επέκταση περιεχομένου θα εισαχθεί στη θέση ενός σημείου αγκύρωσης που ονομάζεται topicAnchor στη σελίδα someHelpPage.xhtml στην πρόσθετη λειτουργία org.xxx.yyy.somePluginId.

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

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