Table of Contents
Mikio Template
Compatible with DokuWiki
- 2025-05-14 "Librarian" yes
- 2024-02-06 "Kaos" yes
- 2023-04-04 "Jack Jackrum" yes
- 2022-07-31 "Igor" yes
Note
The 2025-04-24 release includes significant changes to styling and code. While it has been tested, there may be some bugs that I have missed. If you find anything thatβs not working right, please file an issue.
β¨ Features
- Modern Bootstrap styling with dark mode
- Configurable navbar with dropdowns, sub-menus, custom slots
- Hero element with title, subtitle, images, and colour overrides
- Flexible sidebars (left/right, sticky, mobile collapse)
- Typeahead search with optional suggestions
- Breadcrumbs & You Are Here (separate, configurable)
- Tags integration in hero or sidebar
- Floating page tools and full-height TOC
- Icon engine (FontAwesome 4/5, Bootstrap Icons, Elusive 2, or custom sets)
- Customisable page footer info text
- Compatibility with popular plugins (Translate, FastWiki, BookCreator, Tag, Approve, DO, VersionSwitcher, etc.)
- Dark-mode logo support for seamless theming
π Quick Start
- Use the Theme Manager in DokuWiki to search for mikio and install the current release.
> (Alternative) Copy the mikio
folder from GitHub into lib/tpl/mikio
to try the latest (may be less stable).
- In Admin β Configuration Manager β Template, select mikio.
- (Optional) Adjust colours, width, and dark-mode preferences under Template Style Settings.
π‘ Want Bootstrap-style components inside your wiki pages? Install the Mikio Plugin.
π Documentation
The README is just the start - full docs and configuration reference live in the wiki:
π Mikio Wiki
π οΈ Compatibility
- Works with recent DokuWiki releases (incl. Librarian).
- Fully tested with PHP 8.2.
- Designed to play nicely with popular plugins:
- Translate
- FastWiki
- BookCreator
- Tag
- Approve
- DO
- VersionSwitcher
Comment Syntax support converts custom control macros such as the Mikio macro ~~hero-image β¦~~
into comments.
If you plan to use this extension on your site, you will need to use the alternative macro format of -~hero-image β¦~-
for Mikio to detect the information.
π€ Contributing
- Found a bug or want a feature? Open an issue.
- Want to contribute code? Submit a pull request β please include a clear description and screenshots if UI is affected.
- Translations welcome! Language files are simple to add, see existing ones in
/lang
.
π¦ Releases
Youβll always find the most recent changes in Releases.
The main
branch may include features still under test.
Third Party Libraries
This template uses a modified version of simple_html_dom
π License
Released under the GPLv2. See LICENSE for details.
Support
- If you think you have found a problem, or would like to see a feature, please open an issue
- If you are a coder, feel free to create a pull request, but please be detailed about your changes!
Applause
This is really a modern, complete template, with very high flexibility and customizability. (Look at those options to customize for style.ini!) Also it's the first template I have seen with βHero elementβ support. And there are quite a few positions to insert included pages as page/content header/footers. I appreciate the great work of the developer. β milchflasche 2020-07-30 03:42
I have used this template in my two language learning sites: http://taigi123.ga/ http://hakka123.ga/ (written in some East Asian languages and Hanzi script) β milchflasche 2020-09-17 04:58