20.3.3 Positioning local TOCs in HTML topics

To specify where in an HTML topic a local TOC should appear, assign a predefined local-TOC macro to one of the following:

• a fixed location in each HTML output file

• a location relative to a paragraph format (usually a split-file heading).

The predefined local TOC macros are as follows:

<$_localtoc>	A set of links to subordinate topics
<$_lastlocaltoc>	A copy of the last local TOC generated

Use predefined macro <$_lastlocaltoc> to repeat the last local TOC generated; for example, to provide in each subordinate topic a set of links to all sibling topics.

Note:  For either of these macros to take effect, you must enable local TOCs; see §20.3.1 Directing Mif2Go to generate local TOCs.

Local TOC position in a file

To specify a position for a local TOC in every HTML output file that should include a local TOC, assign predefined macro <$_localtoc> to a location keyword in the [Inserts] section. For example, to place a local TOC at the bottom of each split file that has subordinate files:

[Inserts]

FirstBottom=<$_localtoc>

SplitBottom=<$_localtoc>

See §18.5 Inserting HTML code in split and extract files.

Local TOC position relative to a heading

To specify a position for a local TOC with respect to a paragraph format, assign a local-TOC macro to the format in one of the [ParaStyleCode*] sections. For example:

[HTMLParaStyles]

Heading1=Split Title CodeAfter

Heading2=Split Title CodeBefore

[ParaStyleCodeAfter]

Heading1=<$_localtoc>

[ParaStyleCodeBefore]

Heading2=<$_lastlocaltoc>

Depending on what other local-TOC settings you specify, these assignments would result in the following:

• a list of links to all subordinate Heading2 files just after each Heading1 paragraph

• a copy of the list of links to all Heading2 files subordinate to the same Heading1, just before each Heading2 paragraph (at or near the top of each file split at Heading2).

See §28.9.3 Surrounding or replacing text with code or macros.

---

> 20 Providing navigation in HTML > 20.3 Including local TOCs > 20.3.3 Positioning local TOCs in HTML topics