Die img-Anweisung wird durch die img-Erweiterung bereitgestellt.

Diese Anweisung verarbeitet Bilder. Während ikiwiki das Einbinden von Bildern in voller Größe durch einen WikiLink auf das Bild unterstützt, kann man mit dieser Anweisung ein Bild einfach herunterskalieren, um es in eine Seite einzubinden, und einen Link auf das Bild in Originalgröße setzen.

Verwendung

[[!img  image1.jpeg size="200x200" alt="Wolken"]]

Diese Bilddatei wird nach den gleichen Regeln gesucht wie das Ziel eines WikiLink.

Der Parameter size ist optional, voreingestellt ist die volle Größe. Man kann auch nur die Breite oder nur die Höhe angeben, dann wird der jeweils andere Wert automatisch berechnet: 200x, x200.

Wenn sowohl Breite als auch Höhe angegeben werden, wird das Seitenverhältnis des Originalbildes bewahrt, auch wenn dadurch ein kleineres Bild als angegeben entsteht. (Dies gilt jedoch nicht für SVG-Bilder.)

Man kann auch die Parameter alt, title, class, align, id, hspace und vspace übergeben. Diese werden an den img-Tag im erzeugten HTML-Code weitergereicht. Wird der Parameter caption angegeben, wird sein Wert unter dem Bild zentriert angezeigt.

Der Parameter link steuert, ob herunterskalierte Bilder mit dem Originalbild verlinkt werden. In der Voreinstellung ist dies der Fall; mit link=AndereSeite zeigt der Link auf eine andere Seite, mit link=no wird der Link deaktiviert, mit link=http://url zeigt er auf die angegebene URL.

Der Parameter pagenumber wählt aus, welches von mehreren Bildern angezeigt werden soll. Dies ist vor allem bei GIF- und PDF-Bildern relevant.

Man kann auch die Voreinstellung für die weiter unten auf der Seite eingebundenen Bilder verändern. Dies ist nützlich, wenn es auf einer Seite viele Bilder gibt.

[[!img  defaults size=200x200 alt="Hochzeitsfoto"]]
[[!img  photo1.jpg]]
[[!img  photo2.jpg]]
[[!img  photo3.jpg size=200x600]]

Unterstützte Formate

Standardmäßig unterstützt die img-Anweisung nur ein paar verbreitete Web-Formate:

  • PNG (.png)
  • JPEG (.jpg oder .jpeg)
  • GIF (.gif)
  • SVG (.svg)

Die folgenden Formate können mit der img_allowed_formats Setup-Option aktiviert werden, sind aber aus Sicherheitsgründen standardmäßig deaktiviert:

  • PDF (.pdf)
  • everything (akzeptiert alle Dateitypen, die von ImageMagick unterstützt werden: hierbei sollte sichergestellt werden, dass nur vollständig vertrauenswürdige Nutzer Anhänge hochladen können)

Das folgende Beispiel könnte in einem Wiki verwendet werden, in dem nur admin()-Benutzer Anhänge hochladen dürfen:

img_allowed_formats: [png, jpeg, gif, svg, pdf]