Available in a git repository branch.
Branch: smcv/trail3
Author: smcv
Available from smcv's git repository, in the trail3
branch. This
plugin aims to solve wikitrails in a simpler way; it can also be
used for navigation through blog posts.
If you don't want to use a branch of ikiwiki, manual installation requires these files (use the "raw" link in gitweb to download):
- trail.pm
in an
IkiWiki/Plugin
subdirectory of your configuredplugindir
- page.tmpl
and
trails.tmpl
in your configured
templatedir
, or atemplates
subdirectory of your wiki repository - the trail-related bits from the end of the stylesheet (put them in your local.css)
- the trail-related bits at the end of the actiontabs or blueview/goldtype stylesheets, if you use one of those themes (again, put them in your local.css)
The branch also includes test coverage machinery.
Demo:
The page e
is in both demo trails, to demonstrate how a page in more than
one trail looks.
The smcv/trail2
branch is an older version of trail3
which used typed links
as its data structure, resulting in timing-related limitations (it couldn't
select pages for the trail by using pagespecs, because pagespecs can't be
evaluated correctly until the scan stage has finished).
Updated, November 2011:
- reinstated
inline
integration (report integration would probably be pretty easy too, if this gets merged) - switched from typed links back to a custom data structure to avoid chicken/egg problems with ordering
- create typed links too, as a side-effect, but not when using an inline
- regression test with nearly full coverage
- CSS for the default anti-theme and all built-in themes (it looks nicest in the default anti-theme and in actiontabs - the demo uses actiontabs)
Known bugs:
- the blueview and goldtype CSS nearly work, but the alignment is a bit off
Plugin: trail
Author: Simon McVittie
Included in ikiwiki: no
Enabled by default: no
Included in goodstuff: no
Currently enabled: no
This plugin provides the trailoptions, traillink, trailitem, trailitems and trailinline directives.
It's sometimes useful to have "trails" of pages in a wiki where each page links to the next and/or previous page. For instance, you could use this for a guided tour, sequence of chapters, or sequence of blog posts.
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, or by including groups of pages with a directive.
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. HTML <link>
tags with the prev
,
next
and up
relations are also generated.
The trailoptions directive sets options for the entire trail.
Pages can be included in a trail in various ways:
The trailinline directive sets up an inline, and at the same time adds the matching pages (from
pages
orpagenames
) to the trail. One use is to navigate through all posts in a blog:[[!trailinline pages="page(./posts/*) and !*/Discussion" archive=yes feedshow=10 quick=yes]]
This directive only works if the inline plugin is also enabled.
The trailitems directive has optional
pages
andpagenames
options which behave the same as in inline, but don't produce any output in the page, so you can have trails that don't list all their pages.The traillink directive makes a visible link and also adds the linked page to the trail. This will typically be used in a bullet list, but could also be in paragraph text:
* [[!traillink Introduction]] * [[!traillink "Chapter 1"]] * [[!traillink Chapter_2]] * [[!traillink Appendix_A]]
or
To use this software you must [[!traillink install]] it, [[!traillink configuration text="configure it"]], and finally [[!traillink running|run_it]].
This also counts as a WikiLink for things like the
link()
PageSpec item.The trailitem directive adds a page to the trail like
traillink
, but produces an invisible link, rather like[[!tag ]]
:To use this software you must [[!traillink install]] it, [[!trailitem installing_from_packages]] [[!trailitem installing_from_source]] [[!traillink configuration text="configure it"]], and finally [[!traillink running|run_it]]. [[!trailitem troubleshooting]]
Like
[[!tag ]]
, this still counts as a WikiLink even though there's no visible link.
You can mix several of these directives in one page. The resulting
trail will contain all of the pages matched by any of the directives,
in the same order that the directives appear (unless you use the sort
or
reverse
options on [[!trailoptions ]]
).