Benutzer-Werkzeuge

Webseiten-Werkzeuge


tachtler:dokuwiki

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

tachtler:dokuwiki [2011/01/25 16:52] (aktuell)
Zeile 1: Zeile 1:
 +====== DokuWiki ======
 +
 +[[http://​www.splitbrain.org/​projects/​dokuwiki|{{:​tachtler:​index:​dokuwiki-48x48.png }}]] [[http://​www.splitbrain.org/​projects 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 =====
 +Die aktuelle Version kann unter
 +  * [[http://​www.splitbrain.org/​projects/​dokuwiki|splitbrain.org]]
 +heruntergeladen werden kann.
 +
 +===== Installation =====
 +Zur Installation eines [[wiki:​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 [[wiki:​dokuwiki]]s ebenfalls installiert werden:
 +  * Webserver: z.B. Apache (httpd) grundsätzlich erhältlich unter [[http://​httpd.apache.org/​|apache.org]]
 +  * PHP ab Version 4.3.3 und Komponenten grundsätzlich erhältlich unter [[http://​www.php.net/​|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.
 +<​code>​
 +# tar -xzvf dokuwiki-JJJJ-MM-TT<​evtl. Version>​.tgz -C /​var/​www/​html/​dokuwiki
 +</​code>​
 +
 +Dieses Verzeichnis wird dann mit folgendem Befehl z.B. in ''​dokuwiki''​ umbenannt:
 +<​code>​
 +# mv /​var/​www/​html/​dokuwiki-JJJJ-MM-TT<​evtl. Version>​.tgz /​var/​www/​html/​dokuwiki
 +</​code>​
 +
 +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 [[http://​httpd.apache.org/​|Apache HTTP Webserver]]) gesetzt.
 +<​code>​
 +# chown -R apache:​apache /​var/​www/​html/​dokuwiki
 +</​code>​
 +
 +Damit ist die Installation abgeschlossen.
 +
 +===== Update =====
 +Bei einem Update auf eine neuere Version sind nachfolgende Schritte durchzuführen:​
 +
 +1. Herunterladen der aktuelle Version von [[http://​www.splitbrain.org/​projects/​dokuwiki|splitbrain.org]] in das Verzeichnis ''/​tmp''​.
 +
 +2. Entpacken der aktuellen Version ebenfalls in das Verzeichnis ''/​tmp''​ mit nachfolgendem Befehl:
 +<​code>​
 +# tar -xzvf /​tmp/​dokuwiki-JJJJ-MM-TT<​evtl. Version>​.tgz -C /tmp
 +</​code>​
 +3. Synchronisieren der vorhandenen mit der aktuellen Version mit nachfolgendem Befehl:
 +<​code>​
 +# rsync -av /​tmp/​dokuwiki-JJJJ-MM-TT/​ /​var/​www/​html/​dokuwiki/​
 +</​code>​
 +:!: **WICHTIG** - **Bitte die jeweils abschließenden Schrägstriche ''/''​ berücksichtigen!**
 +
 +4. Erneutes Anpassen der Eigentümer bzw. Gruppenrechte mit nachfolgendem Befehl:
 +<​code>​
 +# chown -R apache:​apache /​var/​www/​html/​dokuwiki
 +</​code>​
 +5. Löschen der Update-Meldung im Verzecihnis ''/​var/​www/​html/​dokuwiki/​data/​cache/''​ mit nachfolgendem Befehl:
 +<​code>​
 +# rm /​var/​www/​html/​dokuwiki/​data/​cache/​messages.txt
 +</​code>​
 +
 +===== 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 [[http://​httpd.apache.org/​|Apache HTTP Webserver]]) auch gestartet ist. Mit folgendem Befehl kann festgestellt,​ ob der Webserver gestartet ist:
 +<​code>​
 +# /​sbin/​service httpd status
 +</​code>​
 +
 +Die Ausgabe sollte in etwa wie folgt aussehen:
 +<​code>​
 +httpd (pid 2214 2213 2212 2211 2210 2209 2208 2207 2176) is running...
 +</​code>​
 +
 +Falls dies nicht der Fall sein sollte, kann der [[http://​httpd.apache.org/​|Apache HTTP Webserver]] mit folgendem Befehl gestartet werden:
 +<​code>​
 +# /​sbin/​service httpd start
 +Starting httpd: ​                                           [  OK  ]
 +</​code>​
 +
 +Der Aufruf des PHP-Skripts zur Konfiguration sollte dann mit der Eingabe in der Adressleiste des Browser mit
 +  * http://​localhost/​dukuwiki/​install.php
 +erfolgen.
 +
 +Nach Eingabe der relevanten Daten in die Eingabemaske und die Speicherung der Daten, sollte dann das (noch leere) [[wiki:​dokuwiki]] im Browserfenster erscheinen.
 +
 +Falls dies nicht der Fall sein sollte, ist der folgende Pfad, der Link zur Startseite des [[wiki:​dokuwiki]]
 +  * http://​localhost/​dokuwiki/​doku.php
 +
 +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 [[wiki:​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/​plugins''​ zu kopieren - **oder**
 +  * es mit einer Anmeldung als Administrator zu //​deployen//​ (Installation über die Web-Oberfläche des [[wiki:​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:
 +  * [[http://​sds.ensi-bourges.fr/​howto/​doku.php?​id=wiki:​logstats|http://​sds.ensi-bourges.fr/​howto/​doku.php?​id=wiki:​logstats]]
 +  * [[http://​sds.ensi-bourges.fr/​howto/​doku.php?​id=wiki:​statdisplay|http://​sds.ensi-bourges.fr/​howto/​doku.php?​id=wiki:​statdisplay]]
 +
 +Das Plugin **''​logstats''​** erstellt eine Log-Datei, welche als Inhalt eine Log der Zugriffe auf die einzelnen Seiten des [[wiki:​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 [[wiki:​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**):​
 +
 +{{:​tachtler:​dokuwiki_admin_plugins_verwalten.png|DokuWiki | Admin | Plugins verwalten}}
 +
 +Die Konfiguration beider Plugins kann bequem innerhalb der regulären Konfiguration des [[wiki:​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 --> [[http://​sds.ensi-bourges.fr/​howto/​doku.php?​id=wiki:​logstats|Plugin logatstats]]
 +  * **''​statdisplay''​** - Link extern --> [[http://​sds.ensi-bourges.fr/​howto/​doku.php?​id=wiki:​statdisplay|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:
 +
 +<​code>​
 +====== 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}} ​             |
 +</​code>​
  
tachtler/dokuwiki.txt · Zuletzt geändert: 2011/01/25 16:52 (Externe Bearbeitung)