Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revision | |||
| projects:dokuwiki:ad-hominem:index [2025/03/18 22:35] – removed - external edit (Unknown date) 127.0.0.1 | projects:dokuwiki:ad-hominem:index [2025/03/18 22:35] (current) – ↷ Page moved and renamed from projects:dokuwiki:ad-hominem-template to projects:dokuwiki:ad-hominem:index admin | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== Ad Hominem Template ====== | ||
| + | A simple and lightweight template, based on the standard DokuWiki template, but with many additional, modern features. | ||
| + | |||
| + | <aside float-right box> | ||
| + | * Dokuwiki: \\ [[doku> | ||
| + | * Github: \\ [[github> | ||
| + | </ | ||
| + | |||
| + | A short overview of the main features of this template: | ||
| + | |||
| + | * Prominent search field with preloading search results. | ||
| + | * Collapsible sidebar and table of contents. | ||
| + | * Link preview: title and first paragraph of the linked page is shown in the title text. | ||
| + | * This also works for Wikipedia links! | ||
| + | * Two (!) different well designed print modes | ||
| + | * The template implements [[https:// | ||
| + | * [[wp> | ||
| + | * Integrated " | ||
| + | * Fully responsive: works on all display formats, from smartphones to 4K monitors | ||
| + | * User-side controlled “dark mode”, i.e. follows the client side dark mode settings. | ||
| + | * Configuration to override the " | ||
| + | * Integrated languages menu (for the Translate plugin) | ||
| + | |||
| + | These features are explained in more detail below: | ||
| + | ===== Search field ===== | ||
| + | |||
| + | One of the strengths of DokuWiki is the well-integrated and powerful [[doku> | ||
| + | |||
| + | < | ||
| + | < | ||
| + | < | ||
| + | |||
| + | ===== Collapsible sidebar and table of contents ===== | ||
| + | |||
| + | Also the [[doku> | ||
| + | |||
| + | On **desktop** screen sizes, there is an inconspicuous button to fold the sidebar to the edge. In this state the main content area is enlarged. The sidebar also collapses automatically in the //admin// vor //edit// view. | ||
| + | |||
| + | On **mobile phone** screen sizes, the sidebar will behidden and instead a “hamburger” menu is shown in its place. A click on this icon will show the sidebar as a floating menu. | ||
| + | |||
| + | The **Table of Contents** is by default collapsed to a “hamburger” menu in the top right corner of the main area (top-left on right-to-left languages). A click on this icon expands the <abbr "Table of Contents"> | ||
| + | |||
| + | ===== Link preview ===== | ||
| + | |||
| + | The template comes with a built-in system for link-previews. They work in a way that when a mouse pointer is hovered over certain links, a preview text is loaded into the '' | ||
| + | |||
| + | < | ||
| + | < | ||
| + | < | ||
| + | |||
| + | This function is available for // | ||
| + | |||
| + | Give it a try on the links in the previous paragraph: just hover your mouse over any of the links! | ||
| + | |||
| + | To reduce overhead, the preview text is only loaded when the mouse pointer is actually over the link. This may cause a slight delay in showing the preview, but reduces the overall network load. | ||
| + | |||
| + | Unfortunately, | ||
| + | |||
| + | To make the best of this function, it is a good practice to always start each article with a main headline (level 1), followed by a short plain text paragraph with a synopsis of the article. This is also the most user-friendly way to begin your wiki-articles (I wished the Wikipedia authors would also take the “short” aspect a bit more seriously). | ||
| + | |||
| + | ===== Cookie banner ===== | ||
| + | |||
| + | The template has a built-in cookie-banner to fulfil the requirements of EU-based wikis. It looks as follows: | ||
| + | |||
| + | < | ||
| + | |||
| + | The template’s configuration settings contain three options to modify the cookie banner: | ||
| + | |||
| + | - **Display the Cookie message banner**: Disable or change the position of the cookies banner: | ||
| + | * **Don’t show**: No cookie banner is shown to the visitor. | ||
| + | * **Show on bottom of page**: The cookie banner is shown on the bottom of the screen (default). | ||
| + | * **Show on top of page**: The cookie banner is shown on the top of the screen. \\ | ||
| + | - **The message to display on the Cookie banner**: This is a free-text field that allows to enter the text that is displayed in the banner. This may even contain HTML tags as it will be copied “as is” into the page code. \\ | ||
| + | - **Link to the “More information” page**: this can be an internal or external address that will be linked via the “more information” button. | ||
| + | |||
| + | Clicking on the “OK”-button will close the banner and set a 1-year cookie named “'' | ||
| + | |||
| + | Note that for technical reasons, the cookie banner can not actually prevent DokuWiki from setting any cookies. However, all standard DokuWiki cookies, as well as the '' | ||
| + | |||
| + | Also keep in mind that the linked “More information” page should give detailled information on the cookies and data collection practices. | ||
| + | |||
| + | ===== Translation plugin integration ===== | ||
| + | |||
| + | For multilingual wikis, the template already contains the necessary code to seemlessly integrate the [[doku> | ||
| + | |||
| + | < | ||
| + | < | ||
| + | |||
| + | Alternatively, | ||
| + | |||
| + | < | ||
| + | < | ||