Τώρα που έχουμε τα δείγματα αρχείων περιεχομένου, μπορούμε να δημιουργήσουμε ένα αρχείο πίνακα περιεχομένων (toc). Κάθε αρχείο πίνακα περιεχομένων ορίζει τα σημεία καταχώρησης κλειδιών στα αρχεία περιεχομένου HTML με την αντιστοίχιση της τοπικής ετικέτας με μια παραπομπή σε ένα από τα αρχεία HTML.
Οι εφαρμογές που μεταβιβάζονται στην πλατφόρμα μπορούν να αξιοποιήσουν εκ νέου την υπάρχουσα τεκμηρίωση χρησιμοποιώντας το αρχείο πίνακα περιεχομένου για τον ορισμό των σημείων καταχώρησης στην τεκμηρίωση αυτή.
Μια πρόσθετη λειτουργία μπορεί να έχει ένα ή περισσότερα αρχεία πίνακα περιεχομένων. Το παράδειγμα τεκμηρίωσης είναι οργανωμένο σε τρεις κύριες κατηγορίες: έννοιες, εργασίες και παραπομπές. Πώς δημιουργούμε αρχεία πίνακα περιεχομένων που αναπαριστούν τη δομή αυτή;
Θα μπορούσαμε να δημιουργήσουμε ένα μεγάλο αρχείο πίνακα περιεχομένων ή ένα ξεχωριστό αρχείο πίνακα περιεχομένων για κάθε κύρια κατηγορία περιεχομένου. Αυτή η απόφαση θα εξαρτηθεί από τον τρόπο που συνεργάζονται οι ομάδες τεκμηρίωσης. Σε περίπτωση που ο συγγραφέας είναι διαφορετικός για κάθε κατηγορία, είναι προτιμότερο να διατηρήσετε ξεχωριστά αρχεία πίνακα περιεχομένων . Αυτό δεν υπαγορεύεται από την αρχιτεκτονική της πλατφόρμας.
Στο παράδειγμα αυτό, θα δημιουργήσουμε ένα αρχείο πίνακα περιεχομένων για κάθε κύρια κατηγορία περιεχομένου. Για τόσο μικρό αριθμό αρχείων, η τήρηση ξεχωριστών αρχείων πίνακα περιεχομένων ίσως δεν είναι απαραίτητη. Θα δομήσουμε το παράδειγμα αυτό σαν να είχαμε πολύ περισσότερα αρχεία ή κάθε μία κατηγορία περιεχομένου να ανήκε σε ξεχωριστό συγγραφέα.
Τα αρχεία πρέπει έχουν την παρακάτω εικόνα:
<toc label="Concepts"> <topic label="Concept1" href="html/concepts/concept1.html"> <topic label="Concept1_1" href="html/concepts/concept1_1.html"/> <topic label="Concept1_2" href="html/concepts/concept1_2.html"/> </topic> </toc>
<toc label="Tasks"> <topic id="plainTasks" label="Plain Stuff"> <topic label="Task1" href="html/tasks/task1.html"/> <topic label="Task2" href="html/tasks/task2.html"/> </topic> <topic id="funTasks" label="Fun Stuff" > <topic label="Task3_1" href="html/tasks/task3_1.html"/> <topic label="Task3_2" href="html/tasks/task3_2.html"/> </topic> </toc>
<toc label="Reference"> <topic label="Ref1" href="html/ref/ref1.html"/> <topic label="Ref2" href="html/ref/ref2.html"/> </toc>
Ένα θέμα μπορεί να είναι μια απλή διασύνδεση σε περιεχόμενο. Για παράδειγμα, η "Task1" παρέχει ένα γνώρισμα label και ένα href που διασυνδέει στο περιεχόμενο. Ένα θέμα μπορεί επίσης να είναι μια ιεραρχική ομαδοποίηση υποθεμάτων χωρίς δικό του περιεχόμενο. Για παράδειγμα. η "Fun Stuff" έχει μόνο ένα γνώρισμα label και υποθέματα, χωρίς href . Τα θέματα μπορούν να τα κάνουν επίσης και τα δύο. Η "Concept1" έχει ένα href και υποθέματα.
Δυναμικό περιεχόμενο
Το δυναμικό περιεχόμενο διατίθεται για τον πίνακα περιεχομένων με τη μορφή φίλτρων και σημείων αγκύρωσης. Για παράδειγμα, μπορεί να θέλετε να εμφανίζεται ένα θέμα στον πίνακα περιεχομένων μόνο όταν εκτελείται σε συγκεκριμένο λειτουργικό σύστημα.
Τα στοιχεία Include δεν υποστηρίζονται εδώ, επειδή δε χρειάζονται. ΑντΆ αυτών, χρησιμοποιήστε τις διασυνδέσεις.