The WikiTrails feature allows wiki authors to create "trails" through sequences of pages in the wiki.
Creating a trail
To create a trail, an author creates a "trail index page" that gives the sequence of page names as either a bullet or numbered list. The page names must be the first item following each bullet.
An example trail index page: a list like
* [[TrailPage1]] * Some text. * [[TrailPage2]] ** [[TrailPage3]] ** [[TrailPage4]] some other text [[IrrelevantWikiPage]] ** Yet some other text. [[AnotherIrrelevantWikiPage]] ** %center%[[would-beTrailPage]]
creates the following "wikitrail":
TrailPage1 <-> TrailPage2 <-> TrailPage3 <-> TrailPage4
Using the trail
Creating a trail doesn't do anything on its own -- any page with numbered or bulleted lists implicitly create a trail. What makes a trail "work" is adding trail markup on the pages in the trail (i.e. the pages that are listed in the bullet/numbered list).
To build a trail, add trail markup like
PmWiki defines three trail markups:
Typically, a trail is a linear list with a first and a last page. However, the trail can be made "circular" by repeating the first page as the last item in the trail index:
* [[TrailPage1]] * [[TrailPage2]] ... * [[TrailPageN]] * [[TrailPage1]]
If the trail index page is intended to be read by others, the last item can be made invisible using
* [[TrailPage1]] * [[TrailPage2]] ... * [[TrailPageN]] * [[TrailPage1]] %item comment%