Die `img`-Anweisung wird durch die [[!iki plugins/img desc=img]]-Erweiterung
bereitgestellt.

Diese Anweisung verarbeitet Bilder. Während ikiwiki das Einbinden von
Bildern in voller Größe durch einen [[ikiwiki/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
[[ikiwiki/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` [[!iki setup
desc="Setup-Option"]] aktiviert werden, sind aber aus [[!iki security
desc="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|ikiwiki/pagespec/attachment]]
  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]

[[!meta robots="noindex, follow"]]
