Problem
Wie dokumentiert man mit geringem Aufwand verschiedenste
Informationen? Natürlich in einem Wiki. Dies sollte aber möglichst
einfach zu warten sein und ohne großen Aufwand auf jeder Plattform
laufen.
Idee
Man sucht sich ein bewährtes Wiki-System, hier DokuWiki, arbeitet
sich ein und ist hoffentlich lange zufrieden.
Vor vielen Jahren habe ich mich für Dokuwiki entschieden und würde es einen Erfolg
nennen.
Vorteile von Dokuwiki:
- Es arbeitet ohne Datenbank mit reinen Textdateien, die mit jedem
Editor lesbar bleiben (Flat-File-CMS).
- Man editiert seine Texte mit einer vereinfachten Syntax und
akzeptiert diese Beschränkungen :-)
- Für ein Backup sichert man den Dateibaum und stellt ihn genauso
wieder her.
- Neu für mich: pandoc kann Dokuwiki-Dateien direkt in Markdown
übersetzen. Dokuwiki ist also keine Einbahnstraße.
Nachteile von Dokuwiki:
- Eingeschränkte Formatierungsmöglichkeiten
- Heutzutage ist Markdown als Markup-Sprache mehr in Mode
- Wie alle vergleichbaren Systeme arbeitet es mit Software, die aus
dem Internet erreichbar ist: Daher werden regelmäßig PHP-Versionen
angehoben und die CMS selbst aktualisiert. Man kommt also nicht darum
herum, regelmäßig nach den Versionsständen zu sehen. Hier reicht
wenigstens halbjährlich.
Realisierung
Installation
- Lesestoff: https://www.dokuwiki.org/de:install
- Lade das dokuwiki von der Homepage und entpacke es.
- Lege es auf einem Webspace mit PHP ab - z.B. im Unterverzeichnis
dokuwiki.
- Starte /dokuwiki/install.php und konfiguriere:
Konfiguration
- Wähle einen einfaches, vollständiges Template (hier:
sprintdoc).
- Plugins, die ich verwende:
- Das Update-Plugin!
- Wenn man gerne mit Tabellen arbeitet empfehle ich noch das
edittable plugin.
- Die Tags verwalten die Plugins Tag, Pagelist und Cloud (alle von
einem Autorenteam)
- Aktiviere das Update-Plugin.
Wartung
- Meldet man sich mit Administratorrechten an, so bekommt man
gelegentlich die Info, dass es eine neuere Version gibt:
- Aktualisiere zuerst das Update-Plugin
- Starte dann in diesem Plugin die Aktualisierung von Dokuwiki
- Datensicherung: Sichere das gesamte Dokuwiki-Verzeichnis.
- Gelegentlich checken, welche PHP-Version der Hoster
verwendet/anbietet und das mit den unterstützen Versionen von Dokuwiki
abstimmen.
Test
Mit dem Browser aufrufen & arbeiten.
Alternativen
Die Schülerzeitung der Schule, an der ich arbeite, wird mit Typemill betrieben - Texte werden in
Markdown verfasst.
Außerdem gibt es sehr viele Wikis oder einfache
ContentManagementSysteme, die Andere ausführlicher verglichen haben. Ich
war lange zufrieden, steige aber derzeit auf einen
markdown/pandoc-Ansatz im Eigenbau um. Dort werden nur statische Dateien
veröffentlicht. Das kann ich aber nicht jedem empfehlen. Ein fertiges
und insbesondere bewährtes Wiki ist einfacher in Betrieb zu nehmen!
Google-Suche
nach Flat File CMS mit Markdown