29.2.5 Specifying where to display trails of links

To display a trail of links in each split or extracted file, specify the following setting:

[Trails]
; SplitTrail = No (default) or Yes (put <$_trail> out for each split)
SplitTrail=Yes

You can specify where the trail of links should appear on each HTML page: before the heading (that is, the first paragraph in the file), after the heading, or at other locations you specify via [Inserts].

[Trails]
; TrailPosition = Before (default), After, or Macro
TrailPosition=Before

The value of TrailPosition determines where the trail appears:

Before

Immediately above the heading (first paragraph). This is the default.

After

Immediately below the heading.

Macro

Wherever you insert predefined macro <$_trail>.

When you specify TrailPosition=Macro, automatic placement relative to the heading is eliminated, and the trail appears wherever you have included <$_trail> in another macro or assigned <$_trail> to a specific location.

For example, to show a trail of links at the top of each HTML file and also at the bottom of each split file after the first, you would assign the <$_trail> macro to a location keyword in the [Inserts] section (see §27.6 Inserting HTML code in split and extract files):

[Inserts]
Top=<$_trail>
SplitBottom=<$_trail>
LastBottom=<$_trail>

When DITA2Go inserts trails specified by a <$_trail> macro assigned in the [Inserts] section, if the first paragraph in the file does not have [HTMLParaStyles] property Trail, the trail is not displayed. Otherwise, wherever you assign the <$_trail> macro, DITA2Go inserts a trail according to the settings you specify in the [Trails] section.

Previous Topic:  29.2.4 Specifying heading levels for trails of links

Next Topic:  29.3 Creating a browse sequence

Parent Topic:  29.2 Generating trails of links

Sibling Topics:

29.2.1 Understanding trails of links

29.2.2 Specifying whether to include trails of links

29.2.3 Specifying what to include in trails of links

29.2.4 Specifying heading levels for trails of links

Table of ContentsIndex