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

The `size` parameter is optional, defaulting to full size.  You can specify
only the width or the height, and the other value will be calculated based
on it: "200x", "x200".

If you specify both the width and height, the original image's aspect ratio
will be preserved, even if this means making the image smaller than the
specified size. (However, this is not done for svg images.)

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.

The `pagenumber` parameter selects which of multiple images should be
rendered; this is relevant mainly for GIF and PDF source images.

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

## format support

By default, the `img` directive only supports a few common web formats:

* PNG (`.png`)
* JPEG (`.jpg` or `.jpeg`)
* GIF (`.gif`)
* SVG (`.svg`)

These additional formats can be enabled with the `img_allowed_formats`
[[!iki setup]] option, but are disabled by default for better [[!iki
security]]:

* PDF (`.pdf`)
* `everything` (accepts any file supported by ImageMagick: make sure that
  only completely trusted users can [[upload
  attachments|ikiwiki/pagespec/attachment]])

For example, a wiki where only `admin()` users can upload attachments might
use:

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

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