template:ad-hominem
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
template:ad-hominem [2021-06-05 11:22] – sascha-leib | template:ad-hominem [2024-03-27 13:11] (current) – [Cookies Banner] sascha-leib | ||
---|---|---|---|
Line 2: | Line 2: | ||
---- template ---- | ---- template ---- | ||
- | description | + | description |
author | author | ||
email : ad@hominem.info | email : ad@hominem.info | ||
- | lastupdate_dt : 2021-06-04 | + | lastupdate_dt : 2024-02-07 |
- | compatible | + | compatible |
depends | depends | ||
- | conflicts | + | conflicts |
similar | similar | ||
- | screenshot_img: | + | screenshot_img: |
- | tags : responsive, sidebar, mobile, print, html5, css3, semantic, clean, accessible, | + | tags : responsive, sidebar, mobile, print, html5, css3, semantic, clean, dark, dark-mode, customizable, |
- | downloadurl | + | downloadurl |
bugtracker | bugtracker | ||
sourcerepo | sourcerepo | ||
---- | ---- | ||
- | This is an attempt to create a very simple and lightweight template for DokuWiki that stays true to the ideas of the original design but modernizes the code and improve on the usability. | + | This is an attempt to create a very simple and lightweight template for DokuWiki that stays true to the ideas of the original design, but modernizes the code and improve on the usability. |
- | It was designed to work for my DokuWiki site of the same name (link, see below) but may be useful for others, too. | + | It was designed to work for my DokuWiki site of the same name (now migrated to [[https:// |
- | Please keep in mind that this is still "work in progress", | + | This is provided |
Feedback and bug reports are of course always welcome :-) | Feedback and bug reports are of course always welcome :-) | ||
Line 33: | Line 33: | ||
* This also works for Wikipedia links! | * This also works for Wikipedia links! | ||
* Looks good in print. | * Looks good in print. | ||
- | * Tries to implement | + | * The template implements |
- | * Neatly formatted and standards-compliant code. | + | * [[wp> |
+ | * Neatly formatted and standards-compliant code (where possible – again, the DokuWiki content renderer is the limiting factor) | ||
+ | * Makes better use of larger screens (target is half of a 4K screen), but because the template is fully responsive, smaller is no problem (down to ca. 300px wide) | ||
+ | * improvements to edit view, media manager, etc. | ||
+ | * User-side controlled “dark mode”, i.e. follows the client side dark mode settings. | ||
+ | * Improvements to the default functionality, | ||
+ | * Configuration to override the " | ||
+ | * Integrated " | ||
+ | * Compatible with PHP8 and DokuWiki “Kaos”. | ||
===== Download and Install ====== | ===== Download and Install ====== | ||
- | Use the following URL to download this template: | + | The easiest way to install |
+ | |||
+ | Alternatively, | ||
* https:// | * https:// | ||
- | Refer to [[: | + | Refer to [[: |
+ | |||
+ | ===== Configuration ===== | ||
+ | |||
+ | The configuration options are now documented on the [[https:// | ||
+ | |||
+ | In short, the following configuration features are available: | ||
+ | |||
+ | * Icons and site logos – specific names to be used to overwrite the default site logos and e.g. the favicon. | ||
+ | |||
+ | * Page blocks – you can upload HTML snippets that are then inserted at specific places of all pages, e.g. in the footer or the sidebar. | ||
+ | |||
+ | * Template options in the site configuration page (section: " | ||
+ | |||
+ | Details on how to configure these can be found on the page linked above. | ||
+ | |||
+ | ===== Cookies Banner ===== | ||
+ | |||
+ | This template has its own, built-in " | ||
+ | |||
+ | There are three settings that control the behaviour of this | ||
+ | |||
+ | * " | ||
+ | |||
+ | * "The message to display on the Cookie banner": | ||
+ | |||
+ | * "Link to the “More information” page": this is either an internal or external address that the "More information" | ||
+ | |||
+ | ==== Override Home Link ==== | ||
+ | |||
+ | The template has an option to override the " | ||
+ | |||
+ | If you enter, for example, "/ | ||
+ | |||
+ | Leaving the field empty will keep the original behaviour (home is your wiki homepage) intact. | ||
+ | |||
+ | ===== Dark Mode ===== | ||
+ | |||
+ | This template supports client-controlled “dark mode”. This means that visitors to your site who have "dark mode" activated on their machines will see the site in a suitable dark colour scheme. | ||
+ | |||
+ | The following screenshots show the light and dark mode side by side: | ||
+ | |||
+ | {{ https:// | ||
+ | |||
+ | Generally, there is nothing to do for a site admin, but please be aware of this, and make sure to check your site in dark mode from time to time (or in light mode, if you normally use dark mode). | ||
+ | |||
+ | There are two potential issues to be aware of: | ||
+ | |||
+ | * If you used the " | ||
+ | |||
+ | * If possible, create images in a way that they also work with dark backgrounds. Especially if you use transparency, | ||
+ | |||
+ | There is more documentation available on the project’s [[https:// | ||
+ | |||
+ | And, of course, you can also override the dark mode colours using the [[plugin: | ||
+ | |||
+ | ===== Cookies ===== | ||
+ | |||
+ | This template also comes with its own implementation of the [[plugin: | ||
+ | |||
+ | The “'' | ||
+ | |||
+ | Please keep in mind, however, that the DokuWiki system sets additional cookies, which are explained on [[faq: | ||
+ | |||
+ | ===== 2-column “compact” print style ===== | ||
+ | |||
+ | Since 1.5 there is now an option to switch from the default " | ||
+ | |||
+ | This " | ||
+ | |||
+ | Most importantly, | ||
+ | |||
+ | If you use the [[plugin: | ||
+ | |||
+ | > ''< | ||
+ | > … | ||
+ | > ''</ | ||
+ | |||
+ | Another option is the [[plugin: | ||
+ | |||
+ | > ''< | ||
+ | > … | ||
+ | > ''</ | ||
+ | |||
+ | Last but not least: ''< | ||
+ | |||
+ | Other print-related classes include '' | ||
+ | |||
+ | ===== HTML Tags ===== | ||
+ | |||
+ | As of DokuWiki “Jack Jackrum”, embedding HTML tags in the DokuWiki code is no longer supported. In order to still allow semantic markup to be added, the autor of this template also provides a plugin, [[plugin: | ||
+ | |||
+ | This has been developed with, and is designed to be used with this template (though it is fully useable with other templates as well, of course). | ||
- | ===== Sites using this Template | + | ===== Visit my site ===== |
- | * [[https:// | + | The best way to experience this template is by browsing my sites, which make full use of it: |
+ | * [[https:// | ||
+ | * [[https:// | ||
template/ad-hominem.1622884958.txt.gz · Last modified: 2021-06-05 11:22 by sascha-leib