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.

Le paramètre size est facultatif. Par défaut la taille est la taille réelle. Le format d'image original est toujours respecté, même si cela signifie qu'il faut rendre l'image plus petite que la taille indiquée. Vous pouvez spécifier seulement la hauteur ou la largeur, et l'autre valeur sera calculée selon le format d'image, "200x", "x200".

Vous pouvez aussi spécifier les paramètres alt, title, class, align, id, hspace et vspace. Ils sont passés inchangés à la balise HTML « img ». Si vous ajoutez un paramètre caption, le sous-titre sera centré sous l'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.

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