xref: /template/mikio/README.md (revision 340644de4f269de1865439733e468ff877bb951f)
1# Mikio DokuWiki Template
2
3![screenshot](https://github.com/nomadjimbob/mikio/blob/main/images/screenshot.png)
4
5## About
6
7`Mikio` is a Bootstrap 4 style template for [DokuWiki](http://dokuwiki.org)
8
9## Features
10
11-   [bootstrap styling](http://getbootstrap.com/)
12-   Navbar with dropdown support
13-   Sub navbar support (using a page named submenu)
14-   Right sidebar
15-   Hero element
16-   Icon support
17-   Customizable breadcrumbs
18-   Theming support
19-   Tags plugin support
20-   Mobile friendly
21-   Typeahead search support
22
23## Possible Breaking Changes
24
25-   2023-05-13
26
27    -   Table styling had a long-standing bug found by RonaldPR which has been fixed. This fix may require updating the styling if your website was relying on this bug.
28
29-   2022-10-04
30
31    -   Some elements now have their own color options to allow finer control of your website design.
32
33-   2022-04-25
34
35    -   Added support for the defer js option in Hogsfather to override the templates default defer action of always.
36    -   The new Typeahead search feature is enabled by default. This can be turned off in the config.
37
38-   2022-03-05
39
40    -   Breadcrumbs and You Are Here have now been seperated instead of combined. This removed the options `breadcrumbHome` and `breadcrumbShowLast` for the breadcrumbs as it only applies to the you are here bar. **Breadcrumbs and You Are Here options may have reset**
41
42-   2020-09-27
43    -   Sidebars now collapse by default on mobile. This can be overridden with the `sidebarMobileDefaultCollapse` option
44    -   The mikio LESS stylesheet is now disabled by default, with a precompilied CSS used. This can be reverted using the `useLESS` option
45
46## Incompatibilities
47
48**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.
49
50## Configuration
51
52The configuration can be change with the [Configuration Manager Plugin](https://www.dokuwiki.org/plugin:config)
53
54-   `iconTag` : icon tag to use to engage the icon engine. Default to `icon`
55-   `customTheme` : the mikio theme to use, located in the `mikio/themes` directory
56-   `showNotifications` : where to show site notifications for admin staff
57-   `useLESS` : use the LESS compilier or direct CSS for the mikio stylesheet. Requires the ctype PHP extension installed
58-   `brandURLGuest` : change the brand URL for guests. Leave blank to use the default
59-   `brandURLUser` : change the brand URL for logged in users. Leave blank to use the default
60
61-   `navbarUseTitleIcon` : show the site logo in the navbar
62-   `navbarUseTitleText` : show the site title in the navbar
63-   `navbarUseTaglineText` : show the site tagline in the navbar. Requires the `navbarUseTitleText` to be enabled
64-   `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 the `navbarPos` to be set to `custom`
65
66-   `navbarDWMenuType` : how to show the DokuWiki menu items in the navbar. Can be either icons, text or both
67-   `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 the `tools-menu` language value
68
69-   `navbarPosLeft` : what menu to show on the left of the navbar
70-   `navbarPosMiddle` : what menu to show in the middle of the navbar
71-   `navbarPosRight` : what menu to show on the right of the navbar
72-   `navbarShowSub` : show the sub navbar. This menu is pulled from the `submenu` 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
73
74-   `navbarItemShowCreate` : show the Create Page menu item
75-   `navbarItemShowShow` : show the Show Page menu item
76-   `navbarItemShowRevs` : show the Revisions menu item
77-   `navbarItemShowBacklink` : show the Backlinks menu item
78-   `navbarItemShowRecent` : show the Recent Changes menu item
79-   `navbarItemShowMedia` : show the Media Manager menu item
80-   `navbarItemShowIndex` : show the Sitemap menu item
81-   `navbarItemShowProfile` : show the Update Profile menu item
82-   `navbarItemShowAdmin` : show the Admin menu item
83-   `navbarItemShowLogin` : show the Login menu item
84-   `navbarItemShowLogout` : show the Logout menu item
85
86-   `searchButton` : show the search button as a icon or text
87-   `searchUseTypeahead` : use [Typeahead](https://github.com/bassjobsen/Bootstrap-3-Typeahead) page suggestions in search bar
88
89-   `heroTitle` : show the hero block on pages
90-   `heroImagePropagation` : search for hero images in parent namespaces if none is found in the current namespace
91
92-   `tagsConsolidate` : Consolidate tags found in the current page and display it in the hero, content header or sidebar
93-   `tagsShowHero` : Show the tags in the hero element of the page. Can be turned off if using the `<tags>` element in the MikioPlugin
94
95-   `breadcrumbHideHome` : hide breadcrumbs in the root namespace
96-   `breadcrumbPosition` : where to display the breadcrumbs, either under the navbar, in the hero element or above the page content
97-   `breadcrumbPrefix` : enable changing the breadcrumb prefix
98-   `breadcrumbPrefixText` : text to set the breadcrumb prefix. Requires `breadcrumbPrefix` to be enabled
99-   `breadcrumbSep` : enable changing the breadcrumb seperator
100-   `breadcrumbSepText` : text to set the breadcrumb seperator. Requires `breadcrumbSep` to be enabled
101
102-   `youarehereHideHome` : hide you are here in the root namespace
103-   `youareherePosition` : where to display the you are here, either under the navbar, in the hero element or above the page content
104-   `youareherePrefix` : enable changing the you are here prefix
105-   `youareherePrefixText` : text to set the you are here prefix. Requires `you are herePrefix` to be enabled
106-   `youarehereSep` : enable changing the you are here seperator
107-   `youarehereSepText` : text to set the you are here seperator. Requires `you are hereSep` to be enabled
108-   `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 the `home` language value
109-   `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 to `0` to show all items
110
111-   `sidebarShowLeft` : show the left sidebar if content is found
112-   `sidebarLeftRow1` : content to show in the first row of the left sidebar
113-   `sidebarLeftRow2` : content to show in the second row of the left sidebar
114-   `sidebarLeftRow3` : content to show in the third row of the left sidebar
115-   `sidebarLeftRow4` : content to show in the forth row of the left sidebar
116-   `sidebarMobileDefaultCollapse` : collapse the sidebars by default when viewed on mobile
117-   `sidebarShowRight` : show the right sidebar if content is found
118
119-   `tocFull` : show the table of contents as a full height item
120
121-   `pageToolsFloating` : when and if to show the floating page tools
122-   `pageToolsFooter`
123
124-   `pageToolsShowCreate` : show the Create Page item
125-   `pageToolsShowEdit` : show the Edit Page item
126-   `pageToolsShowRevs` : show the Revisions item
127-   `pageToolsShowBacklink` : show the Backlinks item
128-   `pageToolsShowTop` : show the Back to Top item
129
130-   `footerCustomMenuText` : custom menu to use in the footer. Menu items are in the format of url|title with each item seperated by a semicolon
131-   `footerSearch` : show the search bar in the footer
132
133-   `licenseType` : how to show the license in the footer
134-   `licenseImageOnly` : show the license in the footer as an image only. Requires `licenseType` to at least be enabled
135
136-   `includePageUseACL` : respect ACL when including pages
137-   `includePagePropagate` : search parent namespaces when including pages
138
139## Right Sidebar
140The right sidebar can be applied by creating a normal wiki page called "rightsidebar". Go to http://your-wiki.com/doku.php?id=rightsidebar, click "Create this page", edit the page, save, and you're done. That's it, your saved changes will appear in your right sidebar.
141
142## Include Pages
143
144The following pages can be either html files in the root of the template or a page in the namespace. Namespace pages take priority.
145
146-   `topheader` : content to include above the navbar
147-   `header` : content include below the navbar but above the page content
148-   `contentheader` : content to include above the page content
149-   `contentfooter` : content to include below the page content
150-   `sidebarheader` : content to include above the left sidebar content
151-   `sidebarfooter` : content to include below the left sidebar content
152-   `rightsidebarheader` : content to include above the right sidebar content
153-   `rightsidebarfooter` : content to include below the right sidebar content
154-   `footer` : content to include in the footer
155-   `bottomfooter` : content to include below the footer
156
157## Include Images
158
159The following images can be used to replace content in the
160template. Images can be in `TEMPLATE_ROOT/images/`,
161`TEMPLATE_ROOT/themes/THEME/images/`, or in the namespace. Images can
162be either png, jpg, gif or svg.
163
164-   `logo` : site logo in the navbar
165-   `breadcrumb-prefix` breadcrumb prefix
166-   `breadcrumb-sep` breadcrumb seperator
167-   `hero` hero image for hero element
168
169## Hero Element
170
171-   `title` : The hero title is sourced from the page title. The page title is removed from the page content
172-   `subtitle` : Pages can set the subtitle by inserting `~~hero-subtitle TEXT~~` in the page content
173-   `image` : The hero image is sourced from an image named hero in the current or parental namespace. Namespace searching can be confined by the `includePagePropagate` setting. Pages can also override the image by inserting `~~hero-image URL~~` in the page content. DokuWiki and external URLs are supported. The height of the image area is 240px while the width is 33% of the window width. It is recommended to use an image of at least 480x240 (2:1)
174-   `colors` : 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
175
176Namespaces can also apply the above hero settings in child pages by including the above settings in a page named `theme`.
177
178## Hiding Elements
179
180Mikio 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:
181
182-   `topheader` : content above the navbar
183-   `navbar` : the main navigation bar
184-   `header` : content below the navbar but above the page content
185-   `hero` : the page hero bar
186-   `contentheader` : content above the page content
187-   `contentfooter` : content below the page content
188-   `sidebarheader` : content above the left sidebar content
189-   `sidebarfooter` : content below the left sidebar content
190-   `rightsidebarheader` : content above the right sidebar content
191-   `rightsidebarfooter` : content below the right sidebar content
192-   `footer` : content in the footer
193-   `bottomfooter` : content below the footer
194
195To hide the topheader, navbar and hero, you would use the macro `~~hide-parts topheader navbar hero~~`
196
197## Icon Engine
198
199-   Mikio includes an icon engine that allows you to include icons in your pages by using <icon OPTIONS> in your content
200-   If the icon tag conflicts with another plugin, you can change the tag from `icon` to a user set value in the settings
201-   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`
202
203Users 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.
204
205## Customizing Page Footer Info Text
206
207By default, Dokuwiki inserts the text `start.txt · Last modified: 2023/12/04 10:57...` on each page. This can now be customized in the config.
208
209You can use the follow placeholders to insert page attributes:
210
211-   `{file}` - The file name of the page
212-   `{date}` - The last modification date of the page
213-   `{user}` - The user whom last edited the page
214-   `{locked}` - The user whom has the page currently locked
215
216You can also use Dokuwiki language settings by wrapping the string ID with the percentage symbol. For example use to the language string set against `lastmod`, use `%lastmod%`. In a default install under english, `%lastmod%` will be replaced with `Last modified:`.
217
218There is also support for simple optional text. By wrapping text in square brackets and at the beginning of the square bracket, inserting the placeholder name followed by an equals sign, if the placeholder exists, then the contents of the square brackets will be parsed. There is also support for `LOGGEDIN` to check if there is a logged in user.
219
220For example the string `Hello[LOGGEDIN= by {user}]` would output as `Hello` if the vistor is a guest (not logged in) or `Hello by james` if the visitor has logged into the site.
221
222Optionals can also be stacked, for example `Hello[LOGGEDIN=[USER= by {user}]]`. the `by {user}` would only be present if there is a logged in user AND the page has a user editor set.
223
224Of course, you can leave the setting blank to hide the page info altogether.
225
226The default value which is the same standard DokuWiki is: `{file} · %lastmod% {date}[LOGGEDIN=[USER= %by% {user}][LOCKED= · %lockedby% {locked}]]`
227
228## Themes
229
230Themes should be placed in the themes directory, in its own directory. LESS files are supported.
231
232## Dark Mode
233
234Mikio now supports dark mode! When the user prefers a dark theme, or has selected dark mode, the html tag will set the theme dataset to `theme-dark`, else it will be `theme-light`.
235
236You can detect this in CSS using:
237
238```
239:root[data-theme="theme-dark"] {
240  // CSS selectors here
241}
242```
243
244or in Javascript using:
245
246```
247const html = document.querySelector('html');
248if(html.dataset.theme == 'theme-dark') {
249  // ...
250}
251```
252
253## Mikio Plugin
254
255The [Mikio Plugin](https://github.com/nomadjimbob/mikioplugin/) is also available to add bootstrap 4 style + more elements to DokuWiki pages.
256
257If the plugin is installed, the **Template Styles Settings** page will be expanded to allow directly editing the plugin element styling.
258
259## Languages
260
261-   `sidebar-title` : Text for the collapsable block in the sidebar
262-   `tools-menu` : Text for the combined tools DokuWiki menu title
263-   `home` : Text for the breadcrumb home title
264
265## Releases
266
267- **_NEXT-RELEASE_**
268
269   -    Added navbar support for versionswicher plugin [#79](https://github.com/nomadjimbob/mikio/issues/79). Requested by macin.
270   -    Fixed input backgrounds not rendering colours correctly in some circumstances on the configuration page.
271   -    Fixed styling on input fields in darkmode. Style.ini now supports separate input options [#82](https://github.com/nomadjimbob/mikio/issues/82). Thanks  BioSehnsucht.
272   -    Fixed padding on inline code blocks to be smaller.
273   -    Cleaned up the display of the versionswitcher syntax. Thanks macin.
274   -    Fixed incorrect language entries [#78](https://github.com/nomadjimbob/mikio/issues/78). Thanks Little-Data.
275   -    Fixed incorrect padding on code/pre blocks [#77](https://github.com/nomadjimbob/mikio/issues/77). Thanks macin.
276
277- **_2024-06-05_**
278
279   -    Fix tag text colouring not applying correctly.
280   -    Allow hiding tags in hero if using `<tags>` element in the MikioPlugin [#70](https://github.com/nomadjimbob/mikio/issues/70). Requested by garanovich.
281
282- **_2024-05-03_**
283   -    Fixed incorrect style file names. Thanks Wolfram.
284   -    Table cell padding now adjustable through the style config page. Thanks Hakker.
285   -    Added ability to style row border color through the style config page. Thanks Elanndelh.
286   -    Added option to make the left sidebar sticky. Requested by Wolfram.
287
288- **_2024-02-09_**
289    -   Added support for DokuWiki Kaos
290    -   Updated to support PHP 8.2
291    -   Added access key support to page elements [#64](https://github.com/nomadjimbob/mikio/issues/64). Thanks rebeka-catalina.
292
293- **_2023-12-12_**
294
295    -   `autoDarkLight` configuration setting will override user setting when `showDarkLight` is disabled [#56](https://github.com/nomadjimbob/mikio/issues/56).
296    -   Cookies used in the template now use the upcoming `SameSite` requirement.
297    -   Fixed snapshots not being detected and causing script loading issues [#57](https://github.com/nomadjimbob/mikio/issues/57). Thanks schplurtz.
298    -   Updated the typescript library to support jQuery compatibility mode [#57](https://github.com/nomadjimbob/mikio/issues/57). Thanks schplurtz.
299    -   Fixed bug in config for showNotifications not being a dropdown.
300    -   Changed default value of showNotifications to `always` to reflect DokuWiki. [#58](https://github.com/nomadjimbob/mikio/issues/58). Thanks schplurtz.
301    -   Fixed z-index bug with the sub navbar. [#60](https://github.com/nomadjimbob/mikio/issues/60). Thanks schplurtz.
302
303-   **_2023-12-11_**
304
305    -   Fixed bug with tags not correctly coloured. [#59](https://github.com/nomadjimbob/mikio/issues/59). Thanks WetenSchaap.
306
307-   **_2023-12-04_**
308
309    -   Added ability to customize the page footer info text.
310
311-   **_2023-10-30_**
312
313    -   Added support for the FastWiki plugin. Requested by kjumybit.
314    -   Fixed panels on the Administration page sometimes showing dots as part of the name.
315
316-   **_2023-10-20_**
317
318    -   Fixed LESS engine not being discovered when DokuWiki is hosted in a sub directory. Thanks Jan.
319
320-   **_2023-10-16_**
321
322    -   Added color picker selector back to style page. Requested by Jan.
323
324-   **_2023-10-14_**
325
326    -   Fixed bug where external page tools where not showing in the tool bar. Thanks Jan.
327
328-   **_2023-06-05_**
329
330    -   Fixed bug with `~~hide-parts~~` no longer working. [#52](https://github.com/nomadjimbob/mikio/issues/52). Thanks nathanmcguire.
331    -   Mikio Control Macros now support the format `-~SETTING~-` as well as the standard `~~SETTING~~`. This fixes an incompatibility with the [Comment Syntax support](https://www.dokuwiki.org/plugin:commentsyntax) extension.
332
333-   **_2023-05-19_**
334
335    -   Fixed notifications appearing in weird places at times.
336    -   Setting `tpl»mikio»showNotifications` to an empty string is the same as setting it to `always`.
337    -   Fixed languages not shown in dropdown correctly with the translate plugin when `plugin»translation»dropdown` is turned on.
338    -   Fixed some css issues on small screens.
339
340-   **_2023-05-18_**
341
342    -   Added automatic Light/Dark mode option (disabled by default).
343    -   Added support for the [translate plugin](https://www.dokuwiki.org/plugin:translation).
344
345-   **_2023-05-13_**
346
347    -   Fixed tables not being styling correctly and incorrect language used in the styling config [#50](https://github.com/nomadjimbob/mikio/issues/50). Thanks RonaldPR.
348    -   The themes LessC engine will output any exceptions that occur in the fallback CSS to help track issues.
349
350-   **_2023-05-11_**
351
352    -   Fixed empty scrollbars being shown when TOC is set to full height [#49](https://github.com/nomadjimbob/mikio/issues/49). Thanks vitaprimo and RonaldPR.
353    -   Added a `noshadow` subtheme
354
355-   **_2022-10-31_**
356
357    -   Added support to directly editing Mikio Plugin within Template Style Settings.
358
359-   **_2022-10-12_**
360
361    -   Fixed blank page being displayed instead of media detail [#48](https://github.com/nomadjimbob/mikio/issues/48). Thanks spratinatin
362
363-   **_2022-10-09_**
364
365    -   Fixed issue of new elements not being added to CSS when a custom template style is set
366    -   Fixed issue of wiki page style (existing and missing) not taking priority of link colouring
367    -   Added support for styling link pseudo classes (visited, hover, active) for links and page links [#47](https://github.com/nomadjimbob/mikio/issues/47). Thanks chrbinder
368
369-   **_2022-10-04_**
370
371    -   Cleaned up the code to PHPCS standards
372    -   Fixed breadcrumb layouts on mobile [#31](https://github.com/nomadjimbob/mikio/issues/31)
373    -   Fixed Media Manager on small displays
374    -   Fixed layout compatiblity on Greebo
375    -   Fixed search results layout [#41](https://github.com/nomadjimbob/mikio/issues/41)
376    -   Added Dark-mode support [#43](https://github.com/nomadjimbob/mikio/issues/43). Thanks chrbinder
377    -   Fixed incorrect file names listed [#45](https://github.com/nomadjimbob/mikio/issues/45). Thanks babudro
378    -   Fixed sidebars not showing [#46](https://github.com/nomadjimbob/mikio/issues/46). Thanks dasbenjo
379
380-   **_2022-05-10_**
381
382    -   Added support to directly set title icon width and height in config. Thanks AlexiaR
383
384-   **_2022-05-05_**
385
386    -   Fixed searching for images in the theme directory [#42](https://github.com/nomadjimbob/mikio/issues/42). Thanks cmacmackin
387    -   Added support for the defer js option, previously always deferred [#39](https://github.com/nomadjimbob/mikio/issues/39). Thanks cmacmackin
388    -   Added typeahead search [#40](https://github.com/nomadjimbob/mikio/issues/40). Thanks cmacmackin
389    -   Fixed double breadcrumb options on admin pages
390    -   Added sticky top header, navbar and header options. Thanks chitland
391
392-   **_2022-03-05_**
393
394    -   Fixed page tools in footer not being horizontal [#38](https://github.com/nomadjimbob/mikio/issues/38). Thanks chitland
395    -   Fixed Mikio Config headers disappearing in some cases
396    -   Separated Breadcrumbs and You Are Here items [#36](https://github.com/nomadjimbob/mikio/issues/36). Thanks chitland
397
398-   **_2021-12-11_**
399
400    -   Added table row background styling options
401    -   Fixed styling issue when using the indexmenu plugin [#35](https://github.com/nomadjimbob/mikio/issues/35). Thanks 3ole.
402    -   Fixed inconsitant tab/spaces in mikio.less and mikio.css
403    -   Removed debug logs from mikio.js
404    -   Fixed input placeholders not hiding in prepopulated fields [#34](https://github.com/nomadjimbob/mikio/issues/34)
405    -   Added option to hide menu and page tool items [#32](https://github.com/nomadjimbob/mikio/issues/32). Thanks annievoss.
406    -   Fixed compadibility with BookCreator [#26](https://github.com/nomadjimbob/mikio/issues/26). Thanks johncourtland.
407    -   Fixed Greebo styling errors not present in Hogsfather
408
409-   **_2021-08-11_**
410
411    -   Fixed path check on Windows [#33](https://github.com/nomadjimbob/mikio/issues/33)
412    -   Recompilied CSS
413
414-   **_2021-06-17_**
415
416    -   Added support for navbar title link to use showpageafterlogin setting if installed [#27](https://github.com/nomadjimbob/mikio/issues/27)
417
418-   **_2021-06-09_**
419
420    -   TOC is now full width on mobile [#25](https://github.com/nomadjimbob/mikio/issues/25)
421    -   Hamburger and sidebar icons are now displayed correctly [#23](https://github.com/nomadjimbob/mikio/issues/23), [#24](https://github.com/nomadjimbob/mikio/issues/24)
422    -   Site width is now available under Template Style Settings [#22](https://github.com/nomadjimbob/mikio/issues/22)
423    -   TOC is now sticky when set to full height [#21](https://github.com/nomadjimbob/mikio/issues/21)
424    -   Added support to the theme being linked by a symbolic link [#20](https://github.com/nomadjimbob/mikio/issues/20)
425    -   Mikio will now fallback to using CSS when there is the LESS engine is not detected [#20](https://github.com/nomadjimbob/mikio/issues/20)
426
427-   **_2021-03-10_**
428
429    -   Fixed bad breadcrumb URL formatting on sites using userewrite [#19](https://github.com/nomadjimbob/mikio/issues/19)
430
431-   **_2021-03-04_**
432
433    -   Added support to hide page elements [#18](https://github.com/nomadjimbob/mikio/issues/18)
434
435-   **_2021-01-22_**
436
437    -   Fixed a syntax error with the core css
438
439-   **_2020-11-12_**
440
441    -   Corrected terminology in readme to match Dokuwiki [#17](https://github.com/nomadjimbob/mikio/issues/17)
442    -   Fix showing part of the sidebar when it should be hidden in certain conditions [#16](https://github.com/nomadjimbob/mikio/issues/16)
443    -   Added option to always show the sidebar, even when there is no content [#16](https://github.com/nomadjimbob/mikio/issues/16)
444
445-   **_2020-10-07_**
446
447    -   Fixed hero header parsing on some servers
448    -   Fixed safari color picker issue [#14](https://github.com/nomadjimbob/mikio/issues/14)
449    -   LESS now defaults to enabled with fallback to ctype functions built into mikio for docker apps [#13](https://github.com/nomadjimbob/mikio/issues/13)
450    -   Fix for Template Style Settings being ignored [#12](https://github.com/nomadjimbob/mikio/issues/12)
451
452-   **_2020-10-01_**
453
454    -   Fix for `sidebarMobileDefaultCollapse` option being inconsistent in code and not working correctly [#11](https://github.com/nomadjimbob/mikio/issues/11). Thanks to GJRobert for catching that.
455
456-   **_2020-09-27_**
457
458    -   Sidebars hidden by default in mobile view [#10](https://github.com/nomadjimbob/mikio/issues/10)
459    -   Fixed errors with the LESS compilier on some nginx configurations
460    -   Fixed styling and image display thumb size in media manager popup
461    -   Fixed text field placeholders not disappearing with text entry
462    -   Added support for Hogfather
463    -   Added option to use LESS or direct CSS. Some configurations (docker linuxserver/dokuwiki) do not have the required PHP extensions installed
464    -   Supports Docker linuxserver/dokuwiki container file structures
465
466-   **_2020-09-10_**
467
468    -   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](https://github.com/nomadjimbob/mikio/issues/7)
469    -   Template.info.txt now shows correct release dates [#8](https://github.com/nomadjimbob/mikio/issues/8)
470    -   Fixed rightsidebar php warnings
471    -   Code/Pre blocks no longer have padding applied on the admin pages
472
473-   **_2020-08-26_**
474
475    -   Footer is no longer shown outside of page view
476    -   Public messages are now displayed on the page
477    -   Fixed icon rendering in hero bar
478    -   Fixed TOC rendering bug
479
480-   **_2020-07-27_**
481
482    -   Added option to show wiki footer in page content
483
484-   **_2020-07-24_**
485
486    -   Fixed image detail bug
487
488-   **_2020-07-20_**
489
490    -   Fixed prewrap and sidebar search bar margins
491
492-   **_2020-07-16_**
493
494    -   Merged code block styling with pre
495    -   Fixed mediamanager failures on 2018-04-22a "Greebo" [#5](https://github.com/nomadjimbob/mikio/issues/5)
496    -   Icon tag is rendered correctly in preview [#4](https://github.com/nomadjimbob/mikio/issues/4)
497
498-   **_2020-07-15_**
499
500    -   Fixed an issue with the simple_html_dom library when editing a section of a page caused page corruption [#3](https://github.com/nomadjimbob/mikio/issues/3)
501
502-   **_2020-07-14_**
503
504    -   Added id=dokuwiki\_\_content identifier for the page content element
505    -   Added styling and fixed overflow issues with pre elements
506    -   Fixed page width overflow issues
507
508-   **_2020-07-09_**
509
510    -   Fixed cosmetic display issues when `input[type=file]` is hidden by plugins [#2](https://github.com/nomadjimbob/mikio/issues/2)
511
512-   **_2020-07-07_**
513    -   Initial release
514
515## Third Party Libraries
516
517This template uses a [modified
518version](https://github.com/nomadjimbob/simple_html_dom) of
519[simple_html_dom](https://sourceforge.net/projects/simplehtmldom/) and
520[bootstrap-3-typeahead](https://github.com/bassjobsen/Bootstrap-3-Typeahead).
521
522## Support
523
524-   If you think you have found a problem, or would like to see a feature, please [open an issue](https://github.com/nomadjimbob/mikio/issues)
525-   If you are a coder, feel free to create a pull request, but please be detailed about your changes!
526