====== Für Administratoren ======
//Der folgende Text richtet sich fachlich und auch sprachlich an Administratoren, also Personen, die sich aufgrund ihrer technischen Ausbildung und Praxis mit der Materie gut auskennen.//
===== Dokuwiki updaten =====
Ein Update geht durch einfaches Überschreiben sämtlicher zum Download gehörenden Dateien, ohne dass Kundendaten oder Konfigurationen zerstört werden. Neue Version herunterladen, entpacken und zum Hosting-Provider hochladen. Siehe auch Plugin //Upgrade//. Über das //DokuWiki Upgrade Plugin// vom Entwickler selbst Andreas Gohr geschieht der Update/upgrade-Vorgang noch einfacher und lässt sich als Wiki-Administrator über das normale Web-Interface anstoßen.
===== Cache löschen =====
Um den DokuWiki-internen Cache zu löschen wird die Datei //conf/local.php// einmal bearbeitet und wieder gespeichert werden (touch), [[https://www.dokuwiki.org/caching | mehr...]], siehe auch [[https://www.dokuwiki.org/plugin:cleanup | cleanup Plugin]].
===== Backup =====
Ein Backup des gesamten Wikis mitsamt dem DokuWiki-Framework, aber auch aller Seiten geht (dank der beim DokuWiki nicht vorhandene Datenbank) sehr einfach, schnell und sicher. Der Website-Administrator verbindet sich mithilfe des Windows-Programms [[https://winscp.net | WinSCP]] und Eingabe der SFTP-Login-Daten (Servername, Login, Passwort) mit dem Server des Webhosters und sieht in der Zwei-Fenster-Ansicht von WinSCP links die Ordner-Ansicht des //lokalen PC//, im rechten Fenster die //Remote-Ansicht beim Webhoster//. Durch einfaches Drag-And-Drop auf Ordnerebene lässt sich das gesamte Web (entspr. Ordner unterhalb von /www/public_html) an den gewünschten Platz auf den lokalen Rechner kopieren. Je nach Umfang des Webs und Geschwindigkeit der Internetverbindung kann es bedingt durch die sehr vielen einzelnen Dateien/Abbildungen dieses Wikis (mehr als 100.000) durchaus bis zu 30 Minuten oder länger dauern. Sinnvollerweise wird anschließend die heruntergeladene Ordnerstruktur zu einem ZIP- oder RAR-Archiv gepackt und mit dem Tagesdatum im Dateinamen versehen (z. B. gt-backup_2018-12-06.zip) und archiviert. Die hier beschriebenen Programme und Rechner beschreiben eine Windows-Umgebung; jedoch sind auch entsprechende Programme für die Mac- oder Linux-Welt verfügbar.
===== Automatische Auflösung von gängigen Abkürzungen durch Volltext =====
Dokuwiki kann zu Abkürzungen, z.B. OSM, welches in Texten geschrieben ist, beim Überfahren mit der Maus den Langtext anzeigen. Dokuwiki bringt bereits eine sehr große Anzahl Abkürzungen (Acronyme) mit, leider vielfach aus dem englischen Sprachraum, bietet jedoch die Möglichkeit, eigene Listen zu erzeugen. Auf dem Server beim ISP kann neben der vorhandenen Datei /public_html/name_des_webs/conf/acronyms.conf ein neue, kundenspezifische Datei acronyms.local.conf angelegt werden und wie folgt mit den Abkürzungen und Langtext notiert werden.
# neue Abkürzungen
ISP Internet Service Provider
OSM Open Street Map
PLZ Postleitzahl
===== Plugins installieren =====
Plugins können nur vom Westfalenhöfe-Administrator installiert werden. Als Admin einloggen, Admin-Seite aufrufen, Plugins verwalten, nach dem gewünschten Plugin suchen, Abhängigkeiten prüfen und installieren, ausloggen.
===== Installierte Plugins =====
==== Cleanup ====
Das Plugin [[https://www.dokuwiki.org/plugin:cleanup | Cleanup]] löscht veraltete und verwaiste Dateien und Cache-Daten.
* Download und Install des Plugins über die Admin-GUI.
* Die Konfiguration, welche Dateien als veraltet betrachtet werden, ist unter Admin -> Konfiguration -> Plugin -> Cleanup einstellbar: Tabelle mit Sekundenangabe, z.B. 60*60*24*30*3 = 3 Monate.
* Der Reinigungs-Prozess kann automatisch erfolgen (auf Wunsch selektierbar)
* Manuelles Anstoßen des Cleanup: Admin-Seite -> Zusätzliiche Plugins -> File Cleanup: Vorschau der betroffenen Dateien, am Listenende Button zum Löschen.
* Cleanup-Wirkung: (vorher/nachher) als Beispiel von westfalen.westfalenhoefe.de am 2019-06-04:
* 4774/3975 files,
* 214/214 folders,
* 131/99 MB
==== Upgrade ====
Das Plugin [[https://www.dokuwiki.org/plugin:upgrade | Upgrade]] aktualisiert das DokuWiki-Framework und installiert Hotfixes.
* Download und Install über die Admin-GUI
* Manuelles Anstoßen des Upgrade: Admin-Seite -> Zusätzliiche Plugins -> Wiki aktualisieren: zuerst prüfen, dann fortsetzen...
* ACHTUNG: Es besteht der Verdacht, dass bei Upgrade-Vorgang das geänderte (individuelle) Logo (logo.png) mit dem Standard-DoKuwiki-Logo überschrieben wird.
==== Comment ====
Das Plugin [[https://www.dokuwiki.org/plugin:comment|Comment]] erlaubt Kommentare im Quelltext, die der Besucher nicht sieht. Es werden die in den Programmiersprachen üblichen Zeichen /* am Anfang und */ als Ende genutzt. Es sind auch mehrzeilige Kommentare möglich.
* Download und Install über die Admin-GUI, Name: //Comment//
===== Logo und Favicon ändern =====
Das Logo (links oben) ist eine 64 x 64 Pixel große PNG-Datei (optimal mit transparentem Hintergrund) mit dem Namen logo.png. Dokuwiki bringt mit der Installation ein eines mit, das jedoch an den neuen Verwendungszweck angepasst werden sollte, indem eine neue Grafikdatei erstellt und unter folgendem Pfad gespeichert werden muss:
/data/media/wiki/logo.png
Dies kann vom Administratur entweder direkt im Dateisystem auf dem Server des Providers oder per Medien-Manager des Dokuwikis erfolgen. In diesem Zusammenhang sollte ebenfalls ein Favicon bereitgestellt werden, welches in Browsertabs und in den Bookmarks angezeigt wird, der Pfad dafür lautet:
/data/media/wiki/favicon.ico
Siehe auch diese Anleitung bei [[https://www.dokuwiki.org/template:dokuwiki#changing_the_logo | DokuWiki]].
... wird fortfesetzt.