DokuWiki

Seite bearbeiten und [Speichern] drücken. Siehe syntax zur Wiki-Syntax. Bitte nur editieren, falls das Dokument tatsächlich verbessert werden kann. Zum Testen bitte erst im Spielplatz üben.

====== Umgang mit Bildern und Medien ======

Dateien können in [[DokuWiki]]-Seiten mit Hilfe der [[de:wiki:syntax#bilder_und_andere_dateien|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 [[de:mime|Mime]] zu finden.

{{http://wiki.splitbrain.org/lib/images/toolbar/image.png}} Neue Dateien werden mit Hilfe des [[de:media_manager|Media Managers]] hochgeladen, welcher aus der [[de:toolbar|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 [[de:namespaces| Namensraum ]] im Namen verwendet (Namensraum:Datei) wird dieser automatisch hinzugefügt. Es sollte darauf geachtet werden die Dateierweiterung richtig beizubehalten.

Notiz: Wenn der Administrator [[de: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.

===== Größenänderungen =====

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 [[config:im_convert|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 [[config: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.

===== Verlinkungen =====

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?20}} 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?20&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?20&nolink }} Dieses Bild ist nicht verlinkt.

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

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}} Dies ist nur ein Link zu einem Bild.

===== Dynamische Bilder =====

Manchmal möchte man ein dynamisches Bild einfügen, wie [[http://kalsey.com/tools/buttonmaker/button.php?barPosition=50&leftText=Dynamic&leftTextColor=ffffff&rightText=IMG&rightTextPosition=54|dieses]].

Diese Methode:

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

funktioniert nicht:

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

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?}}

===== Medien entfernen =====

Manchmal ist es nötig Bilder wieder zu löschen, welche zuvor hochgeladen wurden. Um dies zu machen muss die [[de: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: [[de:faq:deletemedia|Mediadateien löschen]]

===== Bild verlinken =====

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}}]]

===== Caching (Zwischenspeicherung) =====

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.

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 [[de:config:cachetime|cachetime config option]] festgelegten Intervall neu von einem externen Server zu laden.

Bitte übertragen Sie die Buchstaben in das Eingabefeld. O J K W I Dieses Feld bitte leer lassen

Zusammenfassung

Hinweis: Durch das Bearbeiten dieser Seite geben Sie Ihr Einverständnis, dass Ihr Inhalt unter der folgenden Lizenz veröffentlicht wird: CC Attribution-Share Alike 4.0 International