Dokuwiki als privates Wiki

Vor ein paar Jahren habe ich angefangen allerlei Notizen elektronisch zu sammeln. Dafür habe ich meist selbst entwickelte Programme benutzt, die zwar funktionierten, aber nie so ganz das boten, was ich gerne hätte. Letztlich ertappte ich mich immer wieder dabei, dass ich mehr an den Werkzeugen bastelte, als sie zu benutzen. Nicht so wirklich ideal. Andererseits habe ich im Laufe der Zeit einen interessanten Streifzug durch allerlei Software-Technologien gemacht. Auch nett. Aber irgendwann war Schluß mit lustig und eine dauerhaft benutzbare Lösung musste her: Dokuwiki

Warum Dokuwiki?

Letztlich war die Entscheidung für Dokuwiki völlig subjektiv, aber für mich sprachen ein paar gute Gründe dafür:

  • es ist simpel: keine Datenbank, nur PHP und Textfiles. Mediawiki wirkt dagegen wie ein Sumo-Ringer
  • es hat eine API. Ich mag Sachen mit einer API
  • man kann es gut mit Plugins und Themes an die eigenen Bedürfnisse anpassen
  • und noch ein ganz gewichtiger Grund: ich habe es schon seit ein paar Jahren für einige Dokumentationen im Einsatz

Import

Nachdem die Entscheidung gefallen war, musste als erstes ein größerer Stapel Notizen importiert werden. Das war trivial: pro Eintrag eine Textdatei erzeugen und an die richtige Stelle schieben.

Unter /data/pages sind alle Textdateien versammelt, aus denen das Wiki besteht. Unterverzeichnisse übernehmen darin die Rolle von Namespaces. Wirklich einfach. Allerdings fehlt noch eine Kleinigkeit. Dokuwiki speichert zu jeder Datei Metadaten in Form von serialisierten PHP-Datenstrukturen und erzeugt daneben auch noch Indexdateien. Das passiert beim Speichern aus der GUI heraus automatisch und musste für den Import manuell ausgelöst werden. Freundlicherweise bringt Dokuwiki gleich das passende CLI-Skript mit: bin/indexer.php Sobald das Skript durchgelaufen ist, ist das Wiki betriebsbereit mit allen neuen Inhalten.

Kleine Tweaks

Out-of-the-Box sieht die Editierung in Dokuwiki so aus:

Da ich der einzige Bearbeiter des Wikis bin, möchte ich auf die freundliche Ermahnung nur Verbesserungen beizutragen verzichten. Dadurch gewinne ich wertfollen Platz auf dem Bildschirm, wenn ich unterwegs vom Telefon aus editiere (das kommt häufig vor). Da der geschmeidige Update-Mechanismus von

Die zweite Sache, die ich nicht brauche, ist die kurze Notiz bei Änderungen. Ich benutze sie nie und auch sie kostet wieder Platz

.dokuwiki .editBar .summary {
    display: inline;
    visibility: hidden;
}

Und schon sieht die ganze Seite aufgeräumter aus ….

… vor allem unterwegs auf dem Smartphone.

Mobile Nutzung

Mir persönlich gefällt für die mobile Nutzung das Standardtheme von Dokuwiki am Besten. Es ist vielleicht nicht besonders stylisch, aber sehr praktisch. Um die Nutzung unterwegs noch zu verbessern, läuft auf meinem Smartphone WebApps aus dem FDroid-Store. So lässt sich das Wiki fast wie eine App benutzen (jedenfalls solange man Online ist)


Feedback gerne per eMail an mail@scaldra.net oder per XMPP an scaldra@trashserver.net