Tables of contents

1. Purpose

This document describes how a table of contents must be marked up in MONET v2. The goal is that the number, title, and page reference of each TOC item are individually addressable, so that downstream systems (rendering, accessibility, navigation) can process the TOC reliably.

These guidelines are mandatory. Alternative constructions are not permitted, even when they produce the same visual result.

2. Base structure

The table of contents is marked up as a nested <list> with the following fixed properties:

• role="toc"
• listType="ordered"
• numberType="predefined"

The top level of the list contains the chapters. Subchapters are a nested <list> inside the parent <li>. Further levels (sections under subchapters, etc.) follow the same pattern.

3. Items

3.1 Number

The chapter or section number is always placed in the @number attribute of the <li>. The number must not be included inline in the text content of the <li>.

✅ Correct:

<li number="1.2">Het practicumlokaal …</li>

❌ Not allowed:

<li>1.2 Het practicumlokaal …</li>

3.2 Title

The visible title of the chapter or section is the text content of the <li>, placed before the page reference.

3.3 Page reference

Each <li> ends with a page reference marked up as an <a> element:

• type="pageRef" (required)
• href points to the corresponding pagebreak element in the document, for example href="#pb-38"
• the text content of <a> is the page number as printed in the book

Separators between the title and the page number (spaces, tabs, leader dots) are not included in the XML — these are presentation and are added by the renderer.

✅ Correct:

<li number="2.1">Licht en schaduw <a type="pageRef" href="#pb-40">40</a></li>

❌ Not allowed:

<li number="2.1">Licht en schaduw .......... 40</li>

4. Book parts

A book part (for example “deel A”, “deel 1A”) is not placed inside the TOC list itself, and is not an additional level in the nested list.

Instead, for each book part:

1. a <p> is placed containing the book part label,
2. followed by a separate <list role="toc"> containing the chapters of that book part.

When multiple book parts exist, this pattern is repeated.

This keeps the rule “top level of the TOC list = chapter” valid in all cases.

5. Examples

5.1 TOC without book parts

<list role="toc" listType="ordered" numberType="predefined">
    <li number="1">Natuur- en scheikunde doen <a type="pageRef" href="#pb-6">6</a>
        <list role="toc" listType="ordered" numberType="predefined">
            <li number="1.1">NaSk is overal <a type="pageRef" href="#pb-8">8</a></li>
            <li number="1.2">Het practicumlokaal <a type="pageRef" href="#pb-12">12</a></li>
            <li number="1.3">Grootheden, eenheden en meetinstrumenten <a type="pageRef" href="#pb-16">16</a></li>
            <li number="1.4">Onderzoeken <a type="pageRef" href="#pb-22">22</a></li>
            <li number="1.5">Ontwerpen <a type="pageRef" href="#pb-29">29</a></li>
        </list>
    </li>
    <li number="2">Licht <a type="pageRef" href="#page-38">38</a>
        <list role="toc" listType="ordered" numberType="predefined">
            <li number="2.1">Licht en schaduw <a type="pageRef" href="#pb-40">40</a></li>
            <li number="2.2">Spiegels <a type="pageRef" href="#pb-45">45</a></li>
            <li number="2.3">Lichtbundels <a type="pageRef" href="#pb-50">50</a></li>
            <li number="2.4">Gekleurd licht <a type="pageRef" href="#pb-55">55</a></li>
            <li number="2.5">Gekleurde voorwerpen <a type="pageRef" href="#pb-61">61</a></li>
        </list>
    </li>
</list>

5.2 TOC with book parts

<p>deel A</p>
<list role="toc" listType="ordered" numberType="predefined">
    <li number="1">Jagers en boeren <a type="pageRef" href="#pb-12">12</a>
        <list role="toc" listType="ordered" numberType="predefined">
            <li number="1">Jagers en verzamelaars <a type="pageRef" href="#pb-16">16</a></li>
            <li number="2">De eerste boeren <a type="pageRef" href="#pb-22">22</a></li>
            <li number="3">Egypte en de Nijl <a type="pageRef" href="#pb-28">28</a></li>
        </list>
    </li>
    <li number="2">De Grieken <a type="pageRef" href="#pb-54">54</a>
        <list role="toc" listType="ordered" numberType="predefined">
            <li number="1">Het leven in een Griekse stadstaat <a type="pageRef" href="#pb-58">58</a></li>
            <li number="2">Politiek in Athene <a type="pageRef" href="#pb-64">64</a></li>
        </list>
    </li>
</list>

<p>deel B</p>
<list role="toc" listType="ordered" numberType="predefined">
    …
</list>