Quelle différence ?
Récapitulatif des codes à employer
Cette liste résume les codes habituellement utilisés.
Codes obligatoires :
<gallery>
: marque l'ouverture de votre galerienom du fichier.extension
: exemple de contenu minimaliste avec une première ligne de contenu variable (Exemple1.jpg
) en principe trouvé sur Commonsnom du fichier.extension|alt=Texte alternatif|Légende
: exemple de contenu accessible avec une seconde ligne de contenu variable (Exemple2.jpg|alt=Texte alternatif|Légende
)</gallery>
: clôt la galerie- Les préfixes des images,
Fichier:
,File:
ouImage:
, sont nécessaires pour une bonne lisibilité du code[1].
Codes optionnels :
caption="..."
: le titre de la galerie, à insérer à l'intérieur des deux guillemets pour éviter les problèmes de typographie (le titre est centré à l'affichage)perrow=
: définit le nombre d'images par ligne ; n'agit que par réduction du nombre de vignettes, qui seront « au maximum » au nombre fixéshowfilename
: fait apparaître le nom de fichier de chaque image au-dessus de leurs titres.
Modes d'affichage optionnels :
mode=traditional
: images affichées avec une bordure, légendes apparentes en dessous. Mode par défaut, il peut être omis.mode=nolines
: idem, mais les bordures sont masquées, et les légendes centréesmode=packed
: images affichées sans bordures avec une hauteur identique (largeur adaptée automatiquement si besoin), légendes au-dessous des imagesmode=packed-hover
: images affichées avec une hauteur identique, légendes n'apparaissant qu'au passage de la souris sur les images.mode=packed-overlay
: images affichées avec une hauteur identique, légendes permanentes en surimpression sur les images.
Explications
Syntaxe usuelle
La syntaxe usuelle d'une galerie d'image est la suivante :
<gallery> Fichier:Tomato.svg|Une légende. Fichier:Tomato.svg|Une légende. Fichier:Tomato.svg|Une légende. Fichier:Tomato.svg|Une légende avec un [[Wikipédia:Liens internes|lien]]. Fichier:Tomato.svg|Une légende. </gallery>
avec pour résultat :
-
Une légende.
-
Une légende.
-
Une légende.
-
Une légende avec un lien.
-
Une légende.
Options de base
Les galeries créées avec <gallery>
admettent divers paramètres :
perrow
donne le nombre d'images maximum par ligne (si la résolution de l'affichage l'autorise ; sinon le nombre d'images par ligne sera réduit pour s'adapter à celle-ci). Ce paramètre est ignoré lorsqu'il est utilisé avecmode=packed
et ses déclinaisons.caption
permet d'afficher un titre au-dessus de la galerie.alt
permet, comme les images avecthumb
, d'afficher un texte « alternatif » pour les non-voyants et les lecteurs d'écran n'ayant pas accès aux images. Le texte alternatif doit être aussi concis que possible (éviter de dépasser 120 caractères).
Exemple d'utilisation de perrow
dans une galerie comportant aussi un titre et des textes alternatifs :
<gallery perrow="3" caption="Galerie avec paramètre perrow"> Fichier:Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée. Fichier:Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée. Fichier:Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée. Fichier:Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée. Fichier:Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée. Fichier:Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée. </gallery>
Résultat :
-
Une tomate coupée.
-
Une tomate coupée.
-
Une tomate coupée.
-
Une tomate coupée.
-
Une tomate coupée.
-
Une tomate coupée.
Modes d'affichage
Le paramètre mode
permet de choisir la disposition des images ou des légendes, ou la taille du cadre.
traditional
: C'est le mode par défaut, il peut être omis.<gallery mode="traditional">
-
Astronotus ocellatus (Oscar).
-
Salmo salar (Saumon atlantique).
-
Epinephelus lanceolatus (Mérou géant).
-
Pterois volitans (Rascasse volante) est une espèce de poissons très venimeux.
nolines
: La présentation est sensiblement la même que le modetraditional
, mais les images sont alignées verticalement vers le haut, les bordures masquées, et les légendes centrées horizontalement.<gallery mode="nolines">
-
Astronotus ocellatus (Oscar).
-
Salmo salar (Saumon atlantique).
-
Epinephelus lanceolatus (Mérou géant).
-
Pterois volitans (Rascasse volante) est une espèce de poissons très venimeux.
packed
: Les images sont affichées avec une hauteur identique, la largeur pouvant varier pour respecter le ratio original. L'espace horizontal entre les images est réduit.<gallery mode="packed">
-
Astronotus ocellatus (Oscar).
-
Salmo salar (Saumon atlantique).
-
Epinephelus lanceolatus (Mérou géant).
-
Pterois volitans (Rascasse volante) est une espèce de poissons très venimeux.
Options déconseillées
Variantes de packed
packed-overlay
- Comme avec le paramètre
packed
, les images sont affichées avec une hauteur identique (120px par défaut), mais la légende apparaît de manière constante en surimpression de l'image (et peut parfois déborder au-dessus de son cadre lorsque la légende est un peu trop longue). Toutefois le comportement a depuis été amélioré : si le navigateur prend en charge le survol, la hauteur de la légende affichée en permanence sera limitée à une seule ligne (la légende visible sera tronquée), mais la légende complète sera affichée en survolant l'image. <gallery mode="packed-overlay">
- Comme avec le paramètre
packed-hover
- Variante de
packed-overlay
, la légende étant totalement cachée et n'apparaissant intégralement qu'au passage de la souris. <gallery mode="packed-hover">
- Variante de
-
Astronotus ocellatus (Oscar).
-
Salmo salar (Saumon atlantique).
-
Epinephelus lanceolatus (Mérou géant).
-
Pterois volitans (Rascasse volante) est une espèce de poissons très venimeux de la famille des Scorpaenidae. Il ne faut pas la confondre avec d'autres poissons appelés aussi rascasses volantes.
<gallery mode="packed-hover" heights="200px">
-
Astronotus ocellatus (Oscar).
-
Salmo salar (Saumon atlantique).
-
Epinephelus lanceolatus (Mérou géant).
-
Pterois volitans (Rascasse volante) est une espèce de poissons très venimeux de la famille des Scorpaenidae. Il ne faut pas la confondre avec d'autres poissons appelés aussi rascasses volantes.
Personnalisation
Dans la Wikipédia francophone, par défaut, les galeries sont centrées, les légendes sont justifiées à gauche (sauf avec le mode nolines
) et la largeur des galeries s'adapte à la taille d'écran du visiteur ou à ses préférences.
Pour une présentation des images avec le modèle {{Animation}} ou dans un tableau, ou pour modifier la présentation du texte des légendes, voir Aide:Galerie/avancée.
Notes
- Depuis 2014, ces codes ne sont plus obligatoires pour le bon fonctionnement de la galerie, mais la documentation générale recommande de les conserver pour la lisibilité du code.