Mikio DokuWiki Template
About
Mikio
is a Bootstrap 4 style template for DokuWiki
Features
- bootstrap styling
- Navbar with dropdown support
- Subnavbar support (using a page named submenu)
- Right sidebar
- Hero element
- Icon support
- Customizable breadcrumbs
- Theming support
- Tags plugin support
- Mobile friendly
- Typeahead search support
Changes
-
2022-04-25
- Added support for the defer js option in Hogsfather to override the templates default defer action of always.
- The new Typeahead search feature is enabled by default. This can be turned off in the config.
-
2022-03-05
- Breadcrumbs and You Are Here have now been seperated instead of combined. This removed the options
breadcrumbHome
andbreadcrumbShowLast
for the breadcrumbs as it only applies to the you are here bar. Breadcrumbs and You Are Here options may have reset
- Breadcrumbs and You Are Here have now been seperated instead of combined. This removed the options
-
2020-09-27
- Sidebars now collapse by default on mobile. This can be overridden with the
sidebarMobileDefaultCollapse
option - The mikio LESS stylesheet is now disabled by default, with a precompilied CSS used. This can be reverted using the
useLESS
option
- Sidebars now collapse by default on mobile. This can be overridden with the
Configuration
The configuration can be change with the Configuration Manager Plugin
-
iconTag
: icon tag to use to engage the icon engine. Default toicon
-
customTheme
: the mikio theme to use, located in themikio/themes
directory -
showNotifications
: where to show site notifications for admin staff -
useLESS
: use the LESS compilier or direct CSS for the mikio stylesheet. Requires the ctype PHP extension installed -
brandURLGuest
: change the brand URL for guests. Leave blank to use the default -
brandURLUser
: change the brand URL for logged in users. Leave blank to use the default -
navbarUseTitleIcon
: show the site logo in the navbar -
navbarUseTitleText
: show the site title in the navbar -
navbarUseTaglineText
: show the site tagline in the navbar. Requires thenavbarUseTitleText
to be enabled -
navbarCustomMenuText
: custom menu to use in the navbar. Menu items are in the format of url|title with each item seperated by a semicolon. Requires one of thenavbarPos
to be set tocustom
-
navbarDWMenuType
: how to show the DokuWiki menu items in the navbar. Can be either icons, text or both -
navbarDWMenuCombine
: how to show the DokuWiki menu in the navbar. Can be either category dropdowns, single items or a combined dropdown. The combined menu title is pulled from thetools-menu
language value -
navbarPosLeft
: what menu to show on the left of the navbar -
navbarPosMiddle
: what menu to show in the middle of the navbar -
navbarPosRight
: what menu to show on the right of the navbar -
navbarShowSub
: show the sub navbar. This menu is pulled from thesubmenu
page in the current or parent namespaces. The menu is also shown on child pages. If no page is found, the sub navbar is automatically hidden -
navbarItemShowCreate
: show the Create Page menu item -
navbarItemShowShow
: show the Show Page menu item -
navbarItemShowRevs
: show the Revisions menu item -
navbarItemShowBacklink
: show the Backlinks menu item -
navbarItemShowRecent
: show the Recent Changes menu item -
navbarItemShowMedia
: show the Media Manager menu item -
navbarItemShowIndex
: show the Sitemap menu item -
navbarItemShowProfile
: show the Update Profile menu item -
navbarItemShowAdmin
: show the Admin menu item -
navbarItemShowLogin
: show the Login menu item -
navbarItemShowLogout
: show the Logout menu item -
searchButton
: show the search button as a icon or text -
searchUseTypeahead
: use Typeahead page suggestions in search bar -
heroTitle
: show the hero block on pages -
heroImagePropagation
: search for hero images in parent namespaces if none is found in the current namespace -
tagsConsolidate
: Consolidate tags found in the current page and display it in the hero, content header or sidebar -
breadcrumbHideHome
: hide breadcrumbs in the root namespace -
breadcrumbPosition
: where to display the breadcrumbs, either under the navbar, in the hero element or above the page content -
breadcrumbPrefix
: enable changing the breadcrumb prefix -
breadcrumbPrefixText
: text to set the breadcrumb prefix. RequiresbreadcrumbPrefix
to be enabled -
breadcrumbSep
: enable changing the breadcrumb seperator -
breadcrumbSepText
: text to set the breadcrumb seperator. RequiresbreadcrumbSep
to be enabled -
youarehereHideHome
: hide you are here in the root namespace -
youareherePosition
: where to display the you are here, either under the navbar, in the hero element or above the page content -
youareherePrefix
: enable changing the you are here prefix -
youareherePrefixText
: text to set the you are here prefix. Requiresyou are herePrefix
to be enabled -
youarehereSep
: enable changing the you are here seperator -
youarehereSepText
: text to set the you are here seperator. Requiresyou are hereSep
to be enabled -
youarehereHome
: change the you are here home item to none, page title of root page, 'home' or an icon/image. The 'home' text is pulled from thehome
language value -
youarehereShowLast
: only show an amount of you are here from the last. Will also show the home item in the list if enabled. Set this to0
to show all items -
sidebarShowLeft
: show the left sidebar if content is found -
sidebarLeftRow1
: content to show in the first row of the left sidebar -
sidebarLeftRow2
: content to show in the second row of the left sidebar -
sidebarLeftRow3
: content to show in the third row of the left sidebar -
sidebarLeftRow4
: content to show in the forth row of the left sidebar -
sidebarMobileDefaultCollapse
: collapse the sidebars by default when viewed on mobile -
sidebarShowRight
: show the right sidebar if content is found -
tocFull
: show the table of contents as a full height item -
pageToolsFloating
: when and if to show the floating page tools -
pageToolsFooter
-
pageToolsShowCreate
: show the Create Page item -
pageToolsShowEdit
: show the Edit Page item -
pageToolsShowRevs
: show the Revisions item -
pageToolsShowBacklink
: show the Backlinks item -
pageToolsShowTop
: show the Back to Top item -
footerCustomMenuText
: custom menu to use in the footer. Menu items are in the format of url|title with each item seperated by a semicolon -
footerSearch
: show the search bar in the footer -
licenseType
: how to show the license in the footer -
licenseImageOnly
: show the license in the footer as an image only. RequireslicenseType
to at least be enabled -
includePageUseACL
: respect ACL when including pages -
includePagePropagate
: search parent namespaces when including pages
Include Pages
The following pages can be either html files in the root of the template or a page in the namespace. Namespace pages take priority.
topheader
: content to include above the navbarheader
: content include below the navbar but above the page contentcontentheader
: content to include above the page contentcontentfooter
: content to include below the page contentsidebarheader
: content to include above the left sidebar contentsidebarfooter
: content to include below the left sidebar contentrightsidebarheader
: content to include above the right sidebar contentrightsidebarfooter
: content to include below the right sidebar contentfooter
: content to include in the footerbottomfooter
: content to include below the footer
Include Images
The following images can be used to replace content in the template. Images can be in the root of the template or in the namespace. Images can be either png, jpg, gif or svg.
logo
: site logo in the navbarbreadcrumb-prefix
breadcrumb prefixbreadcrumb-sep
breadcrumb seperatorhero
hero image for hero element
Hero Element
title
: The hero title is sourced from the page title. The page title is removed from the page contentsubtitle
: Pages can set the subtitle by inserting~~hero-subtitle TEXT~~
in the page contentimage
: The hero image is sourced from an image named hero in the current or parental namespace. Namespace searching can be confined by theincludePagePropagate
setting. Pages can also override the image by inserting~~hero-image URL~~
in the page content. DokuWiki and external URLs are supportedcolors
: Colors can be overridden by including~~hero-colors BACKGROUND_COLOR HERO_TITLE_COLOR HERO_SUBTITLE_COLOR BREADCRUMB_TEXT_COLOR BREADCRUMB_HOVER_COLOR~~
. You do not need to include all the color options. Use 'initial' to skip a color override
Namespaces can also apply the above hero settings in child pages by including the above settings in a page named theme
.
Hiding Elements
Mikio now supports hiding elements using the ~~hide-parts (parts)~~
macro. Each element within the hide-parts macro is required to be seperated by spaces. Currently the following parts are supported:
topheader
: content above the navbarnavbar
: the main navigation barheader
: content below the navbar but above the page contenthero
: the page hero barcontentheader
: content above the page contentcontentfooter
: content below the page contentsidebarheader
: content above the left sidebar contentsidebarfooter
: content below the left sidebar contentrightsidebarheader
: content above the right sidebar contentrightsidebarfooter
: content below the right sidebar contentfooter
: content in the footerbottomfooter
: content below the footer
To hide the topheader, navbar and hero, you would use the macro ~~hide-parts topheader navbar hero~~
Icon Engine
- Mikio includes an icon engine that allows you to include icons in your pages by using in your content
- If the icon tag conflicts with another plugin, you can change the tag from
icon
to a user set value in the settings - By default, Mikio enables FontAwesome 4 by also includes FontAwesome 5, Elusive 2 and Bootstrap Icons which can be enabled by uncommenting their inclusions in
/icons/icons.php
Users can also add their own icon sets into the template. Supported icon sets can either be webfonts or indivial files (such as a SVG library). Instructions can be found in the /icons/icons.php
file.
Themes
Themes should be placed in the themes directory, in its own directory. LESS files are supported.
Mikio Plugin
The Mikio Plugin is also available to add bootstrap 4 style + more elements to DokuWiki pages.
Languages
sidebar-title
: Text for the collapsable block in the sidebartools-menu
: Text for the combined tools DokuWiki menu titlehome
: Text for the breadcrumb home title
Releases
-
2022-04-25
-
2022-03-05
-
2021-12-11
- Added table row background styling options
- Fixed styling issue when using the indexmenu plugin #35. Thanks 3ole.
- Fixed inconsitant tab/spaces in mikio.less and mikio.css
- Removed debug logs from mikio.js
- Fixed input placeholders not hiding in prepopulated fields #34
- Added option to hide menu and page tool items #32. Thanks annievoss.
- Fixed compadibility with BookCreator #26. Thanks johncourtland.
- Fixed Greebo styling errors not present in Hogsfather
-
2021-08-11
- Fixed path check on Windows #33
- Recompilied CSS
-
2021-06-17
- Added support for navbar title link to use showpageafterlogin setting if installed #27
-
2021-06-09
- TOC is now full width on mobile #25
- Hamburger and sidebar icons are now displayed correctly #23, #24
- Site width is now available under Template Style Settings #22
- TOC is now sticky when set to full height #21
- Added support to the theme being linked by a symbolic link #20
- Mikio will now fallback to using CSS when there is the LESS engine is not detected #20
-
2021-03-10
- Fixed bad breadcrumb URL formatting on sites using userewrite #19
-
2021-03-04
- Added support to hide page elements #18
-
2021-01-22
- Fixed a syntax error with the core css
-
2020-11-12
-
2020-10-07
-
2020-10-01
- Fix for
sidebarMobileDefaultCollapse
option being inconsistent in code and not working correctly #11. Thanks to GJRobert for catching that.
- Fix for
-
2020-09-27
- Sidebars hidden by default in mobile view #10
- Fixed errors with the LESS compilier on some nginx configurations
- Fixed styling and image display thumb size in media manager popup
- Fixed text field placeholders not disappearing with text entry
- Added support for Hogfather
- Added option to use LESS or direct CSS. Some configurations (docker linuxserver/dokuwiki) do not have the required PHP extensions installed
- Supports Docker linuxserver/dokuwiki container file structures
-
2020-09-10
- Floating page tools is now a UL element with classes applied from getType and getLinkAttributes. Fixes popup dialogs initiated from the a page menu #7
- Template.info.txt now shows correct release dates #8
- Fixed rightsidebar php warnings
- Code/Pre blocks no longer have padding applied on the admin pages
-
2020-08-26
- Footer is no longer shown outside of page view
- Public messages are now displayed on the page
- Fixed icon rendering in hero bar
- Fixed TOC rendering bug
-
2020-07-27
- Added option to show wiki footer in page content
-
2020-07-24
- Fixed image detail bug
-
2020-07-20
- Fixed prewrap and sidebar search bar margins
-
2020-07-16
-
2020-07-15
- Fixed an issue with the simple_html_dom library when editing a section of a page caused page corruption #3
-
2020-07-14
- Added id=dokuwiki__content identifier for the page content element
- Added styling and fixed overflow issues with pre elements
- Fixed page width overflow issues
-
2020-07-09
- Fixed cosmetic display issues when
input[type=file]
is hidden by plugins #2
- Fixed cosmetic display issues when
-
2020-07-07
- Initial release
Third Party Libraries
This template uses a modified version of simple_html_dom and of bootstrap-3-typeahead.
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!