La directive `img` est fournie par le module d'extension [[!iki plugins/img
desc=img]].

Cette directive est consacrée à la gestion des images. Ikiwiki permet de
relier des images en taille réelle en faisant un [[ikiwiki/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 [[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.)

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`
[[!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"]]
