This is an old revision of the document!
Table of Contents
Page Navigation Plugin
Compatible with DokuWiki
2009-12-25+
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to docnavigation
This plugin lets you insert a next/previous page navigation to let you users easily navigate through all pages in a namespace. The namespace's start page will be skipped on browsing.
Download and Installation
Download and install the plugin using the Plugin Manager using the following URL. Refer to Plugins on how to install plugins manually.
Changes
- Version upped (2020-12-09 23:51)
- Merge pull request #17 from chaotic-bruno/patch-1 (2020-12-09 10:59)
- Don't add hidden pages to navigation (2020-12-07 16:44)
- Version upped (2019-08-21 23:51)
- properly handle encoded namespaces (2019-08-21 14:07)
- Merge pull request #11 from sawachan/master (2019-08-21 14:01)
- use command as class. fixes #12 (2019-08-21 13:15)
- added README and autoreply (2019-08-21 12:03)
Syntax and Usage
The simplest usage is this:
[<>]
It will include a navigation bar to browse through all pages in a namespace, displaying all buttons as shown above.
To control which buttons are shown, you can place a number inside the angle brackets:
[<2>]
The following numbers are recognized:
number | shown buttons |
---|---|
2 | previous, next |
4 | first, last |
6 | first, previous, next, last |
8 | start |
10 | previous, start, next |
12 | first, start, last |
If you want to restrict browsing on pages matching a certain regular expression you can give the expression separated by a space inside the square brackets. E.g. to browse only pages starting with a
you could use this:
[<> ^a.*]
Notes
The navigation is cached with the page. When new pages are added to the namespace, the navigation might be wrong until the cache expires. Read caching on how to update the cache manually.
You can now use this plugin inside a sidebar (for templates that have one). To make it work in a sidebar you have to disable caching for that sidebar completely using the ~~NOCACHE~~ macro in the sidebar page. You should also make sure the sidebar is set up to be hidden through the hidepages option.
Using this plugin together with namespace templates might be useful.
Discussion
Please, could you provide the syntax to use for hiding the sidebar file? I tried a lot of things in the hidepages option but he sidebar always appear as next page in pagesnav. I tried `sidebar`, `sidebar$`,`^(?::sidebar)$`but none of them works. Thanks for your help.