Table of Contents
DokuWiki in het kort
Introductie
Een wiki1) is een handige tool om bedrijfsdocumentatie zoals bijvoorbeeld technische documenten, contracten, werkprocedures en work-flows vast te leggen, te organiseren en te centraliseren. Tevens hebben wiki's een zoekfunctie die gebruikers in staat stelt om de daarin opgeslagen informatie ook weer snel te vinden.
DokuWiki is een open-source tool om een wiki mee te bouwen en bestaat al sinds 2004. Achter de tool zit een stabiele en actieve developer community die ongeveer eens per anderhalf jaar een nieuwe stabiele versie uitbrengt. Het DokuWiki-logo dat hieronder wordt getoond, geeft het concept van een wiki beknopt weer. De tweekleurige potloden staan voor verschillende gebruikers die dezelfde pagina's kunnen aanpassen. Tevens geven de verschillende pijlen aan dat het eenvoudig mogelijk is om pagina's onderling te linken en er, indien gewenst, één geheel van te maken.
De keuze voor het gebruik van DokuWiki op johngeerlings.com is ingegeven door het feit dat ik al jarenlang fan ben van deze zeer universele tool, deze bij bedrijven implementeer en erover adviseer. In deze DokuWiki instantie laat ik de veel verschillende functies en presentatiemogelijkheden zien die door de core-software of door plugins mogelijk worden gemaakt.
Layout
Voor de layout wordt gebruik gemaakt van de Bootstrap3 template die door mij vergaand is aangepast. Dat is immers het mooie van open-source software en de daarvoor geldende licentie. Je kunt in principe alles (laten) aanpassen en het daarmee geschikt maken voor meerdere doeleinden.
Het lettertype dat je nu leest, wordt ook gebruikt op de site van Ubuntu Linux. Ik vind dit een prettig leesbaar font dat er tevens modern uitziet. Ubuntu is één van de vele Linux distributies en misschien wel de meest succesvolle desktop Linux variant. Het lettertype heet ook Ubuntu, heeft een open licentie en is vrij beschikbaar.
Eén van de vele goede plugins die beschikbaar zijn voor DokuWiki is Datatables. Hiermee is het mogelijk om fraai vormgegeven tabellen samen te stellen die interactief, maar toch volledig browser-based zijn. Een voorbeeld hiervan staat op de pagina over Datatables. En ander voorbeeld is te zien op de muziekpagina waarbij in elke rij in 1 van de kolommen een live-link naar een Youtube video is opgenomen.
Een laatste layout-ding is de inhoudsopgave die automatisch wordt gegenereerd. Deze zie je hiernaast als je scherm er breed genoeg voor is, of bovenaan de pagina als uitklaplijst. Ik vind dat mooi, overzichtelijk en handig omdat je op de verschillende kopjes kunt klikken om naar de gewenste paragraaf te springen.
Gebruikte plugins
Op deze site worden de volgende plugins gebruikt:
- Pagebreak plugin 2016-02-16 by Jonathan McBride and Chris Sturm
Inserts " <br style="page-break-after:always;"> " into the html of the document for every <pagebreak> it encounters - comment 2016-04-26 by Gina Häußge, Michael Klier
Add comments/notes to your wiki source that won't be shown on the page. - Video Sharing Site Plugin 2020-03-18 by Andreas Gohr
Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}} - tablelayout plugin 2019-06-17 by Michael Große
Set the width of table columns and set which lines to fix - Pagelist Plugin 2017-08-24 by Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Lists pages in a nice formatted way - Tag Plugin 2017-08-24 by Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
tag wiki pages - Add New Page 2015-11-02 by Benjamin Santalucia, Sam Wilson, Michael Braun, Gerrit Uitslag, Albert Chern
Adds a "new page form" to any wiki page. (Beware: modified by JohnG - eQTeam) - Gallery Plugin 2019-01-05 by Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - inlinetoc 2015-06-19 by Nicolas FAUVET
Renders the toc of a page inside the page content, a la Mediawiki - include plugin 2018-11-29 by Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
Functions to include another page in a wiki page - Blockquote Plugin 2017-08-25 by Anika Henke (previous author: Gina Haeussge)
Write quotations in a semantically correct way - Wrap Plugin 2018-04-22 by Anika Henke
Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction. - Search Form Plugin 2014-07-30 by Gerrit Uitslag, (previous: Adolfo González Blázquez)
Inserts a search form in any page - Color Highlight Plugin 2013-10-24 by Joseph Nahmias
Highlight text with a specific color - Syntax: <hi color>highlighted content</hi> - Indexmenu Plugin 2015-08-26 by Samuele Tognini
Show a customizable and sortable index for a namespace - Pagebox Plugin (syntax component) 2010-09-06 by Luigi micco
Allow to use box like MediaWiki to show table and pages - Variable Plugin 2017-06-11 by Gina Häußge, Michael Klier, Esther Brunner, Luis Machuca Bezzaza
Insert dynamic variables. - Cloud Plugin 2019-02-15 by Michael Hamann, Michael Klier, Gina Haeussge
Displays the most used words in a word cloud. - DataTables Plugin (NIET UPDATEN) 2016-03-14 by Giuseppe Di Terlizzi
Add DataTables support to DokuWiki (met werkende responsive functie)
1)
De naam wiki is ontleend aan de Hawaiiaanse taal en betekent snel. De bedenker, Ward Cunningham, werd geïnspireerd toen hij in de Wiki Wiki Shuttle bus stapte op de luchthaven van Honolulu. Zie ook https://nl.wikipedia.org/wiki/Wiki