User Tools

Site Tools


homelab:besluiten:26.001-installatie-docuwiki-incl-extensies

This is an old revision of the document!


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

Relaties

Besluit

  • Gekozen optie: DokuWiki en extensies (zie 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
homelab/besluiten/26.001-installatie-docuwiki-incl-extensies.1772485011.txt.gz · Last modified: by miels