====== DokuWiki ======

===== Installation unter XAMPP =====
==== Vorarbeiten ====
    * Download unter [[https://download.dokuwiki.org/]]
    * Auswählen von de- Deutsch(Sie), de-informal, Upgrade Plugin, Wrap Plugin, Video-Share-Plugin, Galery Plugin,
    * im htdocs-Ordner speichern und entpacken.
  * Übersicht über die wichtigsten Ordner  
    * in /data/media liegen die Bilder
    * in /data/pages liegen die Seiten als Textdateien
    * Die Daten können einfach gesichert werden, wenn man den Ordner /data kopiert
    * in /lib/plugins liegen die Plugins
      * jedes Plugin hat ein eigenes Verzeichnis, wo sämtliche php-Dateien liegen für die verschiedenen Plugins.
    * in /lib/scripts liegen verschiedenen JavaScripts, wie zum Beispiel jquery
    * in /lib/styles liegen css-Dateien
    * in /lib/tpl liegen verschiedene Templates.
      * Mit verschiedenen Oberflächen sind auch verschiedene Funktionalitäten festgelegt.
    * in /inc/parser liegen z.B. parser.php, wo die Eingaben interpretiert werden.
  * Man kann in der dokuwiki immer zu älteren Versionen zurück gehen.

==== Durchführen der Installation ====
  * Xampp starten und im Browser folgende Seite aufrufen
  * localhost/.../dokuwiki/install.php aufrufen
    * Wiki-Name, Benutzername, etc. eingeben.
    * Anfangseinstellungen der Zugangskontrolle (ACL)
      * Offenes Wiki - alle können alles machen
      * Öffentliches Wiki - lesen für alle
      * Geschlossenes Wiki - nur wenn man sich anmeldet
    * Lizenzinformationen (nicht anzeigen)
    * speichern
  * install.php sollte man löschen!

===== Installation unter Ubuntu =====
==== Vorarbeiten ====
    * putty.exe und WinSCP downloaden und installieren.
    * Download der Dokuwiki unter [[https://download.dokuwiki.org/]]
    * Auswählen von de- Deutsch(Sie), de-informal, Upgrade Plugin, Wrap Plugin, Video-Share-Plugin, Galery Plugin,
    * tar-Datei mittels WinSCP auf den Webserver spielen
    * Auf einer Shell einloggen und entpacken mittels:
      * tar -xf dokuwiki...tar
    * Rechte des entpackten Ordners ändern auf www-data:www-data mittels:
      * chown www-data:www-data dokuwiki -R
    * Wenn unter Ubuntu die Fehlermeldung kommt, muss es nachinstalliert werden
      * PHP function xml_parser_create is not available.
      * sudo apt-get install php-xml
      * Apache neu starten mit: sudo /etc/init.d/apache2 restart


==== Durchführen der Installation ====
  * Browser folgende Seite aufrufen
  * http://web.bgamstetten.ac.at/.../dokuwiki/install.php aufrufen
    * Wiki-Name, Benutzername, etc. eingeben.
    * Anfangseinstellungen der Zugangskontrolle (ACL)
      * Offenes Wiki - alle können alles machen
      * Öffentliches Wiki - lesen für alle
      * Geschlossenes Wiki - nur wenn man sich anmeldet
    * Lizenzinformationen (nicht anzeigen)
    * speichern
  * install.php sollte man löschen!

=== Absicherung der Dokuwiki ===
  * Das Datenverzeichnis sollte nicht vom Web aus erreichbar sein. Falls die Datei
  * http://web.bgamstetten.ac.at/.../data/pages/wiki/dokuwiki.txt aufrufbar ist, sollte man dies ändern.
  * Nähere Hinweise unter: https://www.dokuwiki.org/security#web_access_security

===== Arbeiten mit der DokuWiki =====
  * [[:wiki:normalmodus|Arbeiten im Normalmodus]]
  * index.php ruft die Datei doku.php auf, mit welcher dann die weiteren Dateien aufgerufen werden.
  * Seitlich Seiten anlegen, ältere Versionen ansehen, Links auf die Seite überprüfen
  * Benutzerprofil oben
  * Sichern der kompletten DokuWiki und z.B. unter xampp starten
    * tar -cf ...

==== Administration (Zahnrad) ====
  * Zugriff auf Benutzerverwaltung, Zugangsverwaltung, Erweiterungen etc.

=== Nette Templates ===
    * monobook
    * Bootstrap3
    * AdoraDark (einfacher Dunkelmodus)
  * Ändern der Sprache
  * Wiki aktualisieren

=== Plugins ===
  * Bootstrap Wrapper Plugin (in Zusammenhang mit Template Bootstrap3)
  * CkGEdit ... Wysiwyg-Editor
  * MathJax ... Tex- und vereinfachter TeX-Formelsatz
  * ImgPaste ... Bilder per Copy&Paste
  * Dateien per Copy&Paste
  * dw2pdf/Book ... Exportieren von Seiten
  * Insert (Seite, Abschnitte innerhalb anderer Seiten anzeigen)
  * Diverse Plugins für Images und Videos (Gallery, Imagebox, Video-sharing)

=== Benutzerverwaltung ===
== Massenimport ==
Um mehrere Benutzer gleichzeitig zu importieren, wird eine CSV-Datei mit den folgenden vier Spalten benötigt (In dieser Reihenfolge): Benutzer-ID, Voller Name, E-Mail-Adresse und Gruppen. Die CSV-Felder sind Kommata-separiert (,) und mit Anführungszeichen eingefasst ("). Mit Backslashes (\) können Sonderzeichen maskiert werden. Ein Beispiel für eine gültige Datei kann mit der Benutzer-Export-Funktion oben generiert werden. Doppelte Benutzer-IDs werden ignoriert.

Für jeden importierten Benutzer wird ein Passwort generiert und dem Benutzer per Mail zugestellt.

===Rechtevergabe===
===Pluginverwaltung===

==== Seiten anlegen ====
  * neue Seiten werden normalerweise über Verlinkungen angelegt.
  * Interne Links mittels Button oder eckigen Klammern, z.B. ''%%[[:inf:start|Informatik]]%%''
    * Es werden ein Unterverzeichnis ''inf'' und dort eine Datei ''start'' angelegt.
    * Die Seite ''start'' kann auch belegt werden.

==== Medien-Manager ====
  * Es können Bilder gesucht werden, ...

==== Syntax ====
  * Übersicht - wiki - Syntax



----
Links:
  * [[https://download.dokuwiki.org/]]
  * [[https://www.dokuwiki.org/DokuWiki|DokuWiki-Home]]
  * [[wpde>DokuWiki]]
  * [[http://www.ct.de/1405138|ct' Übersichtsarktikel zu Wikis]]