La directive img est fournie par le module d'extension img.

Cette directive est consacrée à la gestion des images. Ikiwiki permet de relier des images en taille réelle en faisant un WikiLink qui pointe vers l'image. Avec cette directive vous pouvez facilement réduire la taille de l'image pour permettre son inclusion dans une page, tout en créant un lien vers l'image en taille réelle.

Usage

[[!img  image1.jpg size="200x200" alt="clouds"]]

L'image est recherchée selon les mêmes règles utilisées pour chercher un fichier pointé par un 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.)

You can also pass alt, title, class, align, id, hspace, and vspace parameters. These are passed through unchanged to the html img tag. If you include a caption parameter, the caption will be displayed centered beneath the image.

Le paramètre link contrôle la liaison entre l'image réduite et l'image à taille réelle. Par défaut il les relie. Vous pouvez définir "link=somepage" pour créer un lien vers une autre page, "link=no" pour désactiver le lien ou encore "link=http://url" pour créer un lien vers une URL.

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

Vous pouvez aussi définir des valeurs par défaut qui seront utilisées pour toutes les images, sauf si ces valeurs sont annulées. C'est très utile quand on insère beaucoup d'images sur une page.

[[!img  defaults size=200x200 alt="wedding photo"]]
[[!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]