Table of Contents

Ad Hominem Template

Ein einfaches und leichtgewichtiges Template, welches sich am Standard-Template von DokuWiki orientiert, aber viele zusätzliche, moderne Features mitbringt.

Die wichtigsten Features sind hier aufgelistet:

Suche

Eine der Stärken von DokuWiki ist die gut integrierte und mächtige Suchfunktion. Das Suchfeld bringt diese Funktionen alle zusammen:

Ad Hominem Template: Suchfeld mit Ergebnisliste

Suchfeld mit aufgeklappter Ergebnisliste

Ausklappbare Seitenleiste und Inhaltsverzeichnis

Auch die Seitenleiste ist eine Kernfunktion in DokuWiki1) Dieses Template hat deswegen gleich zwei verschiedene Ansätze, damit diese dem Benutzer nicht so sehr im Weg steht:

Auf Desktop-Bildschirmgrößen gibt es einen unscheinbaren Knopf, um die Seitenleiste an den Rand zu klappen:

Ad Hominem Template: Seitenleiste im zu- und aufgeklapptem Zustand

Seitenleiste im zu- und aufgeklapptem Zustand.

In einigen Modi – etwa beim Bearbeiten der Seite – ist die Seitenleiste automatisch eingeklappt (kann aber bei Bedarf aufgeklappt werden.

Anders sieht es auf kleineren Bildschirmen – etwa auf Smartphones – aus: Ist nicht genug Platz da, um die Navigation als Seitenleiste anzuzeigen, wird sie stattdessen zu einem Menü, das beim Öffnen über dem Seiteninhalt erscheint:

Ad Hominem Template: Seitenleiste als Menü

Seitenleiste als Menü auf kleineren Bildschirmen.

Inhaltsverzeichnis

Auch das Inhaltsverzeichnis der Seite ist meist eher im Weg. Aus diesem Grund ist es nach dem Öffnen der Seite erst einmal hinter einem unscheinbaren Icon, ganz oben rechts auf der Seite versteckt:

Ad Hominem Template: Inhaltsverzeichnis im geschlossenen Zustand

Inhaltsverzeichnis im geschlossenen Zustand.

Ein Klick auf das Icon und das Inhaltsverzeichnis wird aufgeklappt und sieht dann etwa wie folgt aus:

Ad Hominem Template: Inhaltsverzeichnis im ausgeklappten Zustand

Inhaltsverzeichnis im ausgeklappten Zustand.

Linkvorschau

Ein Alleinstellungsmerkmal dieses Templates (zumindest bis mein neues Nuropa Template veröffentlicht wird): Hält man den Mauszeiger über einem Link, wird eine Vorschau der verlinkten Seite angezeigt:

Ad Hominem Template: Linkvorschau für interne Links

Linkvorschau für interne Links.

Für die Linkvorschau wird der erste Absatz der verlinkten Seite (ausschließlich der Hauptüberschrift) verwendet2).

Neben internen Links funktioniert das auch für Wikipedia-Links (für alle Sprachversionen, die von DokuWiki unterstützt werden). Das sieht dann so aus:

Ad Hominem Template: Linkvorschau für Wikipedia-Links

Linkvorschau für Wikipedia-Links.

Und schließlich können so auch Verweise auf andere Wikis, die entweder dieses Template, oder Wikipedias Software „MediaWiki“ verwenden eine Vorschau erhalten. Hierfür sind aber tiefergehende Konfigurationen notwendig.

Druckmodus

Der Druckmodus wird von vielen Templates eher stiefmütterlich behandelt, nicht so hier. Dieses Template hat nicht nur einen, sondern gleich zwei gut durchdachte Druckmodi, die an die Grenzen dessen gehen, was heutzutage möglich ist.

In beiden Fällen gelten die folgenden Merkmale:

Einspaltiger Druck

Der normale Druckmodus (Einstellung: „einfach“) ist einspaltiger Druck. Dieses Format ist für gute Lesbarkeit optimiert und benötigt keine besonderen Formatierungen. Der Druck sieht etwa wie folgt aus3):

Druckvorschau für den einfachen Modus

Druckvorschau für den einfachen Modus.

Zweispaltiger Druck

Durch Umschalten in den „kompakten“ Modus wird der zweispaltige Druck aktiviert. Durch das kompaktere Layout (und eine etwas kleinere Schrift für den Fließtext) passt so mehr Text auf jede Seite. Dafür macht es mehr Aufwand, solche Seiten für einen hochwertigen Druck vorzubereiten.

Druckvorschau für den kompakten Modus

Druckvorschau für den kompakten Modus.

Überschriften der Größen h1 und h2 werden automatisch „breit“, d.h. über beide Spalten hinweg gedruckt; ebenso figure-Blöcke4). Für andere Elemente gibt es die Klasse print-wide, welche einen Druck über beide Spalten erzwingt.

Umgekehrt kann ein „breites“ Element in eine einzelne Spalte gebracht werden, indem ihm die Klasse print-narrow zugewiesen wird.

Während der normale einspaltige Druck recht zuverlässig und ohne größere Nacharbeiten mit allen üblichen Wiki-Inhalten funktioniert, wird beim zweispaltigen Druck empfohlen, diesen ausführlich und nach jeder größeren Änderung zu testen und ggf. die Formatierung nachzubearbeiten. Da dies recht arbeitsaufwändig sein kann, ist dieser Modus nicht für alle Wikis empfehlenswert!

Barrierefreiheit

Das Template wurde von Grund auf so konzipiert, dass alle Elemente eine Barrierefreiheit nach WCAG 2.1 auf dem Niveau AA implementieren.

Es gibt ein paar Einschränkungen, die sich aus der Implementierung insbesondere des DokuWiki-Renderers und anderer DokuWiki-interner Funktionen ergeben. Diese sind jedoch für den normalen Gebrauch nur wenig relevant (zum Beispiel sind die Buttons im Editor, welche das Bearbeitungsfeld größer oder kleiner machen, nicht barrierefrei).

Allerdings ist es möglich, z.B. durch Änderung der Farben, oder durch un-semantische Elemente im Textinhalt der Seiten, Probleme zu generieren. Wenn Barrierefreiheit für Ihre Site verpflichtend ist (z.B. bei Behörden), sollten Sie daher regelmäßig zumindest automatische Tests (etwa mit Wave) machen, um solche Probleme zu finden – und dann natürlich auch zu beheben.

Grundsätzlich ist dies übrigens für alle Website-Betreiber zu empfehlen – ganz unabhängig von eventuellen rechtlichen Pflichten!

Datenschutz

Das Template lädt von sich aus keine externen Dateien wie Schriften oder ähnliches, welche datenschutzrechtlich relevant wären.

Die Linkvorschau (siehe oben) kann unter bestimmten Umständen eine Anfrage an die Server verlinkter Sites machen. Dies betrifft insbesondere Anfragen an Wikipedia für Vorschautexte für Links dorthin.

Außerdem können spezifische, konfigurierte DokuWiki-Sites (welche dieses Template benutzen) auf dieselbe Weise kontaktiert werden. In der Standardkonfiguration ist dies nur für die Sites denkfehler.online und fallacies.online konfiguriert.

In keinem dieser Fälle werden nach bestem Wissen Daten über die Benutzer gesammelt, für die solche Anfragen gemacht werden.

Cookie-Banner

Das Template hat einen eingebauten Cookie-Banner, der wie folgt aussieht:

Ad Hominem Template: Cookies-Banner

Eingebauter Cookies-Banner

Da DokuWiki keine datenschutzrelevanten Cookies setzt (alle Cookies sind „funktional“), ist die einzige Option hier ein „OK“. Ein Link zu weiteren Informationen sollte zur Seite mit detaillierteren Cookies-Infos führen.

Sowohl der Text im Banner, als auch der Link können in den Einstellungen geändert werden. Außerdem kann dort die Position des Banners (unten oder oben) gewählt, und natürlich kann der Banner auch komplett ausgeschaltet werden (nicht empfehlenswert innerhalb der EU).

„Dunkelmodus“

Es sind nicht wenige Benutzer, welche einen „Nachtmodus“ auf dem Bildschirm bevorzugen, während andere lieber ein helles Erscheinungsbild haben. Anstatt der Site ein generell „helles“ oder „dunkles“ Erscheinungsbild zu geben, kann dieses Template den Benutzervorgaben folgen, also automatisch einen dunkles Erscheinungsbild verwenden, wenn im Betriebssystem der Dunkelmodus aktiv ist und ein helles, wenn nicht.

Ad Hominem Template: Hell- und Dunkelmodus derselben Seite

Hell- und Dunkelmodus derselben Seite

Der Dunkelmodus muss in den Template-Einstellungen ausdrücklich für die Site erlaubt werden. Es ist auch nicht möglich die Site nur im Dunkelmodus zu veröffentlichen (außer man kopiert die dunklen Farben in die regulären Farbeinstellungen um); der Dunkelmodus erscheint nur, wenn der Besucher dies in den Betriebssystemeinstellungen ausdrücklich ausgewählt hat.

Daneben sollte man sich darüber im Klaren sein, das dieser Modus auch möglicherweise unerwartete Nebenwirkungen auf den Inhalt der Site haben kann:

Zum einen haben alle Elemente, die zugewiesene Farben haben, dies auch im Dunkelmodus. Wer also farbige Hervorhebungen benutzt, sollte diese sorgfältig so auswählen, dass sie in beiden Modi gut sichtbar sind (oder das Plugin Ad-Hoc Wrap benutzen, welches den Dunkelmodus voll unterstützt!).

Dasselbe gilt für Bilder: Solche, die sich darauf verlassen, dass sie auf einem hellen Hintergrund angezeigt werden, sehen auf einem dunklen Hintergrund womöglich nicht mehr gut aus. Um schwarze Zeichnungen auf dunkelgrauem Hintergrund zu vermeiden, werden daher im Dunkelmodus alle Bilder grundsätzlich invertiert!

Ad Hominem Template: Abbildung im Hell- und Dunkelmodus (invertiert)

Abbildung im Hell- und Dunkelmodus (invertiert)

Während das für Strichzeichnungen gut funktioniert, sieht das dann bei Vollfarb- oder sogar schon Graustufen-Bildern nicht mehr gut aus. Hier ein Beispiel:

Ad Hominem Template: Graustufen-Bild in drei Modi: Hell, dunkel (invertiert) und dunkel (nicht invertiert)

Graustufen-Bild in drei Modi: Hell, dunkel (invertiert) und dunkel (nicht invertiert)

Um diese Invertierung zu vermeiden, sollten solche Bilder in ein Element „verpackt“ werden, welches die Klasse no-filter enthält.

Das könnte z.B. mit dem Ad-Hoc HTML-Plugin so aussehen:

<figure no-filter>{{:abbildung.png|Title}}</figure>

Oder mit dem Wrap-Plugin wie folgt:

<WRAP no-filter>{{:abbildung.png|Title}}</WRAP>

Auch hier gilt: wird der Dunkelmodus verwendet, sollte man die Seiten regelmäßig in beiden Modi betrachten, um mögliche Probleme aufzuspüren und zu beheben.

Nicht alle Wikis sind „Standalone“. In vielen Fällen ist das Wiki nur eine Unterseite eines größeren Webauftrittes. In diesen Fällen sollte dies auch in der Struktur der Site widergespiegelt werden.

Dafür erlaubt es das Template, einen spezifischen „Homelink“ anzugeben. Ist dieser gesetzt, erscheint dieser Link an allen relevanten Stellen als Startseite:

Bleibt dieses Feld leer, wird das normale Verhalten dieser Elemente beibehalten.

Sonstiges

1)
Siehe hierzu auch den Artikel: Wie füge ich eine Sidebar hinzu?.
2)
Es ist generell eine gute Praxis, jeden Artikel mit einer Übersicht über den zu erwartenden Inhalt zu beginnen
3)
je nach verwendetem Browser kann es zu kleineren Abweichungen kommen
4)
Um HTML Elemente (einschließtlich Klassen) in den Wiki-Code einzufügen wird das Ad-Hoc HTML Plugin empfohlen. Alternativ kann auch das Wrap Plugin benutzt werden.