Learn about DokuWiki
Learn about DokuWiki
This is the new default template bundled with DokuWiki since “Adora Belle” (2012-10-13 release).
The template supports some simple customizing. If you need more than that you should create your own template, though. Check DokuWiki Template Development for that.
The template supports a sidebar as configured in Configuration Setting: sidebar.
Additionally to the standard guaranteed style.ini placeholders, the template uses the following variables:
|background colour of the whole site|
|colour of links|
|colour of links to existing internal pages|
|colour of links to missing internal pages|
|width of the whole site|
|width of the sidebar|
E.g. you can adjust the width of the template by overriding the
__site_width__ variable. Simply create the file
lib/tpl/dokuwiki/style.local.ini in Adora Belle) and set the variable accordingly. You can either use a fixed value (px or em) or a percent value (%) if you prefer a dynamic width.
[replacements] __site_width__ = "100%"
You can use this file to override any other variable from the
style.ini as well. E.g. for changing some of the colors.
The Logo, Favicon and Apple Touch (bookmark) icons are looked up from multiple locations. The default icons (DokuWiki logo) provided by the template can be easily exchanged by uploading the image files to their correct locations using the Media Manager.
Here are the locations checked by the template code:
Plugins can integrate into the template without any need for modifying the template by providing an Action component to handle the custom action hooks triggered by the template.
This event allows to extend or modify the floating pagetools menu.
$event->data['items'] contains an array with HTML for each item in the menu. Plugin authors should match the existing style and provide needed CSS and background image. You can use different styling or classes or markup depending on
$event->data['view'] contains information whether the pagetools are called in the
main or the
Include hooks allow you to add additional HTML or PHP to the template without modifying any of the template files itself, making them safe to survive an update. Just create the appropriate file in either the template directory (
lib/tpl/dokuwiki/) or your
|Filename||Position of included HTML|
| ||Inside the HTML <head>, use this to add additional styles or metaheaders|
| ||At the top of the sidebar (if any)|
| ||At the bottom of the sidebar (if any)|
| ||At the top inside the content box, above the actual content|
| ||At the bottom inside the content box, below the actual content|
| ||At the top of the page, above the logo and wiki title|
| ||At the very end of the page after all other page content|