Ξεκινήσαμε αυτό το παράδειγμα με τη δημιουργία των δικών μας αρχείων πρόσθετης λειτουργίας και εγγράφων. Στη συνέχεια, δημιουργήσαμε αρχεία πίνακα περιεχομένων για την περιγραφή της οργάνωσης του περιεχομένου μας. Η εργασία που υπολείπεται είναι να τα συγκεντρώσουμε όλα σε έναν κύριο πίνακα περιεχομένων και να ενημερώσουμε το αρχείο plugin.xml για την ουσιαστική συνεισφορά του κύριου πίνακα περιεχομένων.
Ξεκινούμε δημιουργώντας ένα toc.xml για τη συνεισφορά των τριών πινάκων περιεχομένων που δημιουργήσαμε αρχικά. Αντί της παροχής ενός href για κάθε θέμα, χρησιμοποιούμε το γνώρισμα link για αναφορά στα υπάρχοντα αρχεία πίνακα περιεχομένων.
<toc label="Online Help Sample" topic="html/book.html"> <topic label="Concepts"> <link toc="toc_Concepts.xml" /> </topic> <topic label="Tasks"> <link toc="toc_Tasks.xml" /> </topic> <topic label="Reference"> <link toc="toc_Ref.xml" /> </topic> </toc>
Στη συνέχεια, ενημερώνουμε το αρχείο plugin.xml για συνεισφορά στον κύριο πίνακα περιεχομένων:
<extension point="org.eclipse.help.toc"> <toc file="toc.xml" primary="true" /> </extension>
Σημειώστε τη χρήση του γνωρίσματος primary. Η ρύθμιση του γνωρίσματος αυτού σε true υποδεικνύει ότι ο πίνακας περιεχομένων πρέπει να εμφανίζεται πάντα στην πλοήγηση, ακόμα και αν δεν έχει παραπομπή από οποιονδήποτε άλλο πίνακα περιεχομένων. Με αυτό τον τρόπο, ο "κύριος" πίνακας περιεχομένων εμφανίζεται σίγουρα στη λίστα θεμάτων. Εμφανίζεται στη λίστα βιβλίων ανώτερου επιπέδου εφόσον κανείς άλλος πίνακας περιεχομένων δεν παραπέμπει σε αυτόν.
Σημείωση: Εάν περισσότερα αρχεία ήταν συσχετισμένα με αυτό τον πίνακα περιεχομένων αλλά δεν ήταν παρόντα στην πλοήγηση και είχαν απλά διασύνδεση από άλλα θέματα, τότε για να είναι διαθέσιμα αυτά τα θέματα στη μηχανή αναζήτησης θα έπρεπε να χρησιμοποιήσουμε το γνώρισμα extradir στον πίνακα περιεχομένων.
Τέλος, συνεισφέρουμε τα μεμονωμένα αρχεία πίνακα περιεχομένων.
<extension point="org.eclipse.help.toc"> <toc file="toc_Concepts.xml" /> <toc file="toc_Tasks.xml" /> <toc file="toc_Reference.xml" /> </extension>
Αυτά τα αρχεία πίνακα περιεχομένων δεν θα εμφανιστούν στη λίστα βιβλίων ανώτερου επιπέδου διότι δεν ορίσαμε το γνώρισμα primary. Τα αρχεία πίνακα περιεχομένων που δεν είναι ορισμένα ως βασικά θα εμφανιστούν στο διαδίκτυο τεκμηρίωσης εάν γίνεται σε αυτά αναφορά από κάποιον πίνακα περιεχομένων που είναι βασικός πίνακας περιεχομένων ή έχει διασύνδεση από βασικό πίνακα περιεχομένων.
Αυτό ήταν! Εάν αντιγράψετε τον κατάλογο πρόσθετης λειτουργίας στον κατάλογο plugins της πλατφόρμας, εκκινήσετε την πλατφόρμα και επιλέξετε Βοήθεια->Περιεχόμενα βοήθειας, θα πρέπει να δείτε το παράδειγμά σας να εμφανίζεται στη λίστα βιβλίων. Εάν πατήσετε στο "Δείγμα ηλεκτρονικής βοήθειας", θα δείτε τη δομή του πίνακα περιεχομένων: