Obwohl ich DokuWiki und das Indexmenu-Plugin schon seit Jahren verwende, ist mir erst kürzlich aufgefallen, dass es für das Plugin verschiedene Themes gibt
Zur Installation von neuen Themes öffnet man unter Administration im Bereich “Weitere Plugins” die “Indexmenu Werkzeuge” und klickt auf den “Anzeigen”-Button der unteren Zeile. Dadurch werden für jedes vorhandene Thema die Icons/Symbole angezeigt:
DokuWiki Indexmenu Werkzeuge
Hier kann man neue Themen direkt installieren.
Bei der Verwendung des Plugins gibt man dann noch das neue Thema in der Syntax mit an; z. B.:
Da die Icons alleine noch keinen Eindruck machen, habe ich in einer Testseite die für mich interessanten Themen eingebunden:
Indexmenu Themen für DokuWiki
Habe mich letztlich für das zweite Thema (indextheme) entschieden.
Die Hervorhebung der aktuell geöffneten Seite im Indexmenü lässt sich übrigens nicht einstellen sondern bedarf einer kleinen Änderung im CSS, siehe hier.
Bisher wurden auf (*.)natenom.name vor allem externe Links in einem neuen Tab/Fenster geöffnet, auch wenn man diese mit einem Linksklick geöffnet hat. Dies wurde umgestellt, sodass Links jetzt immer im aktuellen Tab/Fenster geöffnet werden, da dies anscheinend besser und vertrauenswürdiger für Endbenutzer ist; denn die wollen selbst mithilfe ihres Browsers entscheiden, wie ein Link geöffnet werden soll.
Habe selbst vor ein paar Tagen festgestellt, dass es ziemlich nervig ist, hier bevormundet zu werden. Dazu kommt, dass man so die “Zurück-Funktion” des Browsers sinnvoll nutzen kann.
Es folgt eine Liste der Dienste und wie die Umstellung bei diesen funktioniert.
DokuWiki
Es reicht aus, unter Konfiguration -> Link-Konfiguration den Wert von target>extern auf “_self” oder einen leeren Wert zu setzen:
DokuWiki – externe Links
WordPress
Hierfür gibt es ein gutes Plugin namens Search-Regex, mit dem man Suchen und Ersetzen kann. Dann dauert das Ganze ca. 1 Minute. Man ersetzt dann einfach die Zeichenkette ‘target=”_blank”‘ durch ‘target=”_self”‘, was die Standardeinstellung für das Öffnen von Links ist.
Ohne dieses Plugin müsste man jeden Artikel öffnen und bei den “Link einfügen”-Eigenschaften den Haken bei “Link in neuem Fenster oder Tab öffnen” entfernen.
Gallery3
Bei Gallery3 muss man nichts ändern, es ist bereits per Voreinstellung alles so eingerichtet, dass Links im aktuellen Fenster/Tab geöffnet werden.
Habe leider erst gestern bemerkt, dass seit der Umstellung der Link zum exportieren der aktuellen Seite in eine PDF-Datei fehlte.
Auf der Web-Seite des dw2pdf-Plugins steht zwar beschrieben, wie man den PDF-Export-Button/-Link einfügt, diese Methode funktionierte allerdings nicht, da immer nur die Startseite exportiert wurde, egal wo im Wiki man sich befunden hat.
Daher wurde ein einfacher Link unter das Indexmenü in die sidebar gepackt:
<html><img src='/lib/images/fileicons/pdf.png'> <a href='?do=export_pdf'>Aktuelle Seite als PDF exportieren</a></html>
Und das Ergebnis:
Export-Link wieder da
site_notice
Auch ist mir direkt nach der Umstellung des Templates nicht aufgefallen, dass die von monobook bekannte site_notice nicht im neuen Template verfügbar ist. Wenn benötigt, kann man diese Leiste selbst erstellen und z. B. in die Datei lib/tpl/dokuwiki/pageheader.html packen, damit sie im Hauptbereich angezeigt wird, direkt über der Seitenüberschrift auf Höhe des Inhaltsverzeichnisses. Um die Leiste jedoch vom Inhalt visuell zu trennen, wurde sie später in die Datei lib/tpl/dokuwiki/header.html verschoben, und befindet sich damit ganz oben auf der Seite:
URL-Leiste als Ersatz für site_notice
Bilder
Bilder werden übrigens automatisch verkleinert, wenn das Browser-Fenster kleiner wird. Das war mir damals noch nicht bekannt, sollte aber unbedingt noch erwähnt werden.
\o/
Insgesamt ist das neue Standard-Template immer noch sehr sehr angenehm fürs Auge und es macht Spass, damit zu arbeiten
Ein paar Tage nach dem Update auf die neue Version von DokuWiki ist es nun soweit: Statt des bisher verwendeten Templates monobook wird jetzt in unserem Wiki das Standard-Template “DokuWiki” von Anika Henke verwendet.
Vorteile
Einige Vorteile des neuen Templates gegenüber monobook:
Angepasste Ansichten für mobile Geräte, siehe unten
Rechts am Rand befindet sich eine Leiste, die mitscrollt und sich somit immer auf derselben Höhe befindet. Sie beinhaltet folgende Links:
Leiste rechts…
Wenn man angemeldet ist, kann man die “Seite bearbeiten” und die “Aboverwaltung” öffnen.
Rechts neben dem Logo können ein Titel und ein Slogan (tagline) angezeigt werden
Suche und andere Tools sind rechts oben erreichbar
Per Voreinstellung sind im Text verwendete Links, die auf Seiten innerhalb des Wikis verlinken, grün und externe Links blau. Externe Links haben vorne ein entsprechendes URL-Symbol.
Habe jedoch die internen Links wieder auf blau gesetzt, wie sie auch bei monobook waren.
Änderungen an CSS und JavaScript
Die bisher im Wiki verwendeten Änderungen müssen für das neue Template etwas angepasst werden; die Informationen dazu sind im Wiki hinterlegt, siehe unter:
Um wie auch in monobook eine kleine Seiten-Notiz (wiki/site_notice) anzuzeigen, wird innerhalb von lib/tpl/dokuwiki/ eine Datei namens pageheader.html erstellt und mit Inhalt befüllt; dieser wird dann in jeder Wiki-Seite angezeigt.
Kleine Bildschirme
Das neue Template sieht auch auf kleinen Displays richtig gut aus. Vielen Dank an Darcade für die drei folgenden Screenshots (dort steht noch 0.1 Inhaltsverzeichnis, der Fehler ist mittlerweile behoben).
Im bisherigen monobook-Template nahm z. B. auf einem kleinen Monitor die Navigation den größten Teil des Bildschirms ein:
Monobook (altes Template) auf Android
Beim neuen Standard-Template “DokuWiki” wird bei Unterschreitung einer bestimmten Mindestbreite die Sidebar mit der Navigation nach oben versetzt und das Inhaltsverzeichnis darunter, jeweils eingeklappt:
DokuWiki-Template auf Android
Navigation/Sidebar und Inhaltsverzeichnis lassen sich getrennt einblenden/ausblenden:
DokuWiki-Template mit eingeblendeter Sidebar/Navigation
Große Bildschirme
Und hier Vergleichsbilder auf einem Monitor mit Full-HD-Auflösung, zuerst das alte Template:
DokuWiki mit monobook
Und das neue Template:
DokuWiki mit Standard-Template
Passt
Insgesamt ist das Aussehen des neuen Templates sehr angenehm, passt
Habe unser Wiki auch bereits mit dem Upgrade-Plugin aktualisiert. Damit die verwendete Überschriftennummerierung wieder passt und “Inhaltsverzeichnis” nicht “0.1 Inhaltsverzeichnis” heißt, muss man folgende Zeile in die Datei lib/tpl/monobook/user/style.css eintragen:
Fast jedenfalls, mit einer Änderung: Auch die Überschriften im Text sind noch durchnummeriert.
Ansonsten beginnt die Nummerierung sowohl im Inhaltsverzeichnis als auch im Text erst bei der zweiten Ebene (h2); der Seitenname steht also für sich.
Hier ein Screenshot:
Schon seit Ewigkeiten wollte ich Überschriftennummerierung für das Wiki haben, denn die Überschriften der verschiedenen Gewichtungen (h1 bis h6) werden in Monobook nur leicht unterschiedlich formatiert. Gerade bei vielen Abschnitten eines Dokuments fällt es schwer, zu erkennen, ob es sich nun um einen Unterpunkt (z. B. 1.1) oder einen neuen Abschnitt (z. B. 2) handelt. Die Struktur des Dokuments ist nicht wirklich ersichtlich.
Um nummerierte Überschriften zu erhalten, gibt es zwei Möglichkeiten:
Man verwendet das veraltete Plugin NumberedHeadings und muss jede Überschrift manuell anpassen. Das ist zu aufwändig und fällt weg.
Man verwendet CSS und überlässt dem Browser die Arbeit; ein entsprechendes CSS-Konstruk existiert bereits.
Das Problem mit dem CSS-Konstrukt ist jedoch, dass es aus dem Jahr 2008 stammt und auf das damalige Standard-Template ausgelegt ist. Mit Monobook funktioniert es so nicht. In der Beschreibung steht zwar, man muss bestimmte Dinge ersetzen, beim ersten Versuch vor einiger Zeit bin ich jedoch aufgrund mangelnder Kenntnisse gescheitert und habe den Ansatz wieder vergessen.
Bei einem neuen Versuch heute habe ich es aber doch geschafft und nun sind die Überschriften im Wiki nummeriert, was die Übersicht erhöht
Habe den angepassten CSS-Code im Wiki hinterlegt unter http://wiki.natenom.name/ueber/nummerierte_ueberschriften.
Hier der Eindruck ohne (links) und mit Nummerierung (rechts):
DokuWiki - Unterschiede mit Nummerierung und ohne
Werde das zur Sicherheit auch noch durch einen Spezi prüfen lassen, falls ich in Unkenntnis etwas verpfuscht haben sollte.
Mit dem DokuWiki-Plugin Zoom von Heiko Hoebel wird die Einbindung von Bildern ermöglicht, zu denen dann beim Überfahren mit der Maus der jeweilige Ausschnitt vergrößert dargestellt wird, z. B.:
Links das eingebundene Bild, rechts die dynamische Vergrößerung
Die Vergrößerung kann rechts neben dem eigentlichen Bild oder auch im Bild selbst angezeigt werden. Es ist auch möglich, die Markierung links farblich zu verändern, usw.
Alle Möglichkeiten des Plugins kann man bei aktiviertem JavaScript hier betrachten: http://www.ib-hoebel.de/wiki/doku.php?id=computer:zoom_plugin.
Einen Knackpunkt gibt es leider bei diesem Plugin: Es ist nicht möglich, Bildunterschriften zu verwenden.
Vielleicht wird diese Funktion ja in Zukunft noch umgesetzt.
Um die Ausgabe dieses Plugins zu erhalten, erstellt man eine Seite mit folgendem Inhalt:
~~NOCACHE~~
~~ORPHANSWANTED:all~~
Auf dieser Seite werden dann folgende Informationen angezeigt:
Orphans – Seiten, die nicht verlinkt sind.
Im Wiki sind dies sehr viele, was aber auch daran liegt, dass z.B. Links in generierten Indexseiten (mittels indexmenu oder pagequery) nicht mitgerechnet werden.
Wanted – Seiten, auf die zwar verlinkt wird, die aber noch nicht existieren.
Dieser Abschnitt ist z.B. hilfreich, wenn man die Struktur eines Wikis verändert.
Valid – Anzahl der gültigen Links zu einer existierenden Seite mit der Möglichkeit, diejenigen Seiten anzuzeigen, in denen verlinkt wird.
Ich war doch sehr überrascht, wie viele Seiten nicht verlinkt waren (ca. 180); mittlerweile sind es nur noch ca. 140. Der Rest wird auch noch stärker verknpüft werden
Mit dem DokuWiki-Plugin sortablejs von Otto Vainio kann man bereits bestehende Tabellen nachträglich mit einem einfachen Tag sortieren.
Auch ist es für Benutzer interaktiv möglich, die Sortierung über die Spaltenüberschriften jederzeit zu ändern.
Man kann angeben, ob bestimmte Spalten überhaupt sortierbar sind und ob sie alphabetisch oder numerisch sortiert werden sollen.
, dass die Tabelle anhand der zweiten Spalte umgekehrt sortiert wird. Interaktiv kann ein Benutzer auch nach der zweiten Spalte sortieren lassen, nicht jedoch nach der dritten. Dabei wird die erste Spalte numerisch, die zweite Spalte nach Text sortiert.
Beispieltabelle
Wie der Name vermuten lässt, muss JavaScript aktiviert sein, damit sortiert wird.