DokuWiki

DokuWiki ist eine Wiki-Software, mit der sich Informationen strukturiert erfassen, miteinander verknüpfen und dauerhaft dokumentieren lassen.

Eine Besonderheit ist, dass die Inhalte nicht zwingend in einer klassischen Datenbank gespeichert werden müssen. Die Wiki-Seiten werden als Textdateien abgelegt.

Dadurch bleiben die eigentlichen Inhalte vergleichsweise einfach zugänglich und können auch unabhängig von der Weboberfläche gesichert werden.

DokuWiki nutze ich als technische Grundlage für meine eigenen Wissens- und Dokumentationssysteme.

Im Mittelpunkt steht das RoWaWiki.

Das RoWaWiki ist meine persönliche und projektübergreifende Wissenssammlung – mein „zweites Gehirn“.

Hier dokumentiere ich insbesondere:

• Wissen, das ich später wiederfinden möchte
• technische Anleitungen
• eigene Arbeitsweisen
• Problemlösungen
• Programme und Werkzeuge
• Entwicklungsumgebungen
• Konfigurationen
• Erfahrungen aus meinen Projekten
• Entscheidungen und Festlegungen

Dabei geht es nicht darum, alles im Kopf zu behalten.

Wichtiger ist, Informationen so zu dokumentieren, dass ich sie später schnell wiederfinden und nachvollziehen kann.

Neben dem RoWaWiki nutze ich DokuWiki auch als technische Grundlage für das TheCruiserWiki (TCW).

Während das RoWaWiki als persönliche und projektübergreifende Wissenssammlung dient, dokumentiert das TheCruiserWiki gezielt die Entwicklung und Struktur von TheCruiserBlog.

Dabei gilt grundsätzlich:

• RoWaWiki → allgemeines und projektübergreifend nutzbares Wissen
• TheCruiserWiki (TCW) → Wissen und Dokumentation speziell zu TheCruiserBlog

Erkenntnisse, die bei der Arbeit am TheCruiserWiki entstehen und auch außerhalb von TheCruiserBlog nützlich sind, gehören deshalb ins RoWaWiki.

So wird Wissen nicht unnötig doppelt gepflegt und bleibt dort dokumentiert, wo es langfristig am sinnvollsten wiedergefunden werden kann.

Das Erscheinungsbild des RoWaWiki wird zusätzlich zum verwendeten DokuWiki-Template durch eigenes CSS angepasst.

Die eigenen Style-Regeln befinden sich in:

E:\xampp\htdocs\rowawiki\conf\userstyle.css

Dort werden unter anderem eigene Darstellungen für folgende Bereiche definiert:

• Seitenköpfe
• Navigation
• Themenbereiche
• Symbole
• Albert-Hinweise
• Zurück-Buttons
• „Nach oben“-Buttons
• weitere RoWaWiki-spezifische Gestaltungselemente

Nach Änderungen an der Datei:

userstyle.css

kann es vorkommen, dass DokuWiki oder der Browser zunächst noch die vorherige CSS-Version verwendet.

Für Änderungen am RoWaWiki hat sich deshalb folgender Ablauf bewährt:

1. userstyle.css bearbeiten und speichern.
2. Im RoWaWiki Administration → Konfiguration öffnen.
3. Ohne weitere Änderung unten auf Speichern klicken.
4. Die betreffende Wiki-Seite wieder öffnen.
5. Im Browser mit Strg + F5 vollständig neu laden.

Dadurch werden die Styles neu eingelesen und der Browser lädt die aktuelle CSS-Version.

Das erneute Speichern der DokuWiki-Konfiguration ist insbesondere nach Änderungen an eigenen Styles hilfreich.

Vorgehensweise:

1. Als Administrator im RoWaWiki anmelden.
2. Admin öffnen.
3. Konfiguration auswählen.
4. An den Einstellungen muss dabei nichts geändert werden.
5. Am Ende der Seite Speichern wählen.
6. Anschließend die gewünschte Wiki-Seite mit Strg + F5 neu laden.

Style ändern → userstyle.css speichern → DokuWiki-Konfiguration speichern → Strg + F5