Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 20 Providing navigation in HTML > 20.2 Generating trails of links > 20.2.3 Specifying what to include in trails of links
In the usual case, you can set MakeTrail=Yes
and SplitTrail=Yes
, and appropriate trails
of links will appear in the HTML output for headings assigned format
properties Split
, Trail
,
and Title
. Other settings
allow you to override Mif2Go defaults for what to include in trails and where
to position trails.
To include in the trails of links the content
of a heading format (or other format, for extracted files), assign both
the Title
property and the Trail
property to that format. For example:
; Trail, if [Trails]MakeTrail=Yes, causes the <$_trail> to be put out
; as specified by [Trails] settings.
FigCaption=ExtrStart Title Trail
To provide a prefix or suffix for heading content as it appears in trails:
; doc style = prefix to use (if any) for file title in trails
; doc style = suffix to use (if any) for file title in trails
The heading content displayed in a trail excludes
any prefix or suffix values assigned to heading formats via [StyleTitlePrefix]
or [StyleTitleSuffix]
(see §18.4.2.3 Specifying a title prefix or suffix).
Code to start, end, separate entries
You can specify the HTML starting, ending, and separator code for the trail. For example:
; TrailStart = starting code for <$_trail>
; TrailSep = code between <$_trail> elements
; TrailEnd = ending code for <$_trail>
; TrailLinkClass = value for class attribute in trail links,
You can use TrailStart
to put a class attribute on the <p>
tag,
and use CSS to style it, if the regular italic form (from <em>
)
does not suffice. And you can add a class attribute for the links used
in trails.
If the text of your headings tends to be lengthy, you might want to put each item in a trail of links on a separate line, instead of having them all on one line; and you might want to indent each successive entry.
To stack trail entries, replace the final
of the TrailSep
value with <br>
.
To indent successive stacked entries incrementally, specify the number of spaces to indent; the maximum is four spaces per level:
; TrailIndent = number of s to put after TrailSep for each
; output line to create indentation; a value of 1 puts one space
; before the second line, two before the third, three before
; the fourth, etc. A value of 2 puts 2, 4, 6, etc. Zero disables.
; If a value over 4 is set, it is reduced to 4.
By default, a trail consists of links to headings above the current page. It can also include, as text rather than as a link, the heading (or other first paragraph) of the current page, as the final item in the trail:
; TrailCurrent = Yes (default), No, or Always
TrailCurrent
can have
the following values:
You would specify TrailCurrent=Always
if, for example, you had embedded another link in TrailStart
,
perhaps to the table of contents.