====== kiwiki Template ======

---- template ----
description   : Flex theme with lots of css fix and some ease of use features
author        : Nicolas Prigent
email         : mail.nicolasprigent@gmail.com 
lastupdate_dt : 2024-05-13
compatible    : Jack Jackrum
depends       :
similar       :
conflicts     : 
tags          : flex, responsive, custom menu, sticky, dark mode, light mode, ux

downloadurl   : https://github.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/archive/master.zip
bugtracker    : https://github.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/issues
sourcerepo    : https://github.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/
donationurl   : 

screenshot_img: https://raw.githubusercontent.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/main/screenshots/kiwiki_screenshot_2023_06_19_00.jpg
----

===== ABOUT =====

Kiwiki is a flex theme that redesigns your dokuwiki to something quite modern and more appealing. It has a lot of css fix and some ease of use features.

===== MAIN FEATURES =====

  * Reorganised UI for ease of use and clarity
  * Light and dark mode, with a detection of os preferences, and override with cookie when clicking a button
  * Change all colors of the theme to your own taste, for both light and dark theme
  * Custom menu feature on the left side of the content that you can edit as you want. Choose wich page you want to be the menu in the configuration panel.
  * Sidebar with the menu and the table of content is sticky if the spage is long enought.
  * Access full page edit on a single click on the top right of the content of your page. Same thing for the menu.
  * Back to top button fixed on the bottom right corner of the screen
  * Fully responsive design
  * Compatibility with Translation Plugin
  * Custom drawn svg icons
  * An original Kiwiki logo and favicon :)

===== SCREENSHOTS ======
  * Default colors
{{ https://raw.githubusercontent.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/main/screenshots/kiwiki_screenshot_2023_06_19_00.jpg?recache | Default colors }}
  * Dark colors example
{{ https://raw.githubusercontent.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/main/screenshots/kiwiki_screenshot_2023_06_19_01.jpg?recache | Dark colors example }}
  * Theme colors editor
{{ https://raw.githubusercontent.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/main/screenshots/kiwiki_screenshot_2023_06_19_02.jpg?recache | Theme colors editor }}

===== DOWNLOAD AND INSTALL ======

Use the following URL to download this template:

  * https://github.com/nicolasprigent/Dokuwiki-Kiwiki-Theme/archive/master.zip

Refer to [[:template]] on how to install and use templates in Dokuwiki.

===== CHANGELOG =====
==== 2024-05-13 ====
  * Fix: php warning errors on non existing variables
  * Refactoring of the edit icon button for it to use the correct dokuwiki classes (Menu and MenuItem), and get the same authorizations than the default edit page link.

==== 2024-02-26 ====
  * Fix: edit_page button break when userewrite and useslash config enabled. Thanks to @AzurCrystal
  * Fix : long links overflow on mobile view. Thanks to @Gabe-LSN

==== 2024-01-27 ====
  * Added max height for left menu

==== 2024-01-16 ====
  * Added Chinese language. Thanks to @AzurCrystal

==== 2024-01-10 ====
  * Added css for tables in content

==== 2023-11-27 ====
  * Updated editor css for readability

==== 2023-11-23 ====
  * The edit button was limited to admin group only, now it checks edit permissions

==== 2023-11-06 ====
  * Fix on mobile menu switch not hiding navigation menu on mobile if translation plugin is activated

==== 2023-10-19 (features suggestions from @Chris75forumname) ====
  * Added go to bottom button with option to activate it or not
  * Added fullscreen button in header
  * Added connected user information on footer, with option to activate it or not
  * Added ACL informations on footer (only for editors), with option to activate it or not
  * Added ACL group list in user page has an info

==== 2023-10-18 ====
  * Added back the message area on connection page

==== 2023-10-12 ====
  * Added max height for table of content in theme configuration

==== 2023-10-02 ====
  * Bug fix on menu disappearing on deep level pages

==== 2023-09-30 ====
  * Added compatibility with Translation Plugin

==== 2023-09-01 ====
  * Updated css to have the filters working on small size screens

==== 2023-07-25 ====
  * New language Added German language - Thanks to @holisticagile

==== 2023-07-23 ====
  * Fixed issue about public wikis getting no header
  * Added back to home link on login page
  * Some css fixes on login page

==== 2023-07-02 ====
  * New style parameter for changing header colore

==== 2023-06-21 ====
  * CSS fix for dark mode
  * Default style.ini adjusted on some colors

==== 2023-06-19 ====
  * CSS fixes on the extension manager page
  * New screenshots to show the theme light/dark mode switcher

==== 2023-06-16 ====
  * Added light/dark theme mode, with separated customization
  * Detection of os preferences for light or dark mode
  * Override with cookie when clicking a button


==== 2023-06-15 ====
  * Fixed word wrapping for pre code blocks on mobile
  * Fixed the edit icon position on mobile

==== 2023-06-14 ====
  * Initial release

===== SITES USING THE TEMPLATE =====

  * My wiki (private)
  * [[https://icaging.eu|ICaging]] (research project) - thanks ;-)


===== TODO =====

  * Add more languages support (English and French on initial release)
  * Any ideas are more than welcome