====== Dokuwiki Installation ======

Die Einrichtung eines Wikis ist eigentlich sehr einfach und besteht aus den
Schritten Paket herunterladen, auspacken und Dateiberechtigungen einstellen.
Anschließend wird das Installationsskript ''install.php'' aufgerufen und 
die notwendigen Einstellungen vorgenommen. Nach einmaliger Ausfühung wird
das Skript dann gelöscht.   

Im Detail:
<code>
cd /var/www
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
tar xzf dokuwiki-stable.tgz
mv dokuwiki-<version> <verzeichnis>
cd <verzeichnis>

chgrp -R www-data conf
chgrp -R www-data lib/plugins

chown -R www-data. data

chmod g+w conf/users.auth.php conf/acl.auth.php conf/plugins.local.php

cd /var/www/<verzeichnis>
http://www.computerclub-pinneberg.de/install.php
rm install.php
</code>

Konfiguration anpassen
  * Datumsformat '' %d.%m.%Y %H:%M''
  * userewrite = .htaccess

Rewrite nutzen um schönere URLs zu erhalten
<code>
cp .htaccess.dist .htaccess
</code>

Plugins installieren
  * Wrap
  * Edittable
  * Folded

Absichern über Verzeichnisberechtigungen siehe nachfolgende Updateanleitung.

===== Update =====

Alte Versionen befinden sich im Archiv: https://download.dokuwiki.org/archive

  - Backup machen als einfache Kopie: \\ <code>cp -a /var/www/dokuwiki/ /var/backups/dokuwiki_$(date -I)
</code> oder besser als Archiv mit einem der nachfolgenden Befehle:<code>
tar -czf /var/backups/dokuwiki_$(date -I).tar.gz --exclude='var/www/dokuwiki/data/cache' -C / var/www/dokuwiki
tar -czf /var/backups/computerclub_$(date -I).tar.gz --exclude='var/www/computerclub/data/cache' -C / var/www/computerclub
</code>
  - Neueste Version herunterladen: http://download.dokuwiki.org/<code>
cd /var/www/dokuwiki
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
</code>
  - Auspacken über die alte Installation \\ <code>
tar xzf dokuwiki-stable.tgz --strip-components=1
rm dokuwiki-stable.tgz</code>
  - Minimal-Berechtigungen einstellen mit Schreibzugriff für die Webserver-Gruppe ''www-data''<code>
chown -R root:www-data /var/www/dokuwiki
chmod -R g+w /var/www/dokuwiki/data
</code>
  - Konfiguration absichern<code>
chmod 750 /var/www/dokuwiki/conf
chmod g-w /var/www/dokuwiki/conf/*
chmod o-rx /var/www/dokuwiki/conf/*
</code>
  - Berechtigungen für Plugins und Templates einstellen, sofern sie über die GUI geändert werden sollen<code>
chmod -R g+w /var/www/dokuwiki/lib/plugins
chmod -R g+w /var/www/dokuwiki/lib/tpl
</code>
  - Konfiguration über die GUI schreibbar machen<code>
cd /var/www/dokuwiki
chmod 770 conf
chmod 660 conf/local.php
chmod 660 conf/plugins.local.php
chmod 660 conf/users.auth.php
</code>
  - Nicht mehr benötigte Dateien löschen. Diese sind in ''data/deleted.files'' aufgelistet<code>
grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf
</code>
  - Alle Plugins überprüfen und ggf. auf den aktuellen Stand bringen

===== Plugins =====

Plugins können deaktiviert werden.
Die Einstellungen dazu finden sich in ''conf/plugins.local.php''.
Z.B.:
<file conf plugins.local.php>
$plugins['authad']    = 0;
$plugins['authldap']  = 0;
$plugins['authmysql'] = 0;
$plugins['authpgsql'] = 0;
</file>

===== Revision löschen =====

  * Historie anzeigen und Revisionsnummer merken
  * Datei aus dem Attic löschen
  * Changelog in den Metadaten anpassen: Zeile mit Revision löschen
  * ggf. Seitencache löschen: Setie mit ''?purge=true'' aufrufen