Learn about DokuWiki
Learn about DokuWiki
Compatible with DokuWiki
This plugin adds small glyphs after breadcrumbs concerning a namespace that contains more than a start page (topbar.txt is also ignored). Clicking that glyph will display a small pop-up containing an index of the related namespace. It was originally aimed at “you are here” type breadcrumbs but it also works for regular breadcrumbs.
This plugin now probably requires “Detritus” or later version
TwistieNav is developped above Dokuwiki's default template so it should be compatible with any template based on same markup.
You are here] has to be a collection of links wrapped into a
Breadcrumbs] has to be a collection of links wrapped into a
pageId] has to be wrapped into an HTML element (e.g. `<div>`, `<span>`, …) with
sidebarpages are excluded. You can add custom exclusions with the text field (add page names as a comma separated list like
topbar,other_sample). IMPORTANT: start pages shouldn't be excluded if
startPagesOnlyisn't enabled and will however never be excluded from 'pageId' TwistieNavs.
pageIdHTML element and turn it into a short hierarchical trace [default: disabled] (see below for details).
pageIdHTML element and attempt to add an extra TwistieNav that will show a popup with global index [default: enabled].
If the corresponding setting is enabled, TwistieNav will search a [
pageId] element (usually a pseudo tab in top right corner of content with current page ID) and try to turn it into a short hierarchical trace with text links to open popups.
Note that this is a bit experimental and I didn't build any specific CSS rule right now…
Latest version uses a selection of SVG images (and corresponding PNG images) from IcoMoon or Font Awesome glyphs (if your template or a plugin loads it). In addition, I included old plugin's PNGs (but only in that format).
The available images are:
A few notes :
What you need to do is to add/expand custom user style and override style from plugin's
Paths to images will have to be relative to the user style file you use.
2016/05/08 version prevents popups from going off-screen (see details)
2016/05/03 version brings many changes (urlrewriting and regular breadcrumbs support)
I can't see the “you are here” navigation even if I enable it.
Not all templates support “you are here”. Try the default one. By default, TwistieNav now supports both “trace” and “you are here” Breadcrumbs types so this question is irrelevant.
Once TwistieNav is enabled, current ID breadcrumb isn't highlighted anymore, is this normal ?
Currently it is, will see later if it is requested by users and can be changed (wich is quite not sure).
pageIdExtraTwistie) but nothing is added to templates' “pageId” element.
The plugin can only interfere with template's “paegId” if it's HTML markup is close Dokuwiki's default template. Let me know wich template you use and I'll see if I can fix that.
Once TwistieNav is enabled, “you are here” separation character between links are removed, is this normal ?
Currently it is, will see later if it is requested by users.