Inhaltsverzeichnis
DokuWiki
DokuWiki ist ein einfach zu benutzendes Wiki darauf abgestimmt, als Dokumentationswerkzeug schnell und effektiv einsetzbar zu sein. Basierend auf einfachen Text-Dateien, wird keine aufwendige Datenbank benötigt. Der Syntax ist einfach gehalten aber sehr mächtig was sicherstellt, das die Text-Dateien lesbar und editierbar bleiben, auch außerhalb des Wiki's.
Herunterladen
Installation
Zur Installation eines dokuwiki wird folgendes TAR-Archiv benötigt
- dokuwiki-JJJJ-MM-TT<evtl. Version>.tgz
Folgende Abhängigkeiten bestehen zum TAR-Archiv und müssen zum Betrieb des dokuwikis ebenfalls installiert werden:
- Webserver: z.B. Apache (httpd) grundsätzlich erhältlich unter apache.org
- PHP ab Version 4.3.3 und Komponenten grundsätzlich erhältlich unter php.net
- php
- php-cli
- php-common
Insgesammt sollten dann folgende Pakete installiert sein:
httpd(z.B. httpd.i386)php(z.B. php.i386)php-cli(z.B. php-cli.i386)php-common(z.B. php-common.i386)
Anschließend wird das obengenannte TAR-Archiv z.B. nach
/var/www/html
mit dem folgendem Befehl entpackt.
# tar -xzvf dokuwiki-JJJJ-MM-TT<evtl. Version>.tgz -C /var/www/html/dokuwiki
Dieses Verzeichnis wird dann mit folgendem Befehl z.B. in dokuwiki umbenannt:
# mv /var/www/html/dokuwiki-JJJJ-MM-TT<evtl. Version>.tgz /var/www/html/dokuwiki
Zum Abschluß der Installation wird noch der entsprechende Eigentümer für das neu entstandene Verzeichnis mit nachfolgendem Befehl auf die Rechte des Benutzers und der Gruppe des Webservers (hier das Beispiel für einen Apache HTTP Webserver) gesetzt.
# chown -R apache:apache /var/www/html/dokuwiki
Damit ist die Installation abgeschlossen.
Update
Bei einem Update auf eine neuere Version sind nachfolgende Schritte durchzuführen:
1. Herunterladen der aktuelle Version von splitbrain.org in das Verzeichnis /tmp.
2. Entpacken der aktuellen Version ebenfalls in das Verzeichnis /tmp mit nachfolgendem Befehl:
# tar -xzvf /tmp/dokuwiki-JJJJ-MM-TT<evtl. Version>.tgz -C /tmp
3. Synchronisieren der vorhandenen mit der aktuellen Version mit nachfolgendem Befehl:
# rsync -av /tmp/dokuwiki-JJJJ-MM-TT/ /var/www/html/dokuwiki/
WICHTIG - Bitte die jeweils abschließenden Schrägstriche / berücksichtigen!
4. Erneutes Anpassen der Eigentümer bzw. Gruppenrechte mit nachfolgendem Befehl:
# chown -R apache:apache /var/www/html/dokuwiki
5. Löschen der Update-Meldung im Verzecihnis /var/www/html/dokuwiki/data/cache/ mit nachfolgendem Befehl:
# rm /var/www/html/dokuwiki/data/cache/messages.txt
Konfiguration
Die Grund-Konfiguration empfiehlt sich durch ein im Paket enthaltenes PHP-Skript durchführen zu lassen.
Das PHP-Skript befindet sich im Verzeichnis /var/www/html/dokuwiki und hat den Namen install.php.
Der Aufruf erfolgt im Browser.
Deshalb ist es erforderlich, dass der Webserver (in diesem Fall der Apache HTTP Webserver) auch gestartet ist. Mit folgendem Befehl kann festgestellt, ob der Webserver gestartet ist:
# /sbin/service httpd status
Die Ausgabe sollte in etwa wie folgt aussehen:
httpd (pid 2214 2213 2212 2211 2210 2209 2208 2207 2176) is running...
Falls dies nicht der Fall sein sollte, kann der Apache HTTP Webserver mit folgendem Befehl gestartet werden:
# /sbin/service httpd start Starting httpd: [ OK ]
Der Aufruf des PHP-Skripts zur Konfiguration sollte dann mit der Eingabe in der Adressleiste des Browser mit
erfolgen.
Nach Eingabe der relevanten Daten in die Eingabemaske und die Speicherung der Daten, sollte dann das (noch leere) dokuwiki im Browserfenster erscheinen.
Falls dies nicht der Fall sein sollte, ist der folgende Pfad, der Link zur Startseite des dokuwiki
Durch das PHP-Skript werden folgende Dateien im Verzeichnis /var/www/html/dokuwiki/conf erstellt
local.php(Hauptkonfigurationsdatei)acl.auth.php(Zugriffskontrollliste)users.auth.php(Benutzerdatei)
Die Konfiguration kann am komfortabelsten über die Weboberfläche des dokuwiki erfolgen. Dazu müssen Sie allerdings als Super-Benutzer (Administrator) angemeldet sein. Sie gelangen dann über die Schaltfläche „Admin“ an den Administrationsbereich.
Plugins installieren
Die Installation eines oder mehrerer Plugins kann auf verschiedenen Wegen durchgeführt werden. Die Möglichkeiten sind
- das heruntergeladene Plugin zu entpacken und nach
/var/www/html/dokuwiki/lib/pluginszu kopieren - oder - es mit einer Anmeldung als Administrator zu deployen (Installation über die Web-Oberfläche des dokuwiki.
Die zweite Möglichkeit setzte voraus, das die URL zum herunterladen des Plugins bekannt ist.
Zur Demonstration sollen hier folgende Plugins heruntergeladen, installiert und konfiguriert werden:
Das Plugin logstats erstellt eine Log-Datei, welche als Inhalt eine Log der Zugriffe auf die einzelnen Seiten des dokuwiki's darstellt.
Das Plugin statdisplay erstellt basierend auf dem Plugin logstats eine grafische Auswertung der durch logstats gewonnen Daten.
Zur Installation des Plugins ist die Anmeldung als Administrator des dokuwiki's notwendig!
Anschließend muss in den Administrationsbereich über die Schaltfläche Admin am unteren rechten Bildschirmrand in die Administration und dort zu Plugins verwalten gewechselt werden (siehe nachstehende Bildschirmkopie, nur relevanter Ausschnitt):
Die Konfiguration beider Plugins kann bequem innerhalb der regulären Konfiguration des dokuwiki's erfolgen, welche über die Schaltfläche Admin am unteren rechten Bildschirmrand in die Administration führt um dort den Punkt Konfiguration auswählen. Am Ende ist die Konfiguration aller installierten Plugins zu sehen.
WICHTIG - Ein Konfiguration ist grundsätzlich nicht notwendig, jedoch können wie nachfolgend aufgelistet folgende Anpassungen der Plugins durchgeführt werden:
logstats- Link extern –> Plugin logatstatsstatdisplay- Link extern –> Plugin statdisplay
Beispielkonfiguration statdisplay
Hier als Beispiel eine Mögliche Konfiguration von statdisplay. Es wurde eine eigener geschützter Bereich innerhalb des [wiki:dokuwiki]]'s angelegt und dort werden die Informationen nur angemeldeten und legitimierten Benutzern angezeigt:
====== DokuWiki-Statistik ======
Fortschrittsanzeige der Log-Datei-Auswertung:
{{statdisplay>progress bar}}\\
----
\\
===== Summary by Month =====
^ Statistic ^ Graphic ^
| {{statdisplay>all}} | {{statdisplay>all?graph}} |
===== Monthly Statistic (current month) =====
^ One Month ^ Month by day ^ Month by hour ^
| {{statdisplay>one month}} | {{statdisplay>month by day}} | {{statdisplay>month by hour}} |
===== Top Statistic (current month) =====
^ Top Referers ^ Top Entry Pages ^
| {{statdisplay>top referers}} | {{statdisplay>top entries}} |
^ Top URLs ^ Top Bytes ^
| {{statdisplay>top urls}} | {{statdisplay>top bytes}} |
===== User Agents =====
^ Statistic ^
| {{statdisplay>user agents}} |