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.

• 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

1. 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).

1. In Admin → Configuration Manager → Template, select mikio.

1. (Optional) Adjust colours, width, and dark-mode preferences under Template Style Settings.

💡 Want Bootstrap-style components inside your wiki pages? Install the Mikio Plugin.

The README is just the start - full docs and configuration reference live in the wiki:

👉 Mikio Wiki

• Configuration Guide
• Hero
• Macros
• Navbar
• Sidebars
• Icon Engine
• Custom Footer Text
• Breaking Changes
• Releases

• 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.

• 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.

You’ll always find the most recent changes in Releases. The main branch may include features still under test.

This template uses a modified version of simple_html_dom

Released under the GPLv2. See LICENSE for details.

• 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!

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