(Eigene) Hilfe zu DokuWiki

1. neueste Version von Dokuwiki-Homepage herunterladen (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.
    • 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.

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: Die Abschnittsüberschrift muss klein geschrieben werden!

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”.