====== DokuWiki ====== ...die Grundlage dieses Wikis. ===== Links ===== * [[http://wiki.splitbrain.org/wiki:dokuwiki|Homepage]] * [[https://www.ickewiki.de/free.html|ickewiki]] dokuwiki-Distribution vom Hersteller Cosmocode * [[http://forum.dokuwiki.org/forum|Dokuwiki-Userforum]] * [[http://www.testticker.de/ipro/praxis/netzwerke/article20060601066.aspx|Know-how: Dokuwiki einrichten]] * [[http://www.linux.com/articles/57410|Beefing up DokuWiki with plugins]] * [[http://toolserver.org/~diberri/cgi-bin/html2wiki/|HTML -> Wiki Converter]] realisiert mit [[http://search.cpan.org/~diberri/HTML-WikiConverter-0.51/bin/html2wiki|html2wiki]] * [[https://www.cosmocode.de/de/blog/detman/2016-12/05-die-10-besten-plugins-fur-dokuwiki|Die 10 besten Plugins für DokuWiki]] ==== Plugins ==== WYSIWYG: * **[[https://www.dokuwiki.org/plugin:prosemirror|Prosemirror Plugin]] (experimenteller WYSIWYG-Editor) ([[https://github.com/cosmocode/dokuwiki-plugin-prosemirror|github]]) testen: [[https://wysiwyg.wiki.cosmocode.de/doku.php?id=:en:start|playground]]** * https://www.dokuwiki.org/plugin:ckgedit andere: * **[[https://www.dokuwiki.org/plugins|Plugins]]** * [[https://www.dokuwiki.org/plugin:box|Box plugin]] * Formulare [[https://www.dokuwiki.org/plugin:bureaucracy|bureaucracy]] mit plugin [[https://www.dokuwiki.org/plugin:captcha|CAPTCHA]] === Export === * [[https://www.dokuwiki.org/plugin:dw2markdown|markdown]] mit ?do=export_dw2markdown * [[https://www.dokuwiki.org/plugin:dw2pdf|DW2PDF Plugin]] ?do=export_pdf ggf. in Kombination mit [[https://www.dokuwiki.org/plugin:pdftools|pdftools Plugin]] ===== Vorteile ===== * schnelle Installation * leichtes Backup & Restore (Packen+Entpacken) * genaue Rechteverwaltung nach Namensräumen und Seiten sowie Benutzer und Gruppen * automatisches Speichern von Entwürfen * automatische Druckansicht beim Drucken ===== Installation ===== [[http://wiki.splitbrain.org/wiki%3Arequirements|Systemanforderungen]] Siehe auch [[shellscripts:dokuwiki-install]] und einen [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/tutorials/installer|php-Installer]] Ab der neuesten Version ist allerdings bereits ein Installer enthalten. * [[http://wiki.splitbrain.org/wiki:screencast:install|Video-Anleitung]] * [[http://tdoks.blogspot.com/2007/04/setting-up-dokuwiki-on-iis-with.html|Setting up dokuwiki on IIS with integrated authentication]] ===== Konfiguration ===== * [[http://wiki.splitbrain.org/wiki:rewrite|URL Rewriting für menschenlesbarere URLs]] :!: man sollte sich fühzeitig für Optionen wie * URL rewriting * Umschreibung der Akzente * Trennzeichen (das voreingestellt _ eignet sich für [[suchmaschinen:Suchmaschinen]] schlecht) * ausblenden der Namensräume in der Übersicht für der Benutzer keine Rechte hat entscheiden. So muss man später nicht aufwändig Seiten verlegen. ===== DokuWiki intern ===== Die Buttons ganz unten (RSS-Link, CC-Lizensierung, ...) lassen sich in der Datei dokuwiki/lib/tpl/default/footer.html anpassen. Statt ''default'' muss u.U. der Namen des verwendeten Templates genommen werden. ==== Vorlagen (Templates) ==== Für Dokuwiki gibt es [[http://wiki.splitbrain.org/wiki%3Atpl%3Atemplates|Templates von anderen Benutzern]]. Diese kann man auch noch zusätzlich anpassen, z. B. bei der Farbgebung. Dafür sind Kenntnisse von [[webdesign:CSS]] und [[programmiersprachen:PHP]] hilfreich. Weitere Informationen [[wikis:dokuwiki:vorlagen|auf der Unterseite zu Vorlagen]]. ==== Cache ==== Dokuwiki macht den Cache neu wenn sich der Zeitstempel einer Konfigurationsdatei ändert. auf Linux ganz einfach mit touch /conf/local.php danach das Browserfenster neu laden (mit Umschalttaste gedrückt). ==== Hooks wie footer und header ==== Um nicht direkt im template Änderungen vornehmen zu müssen (die bei updates weg sind) gibt es definierte [[https://www.dokuwiki.org/template:dokuwiki#supported_include_hooks|Include Hooks]]. ==== Accesskeys in Firefox ==== Die Tastenkombinationen bzw. Accesskeys funktionieren im Firefox nicht mit zusätzlich gedrückter SHIFT-Taste. Wenn man das Verhalten von Firefox 1.x wiederhaben möchte muss man in der Adresszeile about:config eingeben und den Eintrag ''ui.key.contentAccess'' auf den Wert 4 setzen (siehe [[http://www.firefox-browser.de/wiki/FAQ:Was_ist_beim_Update_auf_Firefox_2.0_zu_beachten%3F#Das_Verwenden_von_Tastenkombinationen_mit_der_.22Alt.22-Taste_funktioniert_nicht_mehr|Das Verwenden von Tastenkombinationen mit der "Alt"-Taste funktioniert nicht mehr]]). ==== Google-Sitemap ==== [[http://wiki.splitbrain.org/wiki:sitemap|Google Sitemap]] Die Sitemap wird als Datei ''/data/cache/sitemap.xml.gz'' erstellt man kann vom Basisverzeichnis einen symbolischen Link setzen: ln -s ./data/cache/sitemap.xml.gz ==== wanted Features ==== * einen WYSIWYG-Editor mit copy&paste von Bildern * interne Links anders darstellen (Symbol) * optionale MySQL-Grundlage: die Suche würde nicht mehr vom Cache abhängen, besseres Backup da man ACID implementieren könnte (Nachteil: komplexer, schwerer zu installieren * SEO-Hilfen (meta-equiv description, keywords) und DokuWiki-Rewrite-Konfiguration ==== Programmierung ==== [[http://dev.splitbrain.org/reference/dokuwiki/nav.html?inc/template.php.source.html|PHP Cross Reference of DokuWiki]] [[http://dev.splitbrain.org/browse/darcs/dokuwiki| dev.splitbrain.org /darcs/dokuwiki ]] ==== Updates / Bugs ==== http://wiki.splitbrain.org/wiki:changes http://dev.splitbrain.org/darcs/index.cgi/dokuwiki/?c=patches [[http://bugs.splitbrain.org/?do=details&id=179|Safe-Mode und Cache-dir]] sozusagen der Klassiker. Problem Safe-mode erfordert dass der [[server:Webserver]] auch der Besitzer von den cache-Dateien ist oder (bei laxerer Einstellung) der Gruppe angehört. Entweder man schaltet in der php.ini den Safemode auf Off oder nur auf GID oder (wenn man das nicht kann, Webhoster, oder will) ändert man den Cache-Ordner + unterhalb vorhandene Dateien auf 777 oder 770 (Rechte unter *nix werden mit chmod geändert). ===== Handbuch ===== [[DokuWiki:Handbuch]] ==== Backup ==== - einfach das ganze Verzeichnis packen und wo anders entpacken (Rechte beachten) - alternativ kann man auch nur das data-Verzeichnis - oder das Verzeichnis **pages** (mit allen Wiki-Seiten und Unterordnern, die die Namensbereiche darstellen), die **changes.log** sowie das **media**-Verzeichnis. Die dritte Möglichkeit nimmt am wenigsten Platz ein, da der Cache nicht mitkopiert wird. Außerdem ist es bei Upgrades besser falls sich der Aufbau des Caches o.ä. ändert. ==== Neue Seite anlegen ==== - einen Link in einer vorhandenen Seite einfügen - speichern - auf den noch roten Link klicken (siehe unten) - auf Seite anlegen gehen - Inhalte einfügen -> Fertig ==== Zeilenumbrüche ==== Ein Absatz (2x Eingabetaste) lässt eine Zeile frei einen einfachen Zeilenumbruch macht man mit \\(LEERZEICHEN) ===== Sicherheitsaspekte ===== * Man sollte den Server so absichern, dass nicht die Seiten (als txt-Datei) direkt gelesen werden können! Dazu legt man eine Datei mit dem Namen .htaccess ([[apache:htaccess|Zugriffsschutz]]) mit dem folgenden Inhalt an: order allow,deny deny from all Diese Datei sollte schon bei der Installation angelegt worden sein, aber Kontrolle kann nicht schaden. * Das offenbart aber auch ein Problem der Textdatei-speicherung: Wenn jemand eine bösartige Anwendung auf dem [[server:Webserver]] installiert, kann er auf die Dateien zugreifen (da für ihn der Verzeichnisschutz nicht greift und er auf Dateiebene die Dateien als Benutzer des [[server:Webserver|Webservers]] ausliest). ==== Versionsmeldung abschalten ==== Wenn man in den Headern die Ausgabe der exakten Versionsnummer verhindern will, muss man die Datei VERSION im Hauptordner von Dokuwiki anpassen. Die enthaltene Zeichenkette wird als Releasenummer angezeigt. ===== Anti-spam-features ===== [[http://wiki.splitbrain.org/wiki:discussion:spam|Anti-Spam Techniques]] [[http://wiki.splitbrain.org/wiki:blacklist|Blacklisting]] in der conf-Datei wird festgelegt, wann frühestens Seiten (nach Änderungen) von Suchenmaschinen-spidern erfasst werden ("delayindex", Standard sind 5 Tage!).