User Tools

Site Tools


homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies [2026/10/20 15:41] – ↷ Page name changed from homelab:besluiten:26.001-installatie-docuwiki-incl-extensies to homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies mielshomelab:besluiten:26.001-installatie_dokuwiki_incl_extensies [2026/10/20 18:09] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== 26.001 Installatie DokuWiki incl. extensies ====== ====== 26.001 Installatie DokuWiki incl. extensies ======
  
-  * **Aangemaakt:** 2026-01-04 +  * **Wat**: Keuze voor DokuWiki, met een aantal extensies, als wiki voor de documentatie van het homelab. 
-  * **Context / Aanleiding:** +  * **Datum**: 2026-01-04 
-    * Behoefte aan consistente documentatie van steeds complexer homelab +  * **Betreft**: [[homelab:services:docuwiki|DokuWiki]], [[homelab:devices:synology_ds423|Synology DS423+]]
-    * Snel en eenvoudig nieuwe pagina’s kunnen aanmaken volgens bepaald format +
-    * Overzicht behouden bij groei van het homelab+
   * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}}   * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}}
 +  * **Thema's**: {{tag>container}}
 +/* Beschikbare thematags (kies er 0 of meer, gescheiden met een spatie):
 +backup
 +bandbreedte
 +container, vm
 +dns, firewall, vpn
 +guest, iot, lan, servers
 +multi-user
 +Uitleg en "Bij wijziging": resources:metadata:tags:thema
 +Nieuwe tag? Maak een tagpagina en werk deze lijst bij in de templates voor services, devices en besluiten. */
  
 +===== Context =====
 +  * Behoefte aan consistente documentatie van een steeds complexer homelab.
 +  * Snel en eenvoudig nieuwe pagina's kunnen aanmaken volgens een vast format.
 +  * Overzicht behouden bij groei van het homelab.
  
- ===== Relaties ===== +===== Opties ===== 
-/* Overzicht van hoe onderstaande kolommen gevuld (moeten) worden: +  * **Gekozen: DokuWiki met extensies**: ondersteunt templates, een eigen startpagina per namespace, links naar nog niet bestaande pagina's, en backlinks en tags. 
- x = NVT +  * **Afgewezen: Wiki.js**: eerst geprobeerd, maar: 
- - = Wordt vanzelf gevuld dmv backlinks +    * Ondersteunt geen templates (steeds handmatig copy-pasten). 
- V = Handmatig specificeren! +    * De navigatie voelt onnatuurlijk: binnen een namespace kan je geen standaard landingspagina maken waarop de toepassing van die namespace wordt toegelicht. 
- * = Hybride, kan gevuld worden met backlinks of harde links (bijv. services onder Portainer) +    * Je kan geen links maken naar nog niet bestaande pagina's (om bijvoorbeeld binnen een item ''vlan1'' te noemen, zodat je later die pagina aanmaakt en kan zien waar backlinks vandaan komen). 
- +    * Een pagina met backlinks of een lijst van alle pagina's met een bepaalde tag is er niet of lastig te maken.
- x Besluiten +
- V Services  +
- V Devices: +
- V Netwerk: firewall, vlan, dns-dhcp +
- V Tags: bandbreedte container vpn multi-user backup vm +
-   Gebruik van tags: {{tag>tag1 tag2}} +
- +
-Voeg aanvullingen mogen ook toe aan [[i_template|de template]] +
-*/ +
- +
-^ [[homelab:services:start|Services]] ^ [[homelab:devices:start|Devices]] ^ [[homelab:standaarden:netwerk:start|Netwerk]]  ^ [[resources:metadata:tags:start|Tags]]  ^ +
-|  [[..:services:docuwiki|DokuWiki]] \\ [[portainer|Portainer]]  | [[..:devices:synology_ds423|NAS: Synology DS423+]]   |         | {{tag>container}}                                         ^ +
  
 ===== Besluit ===== ===== Besluit =====
- +  * DokuWiki draait als Docker-container op de NAS, met extensies voor templates, inhoudsopgaven, verplaatsen, tags, backlinks en commentaar. De extensies en hun instellingen staan op de [[homelab:services:docuwiki|DokuWiki-pagina]].
-  * **Gekozen optie:** DokuWiki en extensies (zie [[#plugins|hieronder]]) +
- +
- +
-  * **Motivatie bij keuze wiki:** +
-    * Aanvankelijk Wiki.js geprobeerd. Nadelen: +
-      * Ondersteunt geen templates (steeds handmatig copy-pasten) +
-      * Navigatie voelt onnatuurlijk. Je kan binnen een namespace niet een default landing page maken waarop de toepassing van die namespace wordt toegelicht +
-      * je kan geen links maken naar nog niet bestaande pagina's (om bijv. binnen een item vlan1 te noemen, zodat je later die pagina aan kan maken en kan laten zien van waar er backlinks zijn) +
-      * pagina met backlinks / lijst van alle pagina's waar een tag op is gebruikt is er niet/lastig te maken +
-    * Vervolgens DokuWiki geprobeerd. Ondersteunt dat wel. +
- +
-==== Plugins ==== +
- +
-  * **TemplatePageName**\\ ondersteunt vaste pagina-opbouw (baseline + optioneel) +
-  * **CatList**\\ voorkomt handmatig onderhouden van inhoudsopgaves binnen een namespace en vergelijkbare lijsten +
-  * **MovePage**\\ maakt herstructureren mogelijk zonder linkbreuk +
-  * **Tag** (en benodigde plugin **Pagelist**)\\ om gebruik van tags (oa tbv status van documenten) vast te leggen +
-  * **Backlinks**\\ om bijv. onder een device de services te listen die er op draaien +
-  * **Comment**\\ Voeg commentaar toe dat je alleen ziet bij het bewerken van pagina's+
  
 ===== Gevolgen ===== ===== Gevolgen =====
- +  * **Technisch**: 
-  * **Technisch:** +    * Bereikbaar via een reverse proxy: van thuis, van het werk en via het IP van de mobiele provider. 
-    * Draait als docker container +  * **Operationeel**: 
-    * bereikbaar via reverse proxy, huis, werk of ip van mobiele provider +    * De container wordt via WUD bijgewerkt; het risico op breaking changes is laag. 
-    * Impact/overwegingen/eigenschappen mbt (netwerk)configuratie, performance, beheer +    * De data staat op volume 2 en valt daarmee onder de NVMe-backup. 
-  * **Operationeel:** +  * **Risico's**: 
-    * Container kan via WUD geüpdatet worden; risico op breaking changes is laag +    * Iedereen op het werk of bij dezelfde provider heeft read-toegang tot de wiki.
-    * Staat op volume2, dus wordt meegenomen in backups van NVMe +
-  * **Risico’s / aandachtspunten:** +
-    * Read-toegang voor iedereen op het werk/bij dezelfde provider+
  
 ===== Evaluatie ===== ===== Evaluatie =====
 +  * Wanneer heroverwegen:
 +    * Bij de verwachte migratie naar Obsidian.
  
-  * **Ervaring:** nvt 
-  * **Wanneer herbeoordelen:** 
-  * **Aanleiding voor herziening:** 
-    * Als behoefte sterk verandert 
homelab/besluiten/26.001-installatie_dokuwiki_incl_extensies.1792503700.txt.gz · Last modified: by miels