Settings

The template has its own section in your wiki’s configuration page (direct link).

The different settings are described on this page.

This setting allows you to configure how the toolbar menu (on the right-hand side of the toolbar) should appear:

• Automatic – The menu uses as much of the toolbar as is available, items that don't fit on screen will be shown in the overflow popup menu.

• Menu only – All menu items will always appear in the popup menu only.

This setting configures what should be shown in the left-hand side of the toolbar:

• User information – The name of the current user, which opens a popup menu with user profile options. If no user is logged in, it shows the “Log in” button only.

• Languages menu – The language of the current page, opens a popup menu of all available languages (requires the Translation plugin).

• Nothing – The left-hand side of the toolbar will be empty.

Future plan is that that the third option will be replaced with an option use an include hook for static content on this spot. This is not implemented yet, though.

The site logo that is shown on the left-hand side of the searchbar can be configured here (see Searchbar for more information):

• Logo image – Use a logo image file (e.g. logo.svg) in this place.

• Static file – Include a static HTML snippet (named sitelogo.html) instead of a logo.

Configures the tools that are added to the right of the search field. This complements the “Toolbar option” setting, and it should typically be set to the opposite of the above:

• User information – The name of the current user (including a popup menu with account options), or a “Log in” button, if no user is currently logged in.

• Languages menu – The language of the current page, opens a popup menu of all available languages (requires the Translation plugin).

• Nothing – Don’t show any tool here.

Future plan is that that the third option will be replaced with an option use an include hook for static content on this spot. This is not implemented yet, though.

The main headline of each page (in the titlebar) can be configured here:

• Site name – the site name, as configured in the DokuWiki “title” setting.

• Page name – The page title of the current page. Typically taken the first headline in the page content (make sure to set the DokuWiki “useheading” setting to “Always”).

• Static file – Include a static HTML snippet (named “title.html”), in this place.

Configure a site-wide menu?

• Name of the menu configuration. Leave empty to disable the menu.

The menu feature is not fully implemented yet.

Where should the site-wide menu be shown?

• None –
• Before –
• Between –
• After –

The menu feature is not fully implemented yet.

Where should the “hierarchical breadcrumbs” navigation be shown?

• Menu – On top of the Menu-bar.
• Banner – Overlaying the site banner.
• Content – On top of the content block.

Note that this navigation will only be generated if the DokuWiki youarehere setting is activated.

Name of the image file to be used as banner image.

• Name of the image file (e.g. “banner”), or leave empty to disable banner image.

For more information on the banner configuration, please see: Banners.

The “table of contents” (TOC) can be shown or hidden by the user. This setting defines the default state when a page is opened:

• Opened – The TOC is open by default.
• Collapsed – The TOC is collapsed by default.

The way the TOC is generated can be configured via the following DokuWiki settings: toptoclevel, tocminheads and maxtoclevel.

This is an experimental option that tries to move the main article headline above the TOC for a neater appearance.

When enabled, this option adds a “higher-level” home item above the wiki navigation that is used as a “home” for the site.

This also overrides the link for the site logo.

Setting this (e.g. to “/”) can be useful if the wiki is part of a larger site, which has a homepage that is separate from the wiki.

Leave empty to disable this feature.

Enables a user-controlled alternative Light-on-dark color scheme.

• Disabled – Dark mode is not available.
• Follow user settings – Dark mode is active for users that have dark mode enabled on their devices.

Note that for usability reasons it is not possible to force dark mode to users who don’t have it enabled on their device.

This enables a special debugging mode that makes the HTML code more legible, at the expense of the data transfer size. Should probably be disabled in production systems.