summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/img.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive/img.mdwn')
-rw-r--r--ikiwiki/directive/img.mdwn42
1 files changed, 42 insertions, 0 deletions
diff --git a/ikiwiki/directive/img.mdwn b/ikiwiki/directive/img.mdwn
new file mode 100644
index 0000000..7f53dd6
--- /dev/null
+++ b/ikiwiki/directive/img.mdwn
@@ -0,0 +1,42 @@
+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]].
+
+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".
+
+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.
+
+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]]
+
+[[!meta robots="noindex, follow"]]