#### 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