homelab:besluiten:26.001-installatie_dokuwiki_incl_extensies
Differences
This shows you the differences between two versions of the page.
| 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 miels | homelab: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:** | + | |
| - | * Behoefte aan consistente documentatie van steeds complexer | + | * **Betreft**: [[homelab: |
| - | * Snel en eenvoudig nieuwe pagina’s kunnen aanmaken volgens bepaald format | + | |
| - | * Overzicht behouden bij groei van het homelab | + | |
| * **[[resources: | * **[[resources: | ||
| + | * **Thema' | ||
| + | /* 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": | ||
| + | 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' | ||
| + | * 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' |
| - | 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 |
| - | * = Hybride, kan gevuld worden met backlinks of harde links (bijv. services onder Portainer) | + | * Je kan geen links maken naar nog niet bestaande pagina' |
| - | + | * Een pagina met backlinks of een lijst van alle pagina' | |
| - | 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> | + | |
| - | + | ||
| - | Voeg aanvullingen mogen ook toe aan [[i_template|de template]] | + | |
| - | */ | + | |
| - | + | ||
| - | ^ [[homelab: | + | |
| - | | [[..: | + | |
| ===== Besluit ===== | ===== Besluit ===== | ||
| - | + | | |
| - | * **Gekozen optie:** DokuWiki | + | |
| - | + | ||
| - | + | ||
| - | * **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 | + | |
| - | * je kan geen links maken naar nog niet bestaande pagina' | + | |
| - | * pagina | + | |
| - | * Vervolgens DokuWiki geprobeerd. Ondersteunt dat wel. | + | |
| - | + | ||
| - | ==== Plugins ==== | + | |
| - | + | ||
| - | * **TemplatePageName**\\ ondersteunt vaste pagina-opbouw (baseline + optioneel) | + | |
| - | * **CatList**\\ voorkomt handmatig onderhouden van inhoudsopgaves binnen een namespace | + | |
| - | * **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 | + | |
| - | * **Comment**\\ Voeg commentaar toe dat je alleen ziet bij het bewerken van pagina's | + | |
| ===== Gevolgen ===== | ===== Gevolgen ===== | ||
| - | + | | |
| - | | + | * Bereikbaar |
| - | * Draait als docker container | + | * **Operationeel**: |
| - | * bereikbaar | + | * De container wordt via WUD bijgewerkt; het risico op breaking changes is laag. |
| - | * Impact/ | + | * 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 |
| - | * Staat op volume2, dus wordt meegenomen in backups van NVMe | + | |
| - | * **Risico’s / aandachtspunten: | + | |
| - | * Read-toegang voor iedereen | + | |
| ===== Evaluatie ===== | ===== Evaluatie ===== | ||
| + | * Wanneer heroverwegen: | ||
| + | * Bij de verwachte migratie naar Obsidian. | ||
| - | * **Ervaring: | ||
| - | * **Wanneer herbeoordelen: | ||
| - | * **Aanleiding voor herziening: | ||
| - | * Als behoefte sterk verandert | ||
homelab/besluiten/26.001-installatie_dokuwiki_incl_extensies.1792503700.txt.gz · Last modified: by miels
