authors (basic) 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%
Cross Group Trails
Trail pages on both sides of group boundaries must be fully qualified with group names.
To get it to work, you must create the index page for the trail and the trail pages as stated above. Then you must define the wikistyle you want in the groupheader of the group you want it to appear in. Then you must refer or call to it with the
Wiki administrators can change the trail separator of the "path" trail (