Nyt kun mallisisältötiedostot ovat käytettävissä, voidaan luoda sisällysluettelotiedosto (toc). Sisällysluettelotiedosto määrittää yhteydet HTML-sisältötiedostoihin määrittämällä aiheen nimikkeen vastaavuuden jossakin HTML-tiedostossa olevaan viittaukseen.
Ympäristöön siirrettävät sovellukset voivat käyttää aiemmin luotua dokumentaatiota määrittämällä dokumentaation linkkikohdat sisällysluettelotiedoston avulla.
Lisäosassa voi olla yksi tai useita sisällysluettelotiedostoja. Esimerkkidokumentaatio on järjestetty kolmeen pääluokkaan: käsitteet, tehtävät ja ohjeet. Kuinka sisällysluettelotiedostot saadaan vastaamaan tätä rakennetta?
On mahdollista tehdä yksi suuri sisällysluettelotiedosto tai luoda erillinen sisällysluettelotiedosto sisällön kutakin pääluokkaa varten. Tämä päätös kannattaa tehdä sen mukaan, kuinka dokumentaatiotyöryhmät työskentelevät keskenään. Jos kunkin luokan omistaa eri kirjoittaja, voi olla suositeltavaa pitää kussakin luokassa erillinen sisällysluettelotiedosto. Ympäristön arkkitehtuuri ei määrää sitä.
Tässä esimerkissä luodaan sisällysluettelotiedosto sisällön kullekin pääluokalle. Koska tiedostoja on niin vähän, erilliset sisällysluettelot eivät välttämättä olisi tarpeen. Tämä esimerkki toteutetaan ikään kuin tiedostoja olisi huomattavasti useampia tai mukana olisi useita kirjoittajia, joista kukin omistaa eri sisältöluokan.
Tiedostot näyttävät seuraavilta:
<toc label="Käsitteet"> <topic label="Käsite1" href="html/concepts/concept1.html"> <topic label="Käsite1_1" href="html/concepts/concept1_1.html"/> <topic label="Käsite1_2" href="html/concepts/concept1_2.html"/> </topic> </toc>
<toc label="Tehtävät"> <topic id="plainTasks" label="Tavallista sisältöä"> <topic label="Tehtävä1" href="html/tasks/task1.html"/> <topic label="Tehtävä2" href="html/tasks/task2.html"/> </topic> <topic id="funTasks" label="Kiinnostavaa sisältöä" > <topic label="Tehtävä3_1" href="html/tasks/task3_1.html"/> <topic label="Tehtävä3_2" href="html/tasks/task3_2.html"/> </topic> </toc>
<toc label="Ohjeet"> <topic label="Ohje1" href="html/ref/ref1.html"/> <topic label="Ohje2" href="html/ref/ref2.html"/> </toc>
Aihe voi olla yksinkertaisesti linkki sisältöön. Esimerkiksi "Tehtävä1" sisältää label-määritteen ja href-määritteen, joka linkittää sisällön. Aihe voi olla myös aliaiheiden hierarkkinen joukko, jolla ei ole omaa sisältöä. Esimerkiksi "Kiinnostavaa sisältöä" sisältää vain label-määritteen ja aliaiheita, mutta ei href-määritettä. Aiheet voivat toimia kummallakin tapaa. "Käsite1" sisältää href-määritteen ja aliaiheita.
Dynaaminen sisältö
Dynaamista sisältöä voi käyttää sisällysluettelossa suodattimien ja ankkureiden avulla. Voi olla hyödyllistä, että esimerkiksi jokin ohjeaihe näkyy sisällysluettelossa vain, jos käytössä on tietty käyttöjärjestelmä.
Sisällytyksiä ei tueta tämän ominaisuuden yhteydessä, koska niitä ei tarvita. Niiden sijaan voi käyttää linkkejä.