mydryseal/ ikiwiki/ directive/ img.de

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.

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 setup option, but are disabled by default for better security:

  • PDF (.pdf)
  • everything (accepts any file supported by ImageMagick: make sure that only completely trusted users can upload attachments)

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

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