DokuWiki

It's better when it's simple

User Tools

Site Tools


template:mikio

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

template Mikio is a Bootstrap 4 style template with a hero element and dark mode support

Last updated on
2025-10-01
Repository
Source

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

  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.

πŸ“– 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
template/mikio.txt Β· Last modified: by nomadjimbob

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki