Available in a git repository.
Branch: smcv/trail
Author: smcv
Available from smcv's git repository, in the trail
branch. This
plugin aims to solve wikitrails in a simpler way.
Joey: what do you think of this plugin? If you like the general approach and are likely to include it in ikiwiki, I'll try to modify album to be based on it, rather than partially reinventing it.
Bugs:
- [[!inline pages="..." trail=yes]] currently tries to work out what pages are in the trail, and their order, at scan time. That won't work, because matching a pagespec at scan time is unreliable - pages we want might not have been scanned yet! I haven't worked out a solution for this. I think [[!inline pagenames="..." trail=yes]] would be safe, though.
Plugin: trail
Author: Simon McVittie
Included in ikiwiki: no
Enabled by default: no
Included in goodstuff: no
Currently enabled: no
It's sometimes useful to have "trails" of pages in a wiki, as a guided tour, sequence of chapters etc. In this plugin, a trail is represented by a page, and the pages in the trail are indicated by specially marked links within that page.
If using the default page.tmpl
, each page automatically displays the
trails that it's a member of (if any), with links to the trail and to
the next and previous members.
The traillink
directive is used to record which pages
are in a trail, and simultaneously link to them. Alternatively, the
inline directive can be used with trail=yes
to record the inlined pages as part of the trail, in the order in
which they are inlined.
Directives
(These will go to the appropriate pages in directive if this plugin is included in ikiwiki.)
traillink
The traillink
directive is supplied by the trail
plugin. This directive appears on the page representing a trail. It acts
as a visible WikiLink, but also records the linked page as
a member of the trail.
Various syntaxes can be used:
[[!traillink Badgers]]
[[!traillink How_to_find_mushrooms_using_badgers|badgers]]
[[!traillink badgers text="How to find mushrooms using badgers"]]
trailoptions
The trailoptions
directive is supplied by the trail
plugin. This directive appears on the page representing a trail, and
produces no output.
Currently, the only option supported is [[!trailoptions circular=yes]]
,
which adds links between the first and last pages, turning the trail into
a circle.