[Kai-Martin Knaak]Den relevanten Inhalt von "apwiki_features.txt" in den "advanced_editor_hints.txt" einbauen.
Dokuwiki hat von Haus aus einen Mechanismus zur Darstellung von Anmerkungen eingebaut 1). Die Syntax dafür besteht in doppelten runden Klammern um den als Anmerkung gedachten Text:
((ANMERKUNG))
Im Fließtext schrumpft die Anmerkung zu einer Nummer zusammen. Diese Nummer ist ein Link an das Ende der Seite, wo die Anmerkungen der Reihe nach gesammelt sind. Auch die umgekehrte Richtung wird unterstützt: Die Nummer unten auf der Seite ist ein Link nach oben, wo die Anmerkung aufgerufen wird. Außerdem wird die Anmerkung in einem Pop-Up angezeigt, wenn die Maus über der Nummer sitzt.
Innerhalb einer Anmerkung funktionieren nicht alle Formatierungen, aber doch einige. Bilder und Links sind kein Problem2). Eine weitere Einschränkung betrifft Überschriften. Weder können Anmerkungen an Überschriften angehängt werden, noch können sie selber Überschriften enthalten3).
Dokuwiki verwaltet Bilder und andere Dateien in einem baumartigen Verzeichnis, das dem Baum der Wikiseiten enspricht. Ein Bild wird zunächst dort hochgeladen und dann im Wikitext aufgerufen. Dieser Screencast zeigt, den Ablauf:
Das imgpaste-Plugin beschleunigt das Einbinden von Bildern:
Videos werden genau wie Fotos in Dokuwiki eingebunden. Einziger Unterschied ist, das beim Video das Format *.mp4 sein sollte. Man kann mit einem optionalen Argument ein Bild angeben, das als Vorschau zu dem Video angezeigt wird. Dieses Bild wird wie ein normales Bild in den Medienbaum von Dokuwiki hochgeladen. Der Screencast oben wurde mit diesem Befehl eingebunden
{{ https://flowcasts.uni-hannover.de/nodes/wDmgZ/res0720.mp4?500x300px&:a_mechanik:kippender_besenstiel:bilder_in_dokuwiki_einbinden.png |Screencast zum Einbinden von Bildern}}
Bilder können in einen Rahmen gestellt und mit einer Bildunterschrift ausgestattet werden. Dafür ergänzt man den normalen Bilder-Link, der bei Dokuwiki in doppelten geschweiften Klammern besteht, um ein weiteres Paar von eckigen Klammern. Insgesamt ergibt sich:
[{{ PFAD-ZUM-BILD?200|BILDUNTERSCHRIFT}}]]
Dabei bewirkt das Leerzeichen links von “Pfad”, dass das Bild an den rechten Rand verschoben wird. Die “?200” bestimmen die Breite des Vorschaubilds.
Temp. (°C) | Pt100 (Ω) | Pt1000 (Ω) |
---|---|---|
-200 | 18.5 | 185 |
-195 | 20.7 | 207 |
-194 | 21.1 | 211 |
-190 | 22.8 | 228 |
-185 | 25.0 | 250 |
-180 | 27.1 | 271 |
Eine Tabelle in einer abgerundeten Box am rechten Seitenrand mit einer Beschreibung.
Bei Dokuwiki unterbrechen Tabellen normalerweise zeilenfüllend den Fließtext. Mit der <WRAP>-Umgebung kann man eine Tabelle an den Rand schieben und den Text darum herum fließen lassen. Dabei kann man explizit vorgeben, wie breit die Box dargestellt wird. Die Tabelle in der Box passt sich dann an diese Vorgaben an. Die Breite wird sinnvollerweise abhängig von der Schriftgröße gemacht (Einheit “em”). Dann gibt es weniger Überraschungen bei Anwendern, die in ihrem Browser ungewöhnliche Schriftgrößen verwenden:
<WRAP round box right width 15em> ^ Temp. (°C) ^ Pt100 (Ω) ^ Pt1000 (Ω) ^ | -200 | 18.5 | 185 | | -195 | 20.7 | 207 | | -194 | 21.1 | 211 | | -190 | 22.8 | 228 | | -185 | 25.0 | 250 | | -180 | 27.1 | 271 | Eine Tabelle in einer abgerundeten Box am rechten Seitenrand mit einer Beschreibung. </WRAP>
An den Fensterrand verschobene Bilder werden vom Fließtext umflossen. Die Bilder selbst werden in der Reihenfolge dargestellt, in der sie im Fließtext auftauschen. Das kann bei vielen, großen Bildern dazu führen, dass Text und Bilder auseinander driften. Mit Tabellen gibt es das gleiche Problem.
Ein <WRAP clear/>
sorgt dafür, dass weiterer Fließtext sich erst hinter allen bis dahin aufgerufenen Bildern und Tabellen anschließt.
Auf dem Server liegen im Ordner …/data/media/wiki/qplogo verschiedene Versionen des Logo des Physikpraktikums. Die diversen Dateien können automatisch in einer Tabelle, oder in einer Liste angezeigt werden. Mit vielen Optionen kann man das Ergebnis beeinflussen. Eine Tabelle mit einer Angabe der Dateigröße hat sich bewährt:
[n/a: No match]{{filelist>:wiki:qplogo:qp*&style=table&tableshowsize=1}}
Dokuwiki kann dabei die Formate als Galerie darstellen, die offiziell vom W3C für das WWW empfohlenen sind: PNG, JPG und SVG.
{{gallery>wiki:qplogo?lightbox&showname&4}}
Galerien werden wie einzelne Bilder, oder Tabellen platziert. Mit SPACE links, und/oder rechts von den geschweiften Klammern bestimmt die Ausrichtung relativ zum Fließtext. Damit gelten sie außerdem als “Floats”. Wenn man ihre Darstellung an einer bestimmten Stelle erzwingen will, sollte man zu <WRAP clear/>
greifen.
In der Default-Version des Edit-Fensters von Dokuwiki gibt es keine Funktion für Suchen-und-Ersetzen. Das Plugin toolbox ergänzt einen Knopf, der wie ein Schraubenschlüssel aussieht. Dahinter verbirgt sich ein Menü, dessen letzter Punkt “search and replace” ist.
Das Plugin groupusers erzeugt eine Tabelle aller User, die einer, oder mehreren Gruppen angehören:
{{groupusers|nomail>group1[,group2,...]}}
Das Admin-Log sammelt die Anpassungen für dieses Wiki im Vergleich zum Default, wie er im Februar 2013 von http://dokuwiki.org geladen wurde.