====== 26.001 Installatie DokuWiki incl. extensies ======

  * **Aangemaakt:** 2026-01-04
  * **Context / Aanleiding:**
    * Behoefte aan consistente documentatie van steeds complexer homelab
    * 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}}


 ===== Relaties =====
/* Overzicht van hoe onderstaande kolommen gevuld (moeten) worden:
 x = NVT
 - = Wordt vanzelf gevuld dmv backlinks
 V = Handmatig specificeren!
 * = Hybride, kan gevuld worden met backlinks of harde links (bijv. services onder Portainer)

 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 =====

  * **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 =====

  * **Technisch:**
    * Draait als docker container
    * bereikbaar via reverse proxy, huis, werk of ip van mobiele provider
    * Impact/overwegingen/eigenschappen mbt (netwerk)configuratie, performance, beheer
  * **Operationeel:**
    * Container kan via WUD geüpdatet worden; risico op breaking changes is laag
    * Staat op volume2, dus wordt meegenomen in backups van NVMe
  * **Risico’s / aandachtspunten:**
    * Read-toegang voor iedereen op het werk/bij dezelfde provider

===== Evaluatie =====

  * **Ervaring:** nvt
  * **Wanneer herbeoordelen:**
  * **Aanleiding voor herziening:**
    * Als behoefte sterk verandert