(Eigene) Hilfe zu DokuWiki

1. neueste Version von Dokuwiki-Homepage herunterladen (https://download.dokuwiki.org/) (früher: http://www.splitbrain.org/projects/dokuwiki)
2. Dateien entpacken.
3. ganz wichtig: in allen Ordnern sämtliche Sprach-Unterordner (mit den darin enthaltenen Dateien) löschen, bis auf „de“ und „en“! Wenn nicht gelöscht wird, dauert das Hochladen unendlich lang. Nur „de“ und „en“ werden benötigt.
4. Auf FTP-Server leeren Ordner für neues Wiki anlegen
5. Dateien hochladen. Achtung: Zum Hochladen ausschließlich FileZilla verwenden, da SpeedCommander oder TotalCommander irgendwelche Bytes nicht richtig setzen!
6. Mit Filezilla die Dateiattribute des Ordners ändern: Numerischen Wert auf 705 setzen und Checkmarke bei Unterordner einbeziehen
7. Über Browser die Datei „install.php“ aufrufen; Syntax: <server>/<Ordner, in dem Wiki liegt>/install.php,
   • also z.B. www.wgv-projects.de/wiki_lerncenter/install.php
8. Falls Fehlermeldung wegen falscher php-Version kommt: per FTP in das Root-Verzeichnis der Homepage (z.B. www.wgv-projekte.de) gehen und dort die Datei „.htaccess“ bearbeiten (wenn sie noch nicht vorhanden ist, einfach mit einem ASCII-Editor erzeugen). Sie muss für php5 die Zeile enthalten:
   • AddHandler php5-cgi .php
9. Felder ausfüllen und Wiki starten. Die Datei install.php kann und sollte gleich gelöscht werden; eine evtl. nötige Umstellung auf eine andere Sprache kann später in den Konfigurationseinstellungen des laufenden Wikis vorgenommen werden.
10. Nur falls Monobook-Template (sieht aus wie Wikipedia) zum Einsatz kommt: Installation von Monobook im Verzeichnis: /lib/tpl/ (einfach komplettes Monobook-Verzeichnis dorthin kopieren; Achtung: vorher Sprachdateien entfernen bis auf de und en)
    • eigenes Logo: »If you want to replace the default logo showed in the upper left, simply create a /monobook/user/logo.[png|gif|jpg]. The template recognizes the file automatically and will use it instead of the default logo.«
11. Konfiguration:
    • Sprache umstellen: in „Grundkonfiguration“ auf „de“ stellen
    • nur für Monobook: ebenfalls in „Grundkonfiguration“: Design-Vorlage (Template) auf „monobook“ einstellen
    • bei „Erweiterte Konfiguration“ die Update-Checkmarke („Automatisch auf Updates und Sicherheitswarnungen prüfen? DokuWiki muss sich dafür mit splitbrain.org verbinden.“)(in englisch: Advanced Settings „Check for updates and security warnings? DokuWiki needs to contact splitbrain.org for this feature.“) wegnehmen, damit es nicht ständig Hinweise auf neue Versionen gibt. Aber beachten: Wenn man zu selten oder gar nicht updated, kann es sein, dass das Wiki irgendwann nicht mehr läuft und die Meldung erscheint: „Diese Seite funktioniert nicht. [Servername] kann diese Anfrage momentan nicht verarbeiten. HTTP Error 500“. Das bedeutet, dass das Wiki mit der PHP-Version des Servers nicht mehr klarkommt. Dann muss Dokuwiki neu installiert werden und es ist viel Nacharbeit nötig (siehe unten). Also: entweder die Update-Checkmarke weglassen und selber dran denken, ab und zu aus dem Wiki heraus ein Update vorzunehmen, oder die Checkmarke belassen und mit den Versionsmeldungen leben, aber hin und wieder ein Update vornehmen.
    • nur für ältere Wikis: das Plugin „Displaywikipage“ muss in den Plugin-Ordner (/lib/plugins/) geladen werden, sonst können keine neue Seiten angelegt werden (insbesondere kann die Navigationsseite sonst nicht „bestückt“ werden)
    • für die optische Gestaltung von Texten ist das „highlight“-Plugin noch hilfreich (ebenfalls einfach in den Plugin-Ordner kopieren)

In den neueren Dokuwiki-Versionen (ab 2012) ist standardmäßig vorgesehen, dass mit einer Sidebar gearbeitet wird (früher war das der Navigationsbereich).

Aber Achtung:

Falls man bei der Ersteinrichtung vergessen hat, sie zu erzeugen, baut sich die Sidebar nicht einfach von allein auf (im Unterschied zum Inhaltsverzeichnis einer Seite)! Das heißt, sie existiert erst einmal nicht. Am einfachsten ist es, noch einmal zur „Welcome to your new DokuWiki“-Seite (im Namensraum „wiki“ zu gehen) und dort den Link „sidebar“ zu betätigen. Man landet auf einer noch leeren Seite, die per „Bearbeiten“ mit Text gefüllt werden kann.

Anderer Weg: Da in der Konfiguration des Standard-Templates bereits eingetragen ist, dass die Sidebar sichtbar wird, sobald eine Seite mit dem Namen „sidebar“ existiert, kann diese Seite jederzeit wie jede andere Seite manuell erzeugt werden. Dazu einfach auf irgendeine andere vorhandene Seite gehen und einen internen Link „Sidebar“ anlegen (der Link ist ein reiner Hilfslink und kann später von dieser Seite gelöscht werden). Auf Link klicken, dann Überschrift „Sidebar“ eingeben und abspeichern. Die Sidebar sollte gleich auf der linken Seite erscheinen.

Falls die Sidebar nicht erscheint, kann es daran liegen, dass der Cache eine falsche Version der Seite aufruft. Dann am besten sämtliche Cache-Inhalte (im data-Ordner) manuell löschen. Danach sollte die Anzeige der Sidebar funktionieren.

Ein Update kann sofort vorgenommen werden, wenn man die Nachricht erhält, dass eine neue Dokuwiki-Version existiert. Diese schnelle Reaktion hat mehrere Vorteile:

• Man kann auf das aktuelle Wiki noch normal zugreifen und somit alles kontrollieren.
• Das Wiki läuft unter einer kompatiblen PHP-Version.
• Wurde PHP auf dem Server upgedatet und hat man Dokuwiki nicht ständig aktualisiert, kann es passieren, dass sich das vorhandene Wiki nicht mehr aufrufen lässt (siehe oben).

Die Aktualisierung von Dokuwiki für ein vorhandenes Wiki läuft wie folgt ab:

1. Zum FTP-Server, auf dem das Wiki liegt, gehen und die Ordner/Verzeichnisse conf und data des vorhandenen Wikis sichern. Im conf-Ordner sind die Benutzereinstellungen enthalten, im data-Ordner die Seiten und Bilder. Alle anderen Ordner (einschl. des lib-Ordners, der die Plugins enthält) sind unwichtig und können jederzeit wieder mit den benötigten Inhalten bestückt werden. Achtung: vor dem Sichern den Ordner cache (zweiter Unterordner im data-Verzeichnis) komplett manuell entleeren (der Ordner selbst sollte erhalten bleiben). Der Unterordner attic enthält ältere Versionen der Seiten; er sollte zumindest entfrachtet werden, also sollten z. B. alle Versionen, die älter als drei Monate sind, gelöscht werden (wie weit man zurückgeht, hängt davon ab, wie oft man Überarbeitungen vorgenommen hat und als wie wichtig man ältere Versionen einschätzt). Die Wiki-Sicherung auf dem lokalen Rechner enthält somit die entschlackten Verzeichnisse conf und data.
2. Die neueste Version von Dokuwiki von https://download.dokuwiki.org/ herunterladen und entpacken.
3. Auf dem FTP-Server den gesamten Wiki-Ordner manuell entleeren (alle Verzeichnisse und Dateien markieren, dann Entf-Taste), den Wiki-Ordner selbst aber existieren lassen. Den Namen des Ordners kopieren und auf der lokalen Festplatte z. B. in eine Notepad-Datei einfügen; in diese Datei können später noch andere wichtige Daten, die bei der Installation benötigt werden, eingefügt werden. Auf sie kann dann bei der Installation auf einfache Weise zugegriffen werden.
4. Die neue Dokuwiki-Version wie oben beschrieben installieren.
5. Am besten direkt nach der Installation, also direkt nach dem Löschen der install.php-Datei und vor dem ersten Aufrufen des Wikis im Browser, aus dem gesicherten data-Ordner alle Pages- und Media-Ordner (die Ordner entsprechen den Namensräumen des Wikis) mit ihren Inhalten in das Wiki auf dem FTP-Server hochladen. Dabei werden die vorhandenen Pages- und Media-Ordner (die ja noch leer sind) überschrieben. Wenn man jetzt das Wiki aufruft, sollte alles genauso aussehen wie gewohnt (es sei denn, es fehlen noch Templates und Plugins, die das Aussehen beeinflussen).
6. Benötigte/gewünschte Templates und Plugins installieren.
7. Was die Konfigurationseinstellungen angeht, die im gesicherten conf-Ordner enthalten sind, können die wichtigen Dateien einfach hochgeladen werden. Achtung: Man sollte sich vorher alle Benutzer- und Zugangseinstellungen inkl. der Passwörter notiert haben.
8. Das sollte es gewesen sein.

Das Gute bei dem Verfahren ist, dass sich auf diese Weise auch ältere Wikis, die vielleicht schon Jahre nicht mehr benutzt wurden, updaten und wieder zum Laufen bringen lassen. Wichtig sind in erster Linie nur die Pages- und Media-Verzeichnisse.

Wenn im Bearbeiten-Modus die Toolbar nicht angezeigt wird,so kann das ein Java-Problem sein. Näheres: http://www.dokuwiki.org/faq:toolbar

Die Startseite befindet sich im Root des Wikis, daher muss der Doppelpunkt am Anfang des Namens geschrieben werden, also:

Syntax: [[:start|Start]]\\

Beispiel:

• Link zum Wiki „WGV-Haupt-Wiki“

Syntax: [[http://www.wgv-projects.de/wgv-intrawiki/doku.php|WGV-Haupt-Wiki]]\\

funktionierender Link: WGV-Haupt-Wiki

Hier muss also nach dem Verzeichnisnamen nur das doku.php aufgerufen werden.

Beispiel:

• Link zum Wiki „Indexing“
• dort zum Namensraum „embedded“
• dort zur Seite „word“

Syntax: [[http://www.wgv-projects.de/wgv-intrawiki_indexing/doku.php?id=embedded:word|Indexing]]

funktionierender Link: Indexing

Hier ist wichtig, nach Verzeichnisnamen und doku.php noch die id der Seite anzugeben.

Syntax der id: ?id=<namensraum:><seitenname>

Dazu einfach hinter dem Seitennamen einen Gartenzaun (engl. „hash character“) eingeben, danach die Abschnittsüberschrift.

Syntax: [[<namensraum>:<seite>#<abschnittsüberschrift>|<Bezeichung des Links (z.B. wieder die Abschnittsüberschrift>]]

Wichtig:

1. Abschnittsüberschrift klein schreiben
2. Blanks ersetzen, und zwar durch _

Beispiel: [[:hilfe:eigenes#text,_der_nicht_geparst_werden_soll|"Text, der nicht geparst werden soll"]] ergibt die Verlinkung zum Abschnitt "Text, der nicht geparst werden soll".

Dateien werden am besten mit dem Werkzeug „Hochladen“ hochgeladen (in alten Wikis: links im Menü zu finden, in neuen Wikis: Schaltfläche „Medien-Manager“ rechts oben). Dabei kann angegeben werden, in welchem Namensraum (letztlich in welchem Verzeichnis/Unterverzeichnis) die Datei landen soll.
Wichtig:

• in Dateinamen dürfen nicht enthalten sein:
  • Großbuchstaben
  • Umlaute
  • Blanks
  • Sonderzeichen wie ß
• anstelle von Blanks am besten das Underscore-Zeichen _ verwenden
• auch einige Dateinamenerweiterungen werden nicht akzeptiert, so z.B. die Endung .dot. Falls es Probleme mit der Endung gibt, am besten die Datei mit dem SpeedCommander oder winZip in ein ZIP-Archiv packen. Die Endung .zip wird immer akzeptiert.
• Im Link zu einer Datei immer die komplette Struktur der Namensräume und -unterräume mit angeben, also z.B.

Musterlösungen

• Den Link muss man sich nicht merken, sondern kann ihn kopieren. Dazu das Tool „Hochladen“ (oder die Schaltfläche „Medien-Manager“) wählen, links den Namensraum, in dem sich die zu verlinkende Datei befindet, anklicken; daraufhin werden rechts alle zu diesem Namensraum gehörenden Dateien aufgelistet. Die gewünschte Datei einmal anklicken, dann klappt eine neue Zeile auf, in der die Syntax zum Verwenden der Datei genannnt wird: Syntax markieren und kopieren.
  

siehe auch nachfolgenden Punkt „Hochladen“

• Im Hochladen-Tool (bzw. im Medien-Manager) links einen Namensraum anklicken; in diesen Namensraum wird die Datei geladen.
• DokuWiki (zumindest bei neueren Versionen) wandelt falsche Dateinamen automatisch um (d.h. ändert Umlaute, Groß-Klein-Schreibung usw.)
• Bei „Datei auswählen“ die hochzuladende Datei suchen
• Dann einfach auf „Hochladen“ klicken.
• Nachdem die Datei hochgeladen ist, gibt das Programm eine Erfolgsmeldung aus und zeigt u.a. einen den Text des Links zur hochgeladenen Datei. Diesen Text einfach kopieren, zu der Seite wechseln, auf der das Bild eingebaut werden soll, und hier Link im Bearbeiten-Modus einfügen.
• Beachten: Tatsächlich angezeigt werden nur Bildformate wie tiff oder jpg; bei PDFs oder gar Word-Dateien ist nur der Link zu sehen; Dokuwiki hat von Hause aus keinen PDF- oder Word-Betrachter eingebaut.
• Bildgröße einstellen: direkt hinter Dateinamen ein Fragezeichen gefolgt von einem Zoom-Faktor eingeben, also z. B. {{:office:standard_schnellzugriffs_symbolleiste_klein.jpg?800|Bild 1}} für einen Zoom-Faktor von 800 Prozent. Welcher Wert der optimale ist, muss ausprobiert werden

• am einfachsten mit dem <nowiki>-Tag arbeiten, End-Tag: </nowiki>
• Bsp.: http://www.splitbrain.org/projects/dokuwiki (geparst); http://www.splitbrain.org/projects/dokuwiki (nicht geparst)

Die Dokuwiki-Logo-Datei befindet sich unter

• /data/media/wiki/¹⁾

Es braucht einfach nur gegen das gewünschte Logo ausgetauscht zu werden; dabei wichtig: das neue Logo muss den Dateinamen „logo.png“ haben.

Falls das Monobook-Template installiert ist, befindet sich die Dokuwiki-Logo-Datei außerdem unter

• /lib/tpl/monobook/user/²⁾
  • Dann hat es keinen Sinn, die Bilddatei unter /data/media/wiki/ zu ersetzen, weil auf die nicht zugegriffen wird; In „main.php“ von Monobook wird auf die Stelle verwiesen, wo sich das Logo im Monobook-Verzeichnis befindet (siehe vorstehend). D.h.,

1. die Bilddatei logo.png muss (per FTP-Programm; am besten FileZilla) entfernt und die gewünschte Logo-Datei muss an ihre Stelle gebracht werden
2. die Datei main.php von Monobook muss bearbeitet werden: per FTP-Programm herunterladen, dann im Editor von SpeedCommander (oder einem anderen Editor) öffnen und nach dem String „logo.png“ suchen. Es gibt zwei Zeilen, die bearbeitet werden müssen:
   • <?php if (file_exists(dirname(FILE).'/user/bep_online_klein.png')) { ?>
   • style=„background-image: url(<?php echo $DOKU_TPL?>user/bep_online_klein.png);“

(hier stand vorher jeweils: logo.png)

Die so geänderte Datei wieder hochladen.

• Zugangsverwaltung aufrufen
• bei „Gruppe“ im Feld daneben den Namen der neuen Gruppe eingeben
• „Auswählen“ wählen
• nun existiert die neue Gruppe
• im nächsten Schritt können die Rechte an die neue Gruppe vergeben werden

Wenn man ein Plugin herunterlädt, steckt es üblicherweise in einem Order mit einem längeren Namen als demjenigen, der erlaubt ist.

Das heißt, bevor man das Plugin in den Plugin-Ordner des Wikis schiebt, muss der Ordnername geändert werden.

Bsp.: „edittable-master“ ist der Ordnername des edittable-Plugins, er muss geändert werden in „edittable“.

https://www.dokuwiki.org/plugin:discussion

https://www.dokuwiki.org/plugin:comments

https://www.dokuwiki.org/plugin:menu

https://www.dokuwiki.org/plugin:edittable

https://www.dokuwiki.org/plugin:subjectindex