Dateien können in DokuWiki-Seiten mit Hilfe der Bild-Syntax eingebettet und hochgeladen werden.

Während Bilder und Flash Dateien direkt auf der Seite angezeigt werden, werden andere Dateien (z. B. PDF) nur auf der Seite verlinkt. Weitere Details sind unter Mime zu finden.

Neue Dateien werden mit Hilfe des Media Managers hochgeladen, welcher aus der Toolbar heraus aufgerufen wird.

Zum Hochladen kann das obere Formular im Media Manager benutzt werden. Optional kann hier auch ein neuer Name für die Datei gewählt werden.

Wird ein Namensraum im Namen verwendet (Namensraum:Datei) wird dieser automatisch hinzugefügt. Es sollte darauf geachtet werden die Dateierweiterung richtig beizubehalten.

Notiz: Wenn der Administrator ACL aktiviert hat, kann der Upload auf einige Benutzer beschränkt sein. Benutzer ohne Uploadrechte sehen dieses Formular nicht.

Wie Bilder eingebunden werden, kann mit unterschiedlichen Parametern beinflußt werden. Parameter werden wie bei URLs mit einem Fragezeichen (?) angehängt, mehrere Parameter werden durch ein Kaufmännisches Und (&) getrennt.

DokuWiki kann Bilder auf zwei verschiedene Arten skalieren. Standardmäßig wird PHPs LibGD Unterstützung benutzt, wenn es installiert ist.

Bessere Ergebnisse können mit dem Kommandozeilentool Imagemagick erreicht werden.

Bei der Benutzung von LibGD, kann die Größenänderung fehlschlagen, wenn nicht genug Speicher verfügbar ist oder das Bildformat nicht von der installierten LibGD Version unterstützt wird.

Um externe Bilder zu skalieren müssen sie auf dem Server zwischengespeichert werden. Um das zu tun muss DokuWiki erlaubt werden externe Dateien herunterzuladen. Dies kann durch die Erhöhung der Option fetchsize aktiviert werden.

Um ein Bild proportional zu skalieren, muss nur die Breite in Pixeln angehängt werden:

{{wiki:dokuwiki-128.png?20}}

Dieses Bild ist auf eine Breite von 20 Pixeln herunter skaliert.

Um ein Bild in der Höhe proportional zu skalieren, muss 0x und die Höhe in Pixeln angehängt werden:

{{wiki:dokuwiki-128.png?0x20}}

Dieses Bild ist auf eine Höhe von 20 Pixeln herunter skaliert.

Werden Höhe und Breite angegeben, wird das Bild ohne Rücksicht auf das Verhältnis exakt zu dieser Größe skaliert:

{{wiki:dokuwiki-128.png?20x50}}

Dieses Bild ist zu einer Breite von 20 und einer Höhe von 50 Pixeln skaliert.

Ab DokuWiki 2009-02-14 wird das Bild vor der Skalierung zugeschnitten um ein Verzerren des Bildes zu verhindern.

Werden Bilder mit DokuWiki auf eine Seite gesetzt, so werden diese standardmäßig zu einer Detailseite mit Informationen zum Bild und einer großen Ansicht verlinkt. Es ist aber auch möglich Bilder mit eigenen Links einzufügen oder diese nicht zu verlinken.

Die standardmäßig verlinkte Detailansicht wird durch die Template-Datei detail.php gesteuert. Das Standard-Template zeigt hier eine große Version des Bildes sowie einige Details aus den EXIF- und IPTC-Metainformationen wie z. B. (Untertitel, Autor, Aufnahmedatum etc.).

Der folgende Syntax fügt ein Bild auf eine Seite ein und verlinkt es zu einer Detailseite mit weiteren Informationen:

{{wiki:dokuwiki-128.png}}

Klicken Sie auf dieses Bild um auf die Detailseite des Bildes zu gelangen.

Klickt man auf das Bild auf der Detailseite, so gelangt man zu einer Seite, die nur das Bild in Originalgröße anzeigt.

Oft fügt man ein Bild in einer kleinen Größe ein, das Bild auf der Detailseite wird in mittlerer Größe angezeigt, dieser letzte Link bietet das Bild nun in seiner vollen Größe an.

Mit dem Parameter direct zeigt ein Bild nach dem Klicken direkt auf die Originalgröße des Bildes. Dieser Parameter wird einfach wie die Größe an das Bild angehängt:

{{wiki:dokuwiki-128.png?direct}}

Klicken Sie auf dieses Bild um es in Originalgröße anzuzeigen.

Es ist auch möglich ein Bild ganz ohne Verlinkung einzufügen. Hierzu wird der Parameter nolink angehängt:

{{wiki:dokuwiki-128.png?nolink}}

Dieses Bild ist nicht verlinkt.

Die Verlinkungs- und Größenparameter des Bildes lassen sich getrennt von einem Kaufmännischen Und (&) kombinieren.

{{wiki:dokuwiki-128.png?nolink&100}}

Um einen Link zu einem Bild einzufügen, ohne das Bild selber auf der Seite anzuzeigen, wird der Parameter linkonly benutzt.

{{wiki:dokuwiki-128.png?linkonly}}

dokuwiki-128.png Dies ist nur ein Link zu einem Bild.

Manchmal möchte man ein dynamisches Bild einfügen, wie dieses.

Diese Methode:

{{http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54}}

funktioniert nicht:

button.php

Dies liegt daran, das DokuWiki Bilder mit der Dateiendung .gif,.jpg or .png verknüpft, diese Datei endet allerdings mit .php. Der Trick liegt darin einen zusätzlichen Parameter wie z.B. &.png an die URL anzuhängen, dieser Parameter wird ignoriert aber DokuWiki denkt es handele sich um ein Bild.

Zusätzlich muss ein zusätzliches Fragezeichen an das Ende gestellt werden um zu verhindern, das DokuWiki die Parameter für Caching-Optionen hält.

{{http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54&.png?}}

Manchmal ist es nötig Bilder wieder zu löschen, welche zuvor hochgeladen wurden. Um dies zu machen muss die ACL Funktion aktiviert werden und der Benutzer Löschrechte besitzen. Ist dies gegeben, so können Medien über das Mülleimer Symbol im Media Manager gelöscht werden.

Siehe auch: Mediadateien löschen

Um ein Bild zu verlinken, reicht es das Bild wie einen normalen Text mit einem Link zu umschließen.

Beispiel:  [[http://www.google.com|{{wiki:dokuwiki-128.png}}]]

Beispiel:

Um die Performance für die Benutzer zu steigern, versucht DokuWiki externe Bilder zu cachen. Ist dies nicht gewünscht, so kann der nocache Parameter angehängt werden:

{{http://de3.php.net/images/php.gif?nocache}}

Dies kann auch mit anderen Parametern kombiniert werden.

{{http://de3.php.net/images/php.gif?300x50&nocache}}

Bei jedem Seitenaufruf eine Anfrage an einen externen Server zu senden, ist nicht sehr höflich. Anstelle dessen kann der Parameter recache benutzt werden um das Bild nach dem in cachetime config option festgelegten Intervall neu von einem externen Server zu laden.

{{http://de3.php.net/images/php.gif?recache}}