Learn about DokuWiki
Learn about DokuWiki
This is an old revision of the document!
Compatible with DokuWiki
Similar to dokuwiki
This is an attempt to create a very simple and lightweight template for DokuWiki that stays true to the ideas of the original design, but modernizes the code and improve on the usability.
It was designed to work for my DokuWiki site of the same name (link, see below) but may be useful for others, too.
Please keep in mind that this is still “work in progress”, and this template may not be ready for production use on other sites. Use with care.
Feedback and bug reports are of course always welcome
Use the following URL to download this template:
Refer to template on how to install and use templates in Dokuwiki.
Similar to the default, this template allows for pictures with specific names to be uploaded using the media manager and serve as site icons, etc. These images have to be uploaded either to the root directory, or into the
Note on SVG images: by default, the media manager does not allow the upload of SVG images. To use them, please add a configuration setting in
mime.local.conf. Please see MIME Configuration for more information.
Site logo: this is the logo that appears in the top-left corner of every page. Note that this template uses a different default size (64×64 pixels) than the standard template. This file can be named “
logo.svg” or “
logo.png” (the preferred format is SVG).
Favicon: This is the icon used by the browser, e.g. for bookmarks and/or tabs. This should either be in Windows Icon Format (containing a set of 16, 24 and 48 pixels size icons), PNG, or SVG. The preferred format is Windows Icon, but SVG is the most flexible size. This should be named “
favicon.png” or “
Apple Touch Icon: Used by iOS devices when the user places a bookmark on the homescreen. This should be a 180×180 pixels PNG file named “
The template looks for HTML files that will be included at specific places in the page. This is useful for repeating sections, configuration options, etc. These files can be located in the
/conf/ directory, or directly in the template directory (
The file “
meta.html”, if it exists, will be included at the end of the
An area in the page header, located just below the search field, is reserved for the content of the file “
header.html”, if it exists. This is a good place to add site-wide notifications, like warning of technical problems, etc.
There are two hooks for HTML files in the sidebar: one on top (called “
sidebarheader.html”), and another at the bottom (“
sidebarfooter.html”). These can be used to add navigation items that should repeat on all pages (e.g. a link to the homepage, or to legal mentions).
A repeating section on top of the main page content (above the “youarehere” links) can be added by placing a file called “
pageheader.html” in the template directory.
Likewise, at the bottom of the page (after the “Last changed” item). The file to be inserted here has to be called “
There is a footer section reserved for a static HTML file called “
footer.html”. If there are bullet lists in this file, they will be displayed as inline lists in mobile view (similar to the other footer sections).