Tills Blog

Notizen eines rastlosen Geistes

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
blog:2020:05:10_bloggen_mit_dokuwiki [2020/05/11 09:43] tillblog:2020:05:10_bloggen_mit_dokuwiki [2020/09/10 21:32] (aktuell) – [Konfiguration des include-Plugins] till
Zeile 1: Zeile 1:
 ====== Bloggen mit Dokuwiki ====== ====== Bloggen mit Dokuwiki ======
  
-Einen Blog mit [[https://www.dokuwiki.org/|Dokuwiki]] zu erzeugen, ist gar nicht schwer, wenn man ein bisschen Ahnung von Dokuwiki hat und der [[https://www.dokuwiki.org/tips:blogging|Anleitung für's Bloggen]] folgt. Allerdings kommt es häufig auf die Kleinigkeiten an, weshalb hier für diesen Blog in etwas mehr Detail und im Einzelnen beschrieben und begründet werden soll, welche Plugins und Einstellungen verwendet werden. Alle Informationen sind ohne Garantie und unter der Maßgabe "funktioniert für mich", aber vielleicht ist ja doch das eine oder andere hilfreiche dabei.+Einen Blog mit [[doku>|Dokuwiki]] zu erzeugen, ist gar nicht schwer, wenn man ein bisschen Ahnung von Dokuwiki hat und der [[doku>tips:blogging|Anleitung für's Bloggen]] folgt. Allerdings kommt es häufig auf die Kleinigkeiten an, weshalb hier für diesen Blog in etwas mehr Detail und im Einzelnen beschrieben und begründet werden soll, welche Plugins und Einstellungen verwendet werden. Alle Informationen sind ohne Garantie und unter der Maßgabe "funktioniert für mich", aber vielleicht ist ja doch das eine oder andere hilfreiche dabei.
  
  
 ===== Plugins: Voraussetzungen für einen Blog ===== ===== Plugins: Voraussetzungen für einen Blog =====
  
-Wie in der "offiziellen" [[https://www.dokuwiki.org/tips:blogging|Anleitung für's Bloggen]] angegeben, gibt es drei Plugins, ohne die Bloggen mit Dokuwiki nicht richtig funktioniert:+Wie in der "offiziellen" [[doku>tips:blogging|Anleitung für's Bloggen]] angegeben, gibt es drei Plugins, ohne die Bloggen mit Dokuwiki nicht richtig funktioniert:
  
-  * [[https://www.dokuwiki.org/plugin:blog|Blog-Plugin]] +  * [[doku>plugin:blog|Blog-Plugin]] 
-  * [[https://www.dokuwiki.org/plugin:include|include-Plugin]] +  * [[doku>plugin:include|include-Plugin]] 
-  * [[https://www.dokuwiki.org/plugin:pagelist|Pagelist-Plugin]]+  * [[doku>plugin:pagelist|Pagelist-Plugin]]
  
 Hinweis: Die Schreibweise der Plugin-Namen orientiert sich daran, wie sie unter " Erweiterungen verwalten" im Administrationsbereich des Dokuwiki angezeigt werden. Hinweis: Die Schreibweise der Plugin-Namen orientiert sich daran, wie sie unter " Erweiterungen verwalten" im Administrationsbereich des Dokuwiki angezeigt werden.
Zeile 19: Zeile 19:
 Außer den oben genannten drei Plugins gibt es noch eine Reihe weiterer Dokuwiki-Plugins, die gerade für einen Blog mit seinen eigenen Anforderungen hilfreich und sinnvoll sein können: Außer den oben genannten drei Plugins gibt es noch eine Reihe weiterer Dokuwiki-Plugins, die gerade für einen Blog mit seinen eigenen Anforderungen hilfreich und sinnvoll sein können:
  
-  * [[https://www.dokuwiki.org/plugin:bloglinks|Bloglinks-Plugin]] +  * [[doku>plugin:bloglinks|Bloglinks-Plugin]] 
-  * [[https://www.dokuwiki.org/plugin:tag|Tag-Plugin]]+  * [[doku>plugin:tag|Tag-Plugin]]
  
 Darüber hinaus gibt es natürlich eine Reihe grundsätzlich hilfreicher Plugins für jedes Dokuwiki, und hier ist es dann endgültig eine Frage persönlicher Präferenzen, welche man wählt. Für diesen Blog werden zumindest folgende zusätzliche Plugins verwendet: Darüber hinaus gibt es natürlich eine Reihe grundsätzlich hilfreicher Plugins für jedes Dokuwiki, und hier ist es dann endgültig eine Frage persönlicher Präferenzen, welche man wählt. Für diesen Blog werden zumindest folgende zusätzliche Plugins verwendet:
  
-  * [[https://www.dokuwiki.org/plugin:wrap|Wrap-Plugin]] +  * [[doku>plugin:cookielaw|cookielaw-Plugin]]
-  * [[https://www.dokuwiki.org/plugin:blogquote|Blockquote-Plugin]] +
-  * [[https://www.dokuwiki.org/plugin:caption|caption-Plugin]] +
-  * [[https://www.dokuwiki.org/plugin:fontface|FontFace-Plugin]] +
-  * [[https://www.dokuwiki.org/plugin:gallery|Gallery-Plugin]]+
  
-  * [[https://www.dokuwiki.org/plugin:cookielaw|cookielaw-Plugin]] +  * [[doku>plugin:wrap|Wrap-Plugin]] 
-  * [[https://www.dokuwiki.org/plugin:meta|Meta-Plugin]] +  * [[doku>plugin:blogquote|Blockquote-Plugin]] 
-  * [[https://www.dokuwiki.org/plugin:move|Move-Plugin]]+  * [[doku>plugin:caption|caption-Plugin]] 
 +  * [[doku>plugin:fontface|FontFace-Plugin]] 
 +  * [[doku>plugin:gallery|Gallery-Plugin]] 
 + 
 +  * [[doku>plugin:meta|Meta-Plugin]] 
 +  * [[doku>plugin:move|Move-Plugin]] 
 + 
 +Die genannten Plugins lassen sich in drei Kategorien einteilen: 
 + 
 +  * Plugins mit Relevanz zum Datenschutz 
 +  * Plugins für Syntax und Aussehen 
 +  * Plugins für die Kontrolle über Interna und Organisation des Wikis 
 + 
 +Das [[doku>plugin:cookielaw|cookielaw-Plugin]] ist ein Versuch, der DSGVO gerecht zu werden, zumal es momentan nicht möglich ist, das [[doku>|Dokuwiki]] davon abzuhalten, immer Cookies zu setzen. 
 + 
 +Wegen des Datenschutzes sollte das [[doku>plugin:fontface|FontFace-Plugin]] immer mit Schriften verwendet werden, die lokal im Plugin-Verzeichnis liegen, nicht mit Google-Fonts. Anderenfalls wird jede Nutzung der Seite direkt an Google weitergegeben. Eine sehr ergiebige Seite für frei verfügbare Fonts ist [[https://www.fontsquirrel.com/|FontSquirrel]]. 
 + 
 +Das [[doku>plugin:meta|Meta-Plugin]] erlaubt die nachträgliche bequeme Veränderung von Metadaten (für einen Blog relevant: Erstellungsdatum), ohne in den JSON-Dateien von Dokuwiki per Hand Unix-Zeitstempel editieren zu müssen. Das [[doku>plugin:move|Move-Plugin]] schließlich, wenn auch als experimentell markiert, scheint extrem hilfreich dabei zu sein, Dateien und ganze Namensräume per drag&drop zu verschieben. Ideal also für all jene, die keinen direkten Zugang zum Dateisystem ihres Webservers haben, aber Einträge etc. lieber durch ACLs geschützt in einem privaten Bereich vorformulieren und anschließend verschieben wollen.
  
  
 ===== Grundlegende Einstellungen ===== ===== Grundlegende Einstellungen =====
  
-  * offenes oder geschlossenes Wiki +Neben der Konfiguration der betreffenden Minimalausstattung an für einen Blog relevanten Plugins ist eine noch weitreichendere Entscheidung zu treffen: jene nach dem Zugang zum Wiki. 
-  * Konfiguration der drei grundlegenden Plugins+ 
 + 
 +==== Zugangsbeschränkungen ==== 
 + 
 +Die erste Frage, die man sich stellen sollte: **offenes oder geschlossenes Wiki?** Das ist allein schon deshalb entscheidend, weil es viel einfacher ist, ein ursprünglich offenes später in ein geschlossenes Wiki zu verwandeln als umgekehrt. "Offen" bedeutet dabei, dass jede Person ohne vorherige Anmeldung bei Kenntnis der URL Zugriff auf das Wiki hat, während "geschlossen" impliziert, dass Besucher sich zunächst anmelden müssen. 
 + 
 +Soll ein Blog potentiell eine gewisse Reichweite über einen engen Personenkreis hinaus haben, kommt nur die offene Variante in Betracht, das bedeutet aber gleichzeitig, dass man tunlichst auf Fragen des Urheberrechts und Datenschutzes achten sollte. Darunter fallen insbesondere Dinge wie keine Bilder einzustellen, auf denen Personen einwandfrei identifizierbar sind, und keine urheberrechtlich geschützten (oder nicht zweifelsfrei verwendbaren) Materialien zu veröffentlichen. 
 + 
 + 
 +==== Konfiguration des Blog-Plugins ==== 
 + 
 +Die Position des Formulars für einen neuen Eintrag (im Wesentlichen: oben über oder unten unter den Einträgen) ist eine Frage des persönlichen Geschmacks. 
 + 
 +Wichtiger ist die Einstellung, die dafür sorgt, dass den Seiten das Datum vorangestellt wird (''plugin»blog»dateprefix''). In einem durchschnittlich mehrfach pro Monat mit neuen Einträgen versehenen Blog mit relativ vielen Medieninhalten (i.d.R. Bilder) wird man eine monatsweise Sortierung in Verzeichnisse bevorzugen. Das ließe sich mit folgender Angabe realisieren: 
 + 
 +<code> 
 +%Y:%m:%d_ 
 +</code> 
 + 
 +Hier werden Namensräume (Verzeichnisse) für Jahr und Monat erzeugt und der Tag dem jeweiligen Eintrag vorangestellt. Der Eintrag selbst ist üblicherweise die Überschrift des Eintrags mit allen Leer- und Sonderzeichen ersetzt. 
 + 
 + 
 +==== Konfiguration des include-Plugins ==== 
 + 
 +Die wohl wichtigste Konfigurationsoption dieses Plugins für einen Blog ist ''plugin»include»firstseconly'', das angeschaltet werden sollte. Auf diese Weise wird lediglich der erste Abschnitt eines Blogeintrags in der Übersicht angezeigt, gefolgt von einem Link mit Verweis auf den gesamten Eintrag. 
 + 
 + 
 +==== Konfiguration des Pagelist-Plugins ==== 
 + 
 +Bei diesem Plugin gibt es erst einmal keine wesentlichen Einstellungen, die zu ändern wären. Einzig die Konfigurationsoption ''plugin»pagelist»showtags'' könnte im Zusammenspiel mit dem [[doku>plugin:tag|Tag-Plugin]] von Relevanz sein, da dann die vergebenen Tags auch in der Übersichtsliste angezeigt werden.
  
  
Zeile 44: Zeile 86:
  
 Dokuwiki schreibt //per se// Cookies, ohne den Nutzer zu fragen, und ohne die Chance, den Nutzer erst um Einwilligung zu bitten. Das Problem ist bekannt, es gibt keine harte technische Notwendigkeit, bei jedem Besuch einer Dokuwiki-Seite ein Cookie zu speichern, aber momentan gibt es keine technische Lösung dafür. Dokuwiki schreibt //per se// Cookies, ohne den Nutzer zu fragen, und ohne die Chance, den Nutzer erst um Einwilligung zu bitten. Das Problem ist bekannt, es gibt keine harte technische Notwendigkeit, bei jedem Besuch einer Dokuwiki-Seite ein Cookie zu speichern, aber momentan gibt es keine technische Lösung dafür.
 +
 +Ein Weg, damit erst einmal umzugehen und der DSGVO irgendwie gerecht zu werden, ist das [[doku>plugin:cookielaw|cookielaw-Plugin]], das immerhin eine Warnung auf der Seite ausgibt.
  
  
 ===== Impressum und Datenschutzerklärung ===== ===== Impressum und Datenschutzerklärung =====
  
-Zumindest für eine öffentlich zugängliche Seite kommt man wohl um ein Impressum und eine Datenschutzerklärung nicht herum.+Zumindest für eine öffentlich zugängliche Seite kommt man wohl um ein Impressum und eine Datenschutzerklärung nicht herum. Da ich kein Jurist bin und nie einer werden will, kann ich jeder Person nur raten, sich fachkundige Hilfe zu diesem Thema einzuholen. Ob und inwieweit Impressum und Datenschutzerklärung dieses Blogs juristisch haltbar sind, kann ich nicht abschätzen. 
 + 
 +Wichtig bei der Datenschutzerklärung: Verwendet man Plugins, die auf externe Webservices zugreifen (ein Beispiel wäre das sicherlich in mancher Hinsicht reizvolle [[doku>plugin:openlayersmap|OpenLayersMap-Plugin]] zum Einbinden von Karten), sollte man das entsprechend in der Datenschutzerklärung vermerken.
  
  
 ===== Wahl des Templates ===== ===== Wahl des Templates =====
  
-Ein Template für einen Blog sollte nach Möglichkeit zurückhaltend sein und nicht vom Bloginhalt ablenken. Natürlich kann man das Dokuwiki-Template verwenden, das mitgeliefert wird. Bei der Wahl anderer Templates war mir wichtig, dass sie keine Daten aus anderen Quellen beziehen, weshalb das ansonsten in meinen Augen ästhetische [[https://www.dokuwiki.org/template:prsnl10|prsnl10-Template]] ausscheidet (es lädt Schriftarten von Google). Ähnlich schlank ist das [[https://www.dokuwiki.org/template:ramtop|Ramtop-Template]], und es lässt sich in Verbindung mit dem [[https://www.dokuwiki.org/plugin:fontface|FontFace-Plugin]] und selbst hochgeladenen Schriften recht einfach in Richtung des [[https://www.dokuwiki.org/template:prsnl10|prsnl10-Template]] anpassen.+Ein Template für einen Blog sollte nach Möglichkeit zurückhaltend sein und nicht vom Bloginhalt ablenken. Natürlich kann man das Dokuwiki-Template verwenden, das mitgeliefert wird. Bei der Wahl anderer Templates war mir wichtig, dass sie keine Daten aus anderen Quellen beziehen, weshalb das ansonsten in meinen Augen ästhetische [[doku>template:prsnl10|prsnl10-Template]] ausscheidet (es lädt Schriftarten von Google). Ähnlich schlank ist das [[doku>template:ramtop|Ramtop-Template]], und es lässt sich in Verbindung mit dem [[doku>plugin:fontface|FontFace-Plugin]] und selbst hochgeladenen Schriften recht einfach in Richtung des [[doku>template:prsnl10|prsnl10-Template]] anpassen. 
 + 
 +Ggf. sollten weitere Anpassungen des Aussehens, überwiegend über die Datei ''userstyle.css'' im ''conf''-Verzeichnis der Dokuwiki-Installation, vorgenommen werden. Neben rein ästhetischen sind hier auch typographische Aspekte zu beachten. So haben viele Templates in der Grundeinstellung das Problem, dass die Zeilen relativ zur Schriftgröße zu lang sind und die Schrift insgesamt zu klein ist, als dass sie sich gut lesen ließe. Da ich auch kein Typograph bin, kann ich hier nur auf das vielfach in den Weiten des WWW verfügbare Wissen professioneller Typographen und die einschlägige Literatur verweisen. 
 + 
 + 
 +===== Erweiterte Konfiguration ===== 
 + 
 +Neben den drei zwingend notwendigen Plugins für einen Blog gibt es noch das [[doku>plugin:bloglinks|Bloglinks-Plugin]] und das [[doku>plugin:tag|Tag-Plugin]], die in meinen Augen sehr hilfreich für Blogs sind. Auch sie wollen ggf. richtig konfiguriert und verwendet werden. 
 + 
 + 
 +==== Bloglinks-Plugin ==== 
 + 
 +Belässt man die Einstellungen für das [[doku>plugin:blog|Blog-Plugin]] hinsichtlich des Namensraums für die Blog-Einträge beim Standard (''blog'') und ist man mit der Art, wie die Verweise der Blogartikel untereinander formatiert werden, einverstanden, gibt es hier eigentlich nichts weiter zu konfigurieren. 
 + 
 + 
 +==== Tag-Plugin ==== 
 + 
 +Für das Tag-Plugin gilt ähnliches wie für das [[doku>plugin:bloglinks|Bloglinks-Plugin]]: Hat man die Standardeinstellungen für die Blog-Einträge beim [[doku>plugin:blog|Blog-Plugin]] übernommen, sollte es hier eigentlich erst einmal wenig zu konfigurieren geben, es funktioniert "//out of the box//"
 + 
 + 
 +===== Grundlegende Organisation des Blogs ===== 
 + 
 +  * Wiki-Instanz nur für den Blog oder für mehr? 
 +  * Nur ein Blog oder mehrere unterschiedliche? 
 +  * Privater Blogbereich zum Vorschreiben von Beiträgen mit anschließendem Verschieben? 
 +  * Blog- und Archivseite 
  
  
 {{tag>dokuwiki blog}} {{tag>dokuwiki blog}}