Benutzer-Werkzeuge

Webseiten-Werkzeuge


dokuwiki

Konfiguration

  • Konfiguration liegt in DokuwikiVerzeichnis/conf
  • Plugins haben eigene Konfiguration DokuwikiVerzeichnis/
Datei Inhalt
dokuwiki.phpHauptkonfigurationsdatei

Eine Menge genereller Einstellungen für Dokuwiki

Ein weiterer Teil genereller Einstellungen findet sich in local.php
local.phpEinstellungen betreffen der lokalen Installation

$conf['openregister'] = 0; → Deaktiviert Selbstregistrierung von Benutzern
acl.auth.phpZugriffsregeln für die einzelnen Artikel - Authorisierung
user.auth.confAnmeldeinformationen - Authentifizierung

Passwörter, Benutzernamen, Gruppenzugehörigkeit
mime.confZuordnung Mime-Types zu Dateiendungen und welche Dateitypen über Medienmanager (im Dokuwiki-Editor) hochgeladen werden dürfen.

Achtung: Das definiert nicht die Dateien die über andere Wege (Fck oder FCKGLite hochgleaden werden können

Plugins

Plugin Beschreibung URL
WRAPKapseln von Doku-Wiki-Syntax + einiges anderes

Ermöglicht es unter anderem Dokuwiki-Syntax einzupacken und somit an Stellen zu verwenden wo sie nicht interpretiert werden würde (Tabellen zum Beispiel).

Ermöglicht u.a.:
  • Aufzählungszeichen in Tabellen
  • Tabellen in Tabellen



Syntax:

<WRAP>
Syntax 1
Syntax 2
<WRAP>


Wichtig: WRAP muss groß geschrieben sein und danach muss ein Zeilenumbruch erfolgen.

Die Syntax innerhalb von WRAP ist die normale Dokuwiki-Syntax

http://www.dokuwiki.org/plugin:wrap
sortablejsErmöglicht das sortieren von Tabellen durch den Benutzer

Vor der entsprechenden Tabelle muss <sortable> angegeben werden bzw. hinter der Tabelle </sortable>. Nur in dem Falle ist das sortieren aktiviert.

Syntax:
<sortable> 
^Spalte ^Spalte2 ^Spalte3
|Wert1|Wert2|Wert3|
</sortable>
http://www.dokuwiki.org/plugin:sortablejs
fckgliteWYSIWIG-Editor

Umsetzung des FCK-Editors in Java-Script

Administrator/Entwickler-Doku: http://docs.cksource.com/FCKeditor_2.x/Developers_Guide
Benutzer-Doku: http://docs.cksource.com/FCKeditor_2.x/Users_Guide


Weiteres siehe Hier
http://www.dokuwiki.org/plugin:fckglite
BureaucracyFormulare - Datenversand per Mail oder Einfügen in neue Seiten

<form>
action pagemod _self 1
select "Lizenz: " "CC BY-ND|CC BY-NC-SA|CC BY-SA|CC BY-NC-ND|Copyright"
select "Bearbeiten: " "erlaubt|verboten"
Submit Absenden
</form>
  • Action definiert die auszuführende Aktion
  • Submit erstellt einen Button der das Formular „absendet“
  • select erstellt eine Auswahl
    • weitere Elemente stehen zur Auswahl



Achtung: Entweder in pagemod oder Bureaucracy ist ein Fehler der es auch unangemeldeten Benutzern ermöglicht das Formular abzusenden.

http://www.dokuwiki.org/plugin:bureaucracy
pagemod Ändern bestehender Seiten über Formulare - Erweitert Bureaucracy

Ermöglicht es mit Hilfe eines Formulars Platzhalter in einer bestehenden Seite zu ersetzen.
Dabei können ganze Textblöcke solange versteckt sein, bis das Formular abgesendet wird.

Weiteres siehe hier

Hinweis: Setzt das Plugin Bureaucracy voraus

Achtung: Entweder in pagemod oder Bureaucracy ist ein Fehler der es auch unangemeldeten Benutzern ermöglicht das Formular abzusenden.
http://www.dokuwiki.org/plugin:pagemod

sidebarngFügt eine Sidebar/Seitenleiste ein

Es wird ein abgetrennter Bereich auf allen Seiten zur Verfügung gestellt → zum Beispiel als Navigationsleiste nutzbar

  • Inhalt kann selbst definiert werden
    • Kann Ausgabe anderer Plugins sein
  • Position (links, rechts, oben, unten) kann definiert werden
  • Wird über Pluginmanager konfiguriert

Als Inhalt der Sidebar wird eine einstellbare Wiki-Seite genutzt.
Entsprechend kann die Seitenleiste beliebigen Inhalt haben, zum Beispiel die Ausgabe von Plugins die einen Navigationsbaum zur Verfügung stellen oder Text

http://www.dokuwiki.org/plugin:sidebarng
addnewpageNeue-Seite-Feld in eine Seite einfügen

Stellt auf einer existierenden Seite ein Feld zur Verfügung über das sich eine neue Seite erstellen lässt


Syntax:
{{NEWPAGE>Namepsace}}
  • >Namespace → der zu nutzende Namensraum (optional)
http://www.dokuwiki.org/plugin:addnewpage
indexmenuSeitenindex mit optionaler Java-Script Baumansicht (Navigationsleiste).

Erstellt für einen oder über alle Namespaces/Namensbereiche einen Seitenindex/Navigationsmenü
Synchronization PluginSynchronisiert zwei Instanzen von Dokuwiki miteinander

Zum Beispiel eine Offline-Installation lokal auf dem Rechner und die Online-Version auf einem Server.
  • Synchroinisation über XMLRPC-Schnittstelle von Dokuwiki
  • Synchronisation beliebig vieler Instanzen
    • es kann gegen mehrere Remote-Instanzen synchrinisiert werden
    • es kann beliebig viele lokale Installationen geben die sich gegen ein Remote-Wiki synchrinisieren
  • Synchronisation in beide Richtungen
    • von Remote nach Lokal
    • von Lokal nach Remote
  • Synchronisiert nur Medien und Seiten
    • nicht die Software an sich/Plugins usw.
  • keine Merging-Funktion wenn Seite auf beiden Installationen geändert wurde
    • muss per Hand gemacht werden
https://www.dokuwiki.org/plugin:sync
Webmaster PluginErlaubt das hinzufügen von Metatags für die Authentifizierung die Yandex, Goggle und Bing für erweiterte Funtionen/Nachweis das man der Betreiber der Seite ist fordernhttps://www.dokuwiki.org/plugin:webmaster
quickstatsPlugin zum erstellen von Zugriffstatistiken - ohne Datenbankhttps://www.dokuwiki.org/plugin:quickstats
tablecalcErmöglicht Berechnungen (angelehnt an Excell-Formeln) in Dokuwiki-Tabellen.

Bugs:

Zugriff auf Zellen die der mit der Formel in der gleichen Zeile folgen

Befindet sich auf einer Zeile in einer Zelle eine Formel und greift diese auf eine Zelle auf der gleichen Zeile zu, welche sich hinter (weiter rechts) jener mit der Formel befindet, so ist das Ergebnis der Formel leer oder Fehlerhaft. Eine Bedingung damit das auftritt ist, dass nach der entsprechenden Zeile in der Tabelle keine weiteren Zeilen folgen die eine Formel enthalten (oder eben diese Zeile die letzte der Tabelle ist).

Das Problem tritt nicht auf, wenn weitere Zeilen mit Formeln folgen oder die Zelle auf den die Formel zugreift vor der Formel (links davon) liegen/liegt.

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

fckglite

Wichtige Einstellungen fckconfig.js:

Einstellung Bedeutung
FCKConfig.CustomConfigurationsPathPfad zu reiner benutzerdefinierten Konfiguration

Benutzerdefinierte Konfiguration überschreibt Optionen in der Hauptkonfigurationsdatei.
Idee ist, dass die Konfigurationsdatei an einem Ort liegt der durch Updates nicht überschrieben wird.

Hinweis: Hat bei mir nicht funktioniert - Datei wurde ignoriert.
FCKConfig.AutoDetectLanguageAutomatische Erkennung der Sprache und Anpassen der Oberfläche

Standardmäßig true.
Sollte abgeschaltet werden wenn nur eine Sprache vorkommt und/oder es Probleme bei der Erkennung gibt
FCKConfig.DefaultLanguage ISO-Sprachkürzel für die Standardmäßig zu verwendende Sprache.

Wird genutzt wenn Sprache nicht erkannt werden kann oder nicht unterstützt wird.

FCKConfig.DefaultLanguage = 'de' ; → Deutsche Sprache als Standard
FCKConfig.EnterModeWas soll passieren wenn Enter gedrückt wird im Editor.

Standardmäßig wird ein Absatz eingefügt/ <p>.

Mögliche Werte:
  • p → Absatz
  • br → Zeilenumbruch (es geht auf der nächsten Zeile weiter)
  • div
FCKConfig.ShiftEnterModeWas passiert wenn Shift+Enter gedrückt wird.

Standardmäßig: Zeilenumbruch (<br>)

Alles weitere siehe EnterMode
FCKConfig.ToolbarSetsDefiniert Toolbars und deren Inhalt
  • Filemanger
    • wird genutzt wenn Links oder Dateien/Bilder ausgewählt werden

Dateien die hochgeladen werden dürfen werden unter: DokuwikiVerzeichnis/lib/plugins/fckg/fckeditor/editor/filemanager/connectors/php/config.php konfiguriert.
Es gibt im Code dort mehrere Arrays, config[ConfigAllowedTypes] definiert generell welche Arten von Medien, in weiteren Arrays (allowed und denyed) steht welche Extensions für die einzelnen Medien zulässig sind bzw. verboten sind

<pagemod 1>
  <WRAP info 80%> **Lizenz- und Bearbeitungshinweise** \\ 
   \\ 
  Dieses Dokument steht unter @@Lizenz: @@ \\ 
  Weitere Informationen und Links auf die Lizentexte können hier abgerufen werden:                         [[:wiki:lizenztexte|Lizenztexte]] \\ 
  \\ 
  Der Autor hat die Bearbeitung für registrierte Wiki-Benutzer @@Bearbeiten: @@. </WRAP>
</pagemod>

pagemod

<form>
  action pagemod _self 1
  select "Lizenz: " "CC BY-ND|CC BY-NC-SA|CC BY-SA|CC BY-NC-ND|Copyright"
  select "Bearbeiten: " "erlaubt|verboten"
  Submit Absenden
</form>
  • Das Formular und der Text mit den Platzhaltern können auf der gleichen Seite sein oder auf verschiedenen

  • Der Bereich Pagemod (zwischen <pagemod id> und </pagemod> definiert den Bereich der eingefügt wird wenn das dazugehörige Formular abgesendet wird
    • im öffnenden pagemod-Tag ist eine ID anzugeben <pagemod ID> - <pagemod 1>
      • diese dient der Ansprache der richtigen Pagemod-Sektion aus dem Formular heraus - es könnte ja mehrere Pagemod-Sektionen auf einer Seite geben
    • Wörter bzw. Wortgruppen die in @@Wortgruppe@@ eingeschossen sind, sind Variablen
      • Die Bezeichner müssen identisch (inkl. Leerzeichen) zu einem im Formular (<form>) sein - dort stehen die Bezeichner unmittelbar hinter dem Typ eines Feldes
        • bei select „Bearbeiten: “ „erlaubt|verboten“ → ist „Bearbeiten: “ gleichzeitig der Text der vor dem Feld angezeigt wird und der Bezeichner für das Feld/die Variable - in pagemod gäbe es dann @@Bearbeiten: @@
    • Pagemod kann normales Wiki-Markup enthalten

  • Der Bereich <form> definiert das Bureaucracy-Formular welches die Eingaben aufnimmt und den pagemod-Bereich in der Zielseite aktiviert und befüllt
    • action definiert was beim Absenden passieren soll
      • pagemod → besagt das pagemod genutzt werden soll
      • _self → Name der Zielseite
        • _self ist ein Sonderkonstrukt und bedetet das die Seite auf der das Formular steht das Ziel ist
      • 1 → Die ID des anzuspringenden Page-Mode-Bereichs (die id ist im öffnenden <pagemod id> zu finden
    • Für den Rest siehe Bureaucracy

Werkzeuge

Was Beschreibung
Index neu erstellenErstellt den Seitenindex neu

lib/exe/indexer.php

Weitere Informationen: http://www.dokuwiki.org/indexer

Formatieren

Steuerzeichen escapen

  • Steuerzeichen der Dokuwiki-Syntax nicht mehr als Steuerzeichen, sondern als normales Zeichen, interpretieren

Syntax:

%%Steuerzeichen%%



Für Code-Blöcke kann man diese auch in: Code-Tags einbetten (<„code>Code<“/code> → die „ dürfen nicht mit geschrieben werden).

Synchronisierung

Synchronization Plugin

  • Saubere und einfache Variante
  • Synchronisiert nur Medien und Seiten

Siehe Plugins

Unison

  • per unison möglich
  • fastcheck abschalten → fastcheck=false
    • bei Updates wird unter Umständen die Modifikation-Time auf ein früheres Datum als „jetzt“ gesetzt
      • das liegt daran, dass tar die Modification Time von den Dateien aus dem enpackten Archiv benutzt
    • unison überprüft bei erlaubtem fastcheck anhand des Modification-Zeitstempels ob eien Datei geändert wurde
    • kann dazu führen das Dateien der nicht upgedateten Version (Remote) Dateien der upgedaten Version überschreiben bzw. zumindest die Dateien der nicht upgedateten Version nicht upgedatet werden
  • nach Updates vorsichtig sein
    • siehe Punkt oben

Suchmaschinen

  • useslash in den Einstellungen aktivieren
    • einige Suchmaschinen indexieren Dokuwiki nicht wenn die URL “?„ enthält → Hinweis auf dynamische Seiten
    • useslash nutzt / statt der typischen PHP-URLs mit ? und =
  • Sitemap erstellen
  • Meist muss Seite authentifiziert werden → u.a. per Tag → siehe Authentifizierung per Tag

Sitemap erstellen

Achtung: Ist die Dokuwiki-Installation unter mehreren URLs/Pfaden erreichbar, wird nur eine der Varianten in die Sitemap geschrieben.
Man sollte beim angeben der URL bei der Suchmaschine die URL angeben die in der Sitemap steht, ansonsten schlucken die Suchmaschinen die Sitemap nicht, da sie meinen das die URLs nicht übereinstimmen.
Will man eine bestimmte URL in der Sitemap haben kann man das über basurl in den Einstellungen machen → Die Einstellung kann Dokuwiki unerreichbar machen. Danach muss die Sitemap neu erstellt werden.

Sitemap regenerieren

  • Löschen von Installationspfad/data/cache/sitemap.xml.gz bzw. sitemap.xml
  • Auf eine beliebige Dokuwiki-Seite zugreifen

Authentifizierung per Tag

Mindestens Bing, Microsoft und Yandex bieten an sich als der Website-Besitzer auszuweisen (wird benötigt um erweiterte Funktionen wie Statistiken, Indexing-Status und Sitemap zu benutzen) in dem man ein Authentifizierungstoken in ein Meta-Tag schreibt.

Externe Informationen

Troubelshooting

Problem Mögliche Lösung
Bilder/Dateien einfügen - FCK-Editor und Dokuwiki-Editor zeigen nicht alle Namespaces/Namensbereiche anDokwuki scheint nur die Namenbsereiche in der Auswahl zu zeigen in der die Seite ist die gerade bearbeitet wird oder wo Bilder liegen

Lösung: Einfac hin die anzuzeigenden Namensbereich ein Default-Bild/Datei legen.
Tablecal zeigt in berechneten Zellen nichts an/in einigen Browsern nichts an
  • Browsercache leeren
  • Formel überprüfen
dokuwiki.txt · Zuletzt geändert: 2015/06/24 18:33 von root