Formatierungsoptionen von Bildern

Diese ist, wie bei bereits erlernten Elementen von DokuWiki, einfach eine Frage der Leerzeichen vor und hinter dem Link. Zwei Leerzeichen rechts bedeuten „linksbündig“, zwei Leerzeichen links dagegen „rechtsbündig“ und zwei links und rechts entsprechen „zentriert“:

Am linken Seitenrand (default): {{namespace:bild.png}}
Am rechten Seitenrand: {{  namespace:bild.png}}
Mittig in der Seite: {{  namespace:bild.png  }}

Gut das Du fragst!

Dies gehört zu den Dingen, an die man sich in der Arbeit mit DokuWiki gewöhnen muss. Es wird uns später nocheinmal begegnen, bei Namespace- und Seitennamen. Der Grund ist die sog. „Normalisierung“, welche intern in DokuWiki stattfindet. Damit wird sichergestellt, das die Dateinamen „Filesystem-Konform“ sind.

DokuWiki läuft auf zahlreichen Betriebssystemen. Jedes Betriebssystem hat andere Vorstellungen davon, welche Zeichen innerhalb von Verzeichnissen und Dateinamen gültig sind und wie lang diese sein dürfen. Letztlich speichert DokuWiki alles in Dateien im Filesystem des Servers. Hier waren die DokuWiki-Entwickler zu faul eine ordentliche Abstraktionsschicht einzuziehen, die diesen Umstand vor dem Anwender verschleiert. Leider ist dieser „Blinddarm“ bis heute gelieben.

D.H.: Einfach dran gewöhnen. Bei Bildern, etc. ist das auch noch nicht so schlimm, da der Dateiname hier kaum eine Rolle spielt. Ärgerlich ist das bei Dokumenten zum Download. Aber hier gäbe Abhilfe in form eines Plugins.

Im Quelltext der Seite stellt sich der Link immer so dar: Zuerst kommen zwei geschweifte, geöffnete Klammern {{. Anschließend folgt die Ziel-URL und abschließend zwei geschlossene, geschweifte Klammern }}. Zudem kann der Link auch Darstellungs- und Formatierungsanweisungen enthalten (siehe unten).

Die Ziel-URL kann entweder ein interner Pfad sein, oder eine externe URL.

In einer Code-Syntax (EBNF) ausgedrückt, kann man den Link wie folgt definieren:

LINK      ::= '{{' [BLANKS] [NAMESPACE ':'] IMAGE ['?' OPTIONS] [BLANKS] ['|' TITLE] '}}' ;

Die einzelnen Elemente bedeuten:

• IMAGE ⇒ Der Name der Bilddatei inkl. der Dateiendung („bild.jpg“)
• NAMESPACE ⇒ Der optionale interne DokuWiki-Ablageort der Bilddatei („:dokumente:bilder:“)
• BLANKS ⇒ Zwei Leerzeichen zur Ausrichtung des Bildes auf der Seite, optional vor oder hinter dem Link
• OPTIONS ⇒ Eine der folgenden Bildoptionen (mehrere können mit „&“ getrennt hintereinander geschrieben werden):
  • nolink ⇒ Zeigt nur das Bild, macht es aber nicht klickbar
  • linkonly ⇒ Zeigt den klickbaren Dateinamen des Bildes, aber nicht das Bild selbst
  • <size> ⇒ Gibt eine Vorschaugröße in Pixel an. Ein einzelner Zahlenwert bestimmt dabei die Breite. Höhe und Breite können mit „<width>x<height>“ dargestellt werden.
• TITLE ⇒ Optional darzustellender Titel, wenn man mit der Maus über dem Bild stehen bleibt („Tooltip“)

Und hier noch ein paar Beispiele dazu:

{{wikipfad:bilddatei.png}}
{{wikipfad:bilddatei.png|Bild-Titel}}
{{wikipfad:bilddatei.png?optionen|Bild-Titel}}

Na klar! Hierzu wird anstelle des internen DokuWiki-Pfades einfach eine externe URL angegeben. Um z.B. das Bild „image.png“ vom Webserver „www.webseite.de“ anzuziehen, wäre folgender Link einzugeben:

{{http://www.webseite de/image.png}}

Für externe Links gelten die gleichen Formatierungsregeln wie für interne. Bedenken sollte man natürlich, das externe Links nicht immer und ewig verfügbar sind. Auch Bild-URLs von Image-Hostern verfallen nach einer Zeit.