DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:docnavigation

DocNavigation Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" yes
  • 2023-04-04 "Jack Jackrum" yes
  • 2022-07-31 "Igor" yes
  • 2020-07-29 "Hogfather" yes

plugin Add navigation links to previous and next page at the top and bottom of wiki page

Last updated on
2024-02-08
Provides
Syntax, Action
Repository
Source
Conflicts with
bloglinks

Similar to pagenav

Tagged with browse, listing, navigation

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Usage

The syntax defines which pages are referred to as previous and next pages. A start page or page with an overview can be provided in between.

<- namespace:previous_page ^ namespace:startpage ^ namespace:next page ->

or, alternatively, only different syntax (for example needed in combination with ckgedit plugin)

<< namespace:previous_page ^ namespace:startpage ^ namespace:next page >>

And at the start page an auto-generated table of contents can be put using

<doctoc start= yournamespace:firstpage>

Syntax

Urls are shown with default link names derived from url or useheading setting.

<-namespace:previous^namespace:startpage^namespace:next->

Urls are shown with the given names.

<-previous|Your previous page^startpage|Overview^other_page|Navigate to next page ->

Example of navigation added by the DocNavigation Plugin. Here the useheading config is enabled such that the page headings are used as link name. Page with navigation links

Table of contents generated from linked pages

A Table of Contents of the linked pages can be created with <doctoc optionname=value[, more=..]>.

<doctoc>
<doctoc start=firstpage, includeheadings=2-3>

possible options:

Option Description
start=<pageid> Pageid of the first page with page navigation, if left out the page navigation is searched on the current page.
includeheadings=<topheading>-<maxheading>Includes the given heading levels of a page in the table of content. e.g 2-3 Default: 2 (levels are numbered from 1 to 5)
hidepagelink=<0 or 1> Hide the page links, but shows default the first two levels of the table of content. With includeheadings setting the number of levels can be changed. If only includeheadings is used, the page links are shown, which can result in duplicated titles if level 1 is shown.
useheading=<0 or 1> Overrules the 'navigation' case of the useheading setting.

Development

Change Log

Bugs and feature requests

Please report all your bugs and feature requests at the issue tracker.

plugin/docnavigation.txt · Last modified: 2024-02-08 00:36 by Klap-in

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki