Aide:Galerie

Aide de Wikipédia

Insérer une image, une référence, etc.

Import des images, mise en page et droit d'auteur

Cette page ne concerne que lewikicode(liens« modifier le code »).

Voir la page d'aide pour l'éditeur visuel.
Quelle différence?

Niveau avancé

Unegalerie d'imagessur Wikipédia est une succession d'images organisée horizontalement. Elle se situe souvent en fin d'article ou de section, quand des images particulièrement pertinentes sont présentes en trop grand nombre et ne peuvent pas être placées directement en vignettes flottant dans le corps du texte. La galerie peut avoir un titre; chaque image doit avoir une légende. Sur la Wikipédia francophone, les galeries sont centrées par défaut. La largeur des galeries s'adapte à la taille d'écran du visiteur.

Voir aussi:Aide niveau expert concernant les galeriesetModifier une galerie avec l'éditeur visuel

Important:Les lecteurs qui ne disposent pas d'une liaison internet performante, ou qui utilisent des lecteurs d'écran, sont gênés par les galeries comportant de trop nombreuses images.

Récapitulatif des codes à employer

Cette liste résume les codes habituellement utilisés.

Codes obligatoires:

<gallery>:marque l'ouverture de votre galerie
En français, « galerie » s'écrit avec un seul « l », mais le wikicode utilise le terme anglais «gallery» qui prend deux « l ».
nom du fichier.extension:exemple de contenu minimaliste avec une première ligne de contenuvariable(Exemple1.jpg) en principe trouvé surCommons
nom du fichier.extension|alt=Texte alternatif|Légende:exemple de contenu accessible avec une seconde ligne de contenuvariable(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ées
mode=packed:images affichées sans bordures avec une hauteur identique (largeur adaptée automatiquement si besoin), légendes au-dessous des images
mode=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 unlien.
Une légende.

Options de base

Les galeries créées avec<gallery>admettent divers paramètres:

perrowdonne 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=packedet ses déclinaisons.
captionpermet d'afficher un titre au-dessus de la galerie.
altpermet, comme les images avecthumb,d'afficher untexte « 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 deperrowdans 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:

Galerie avec paramètre perrow
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ètremodepermet 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`

Les modespacked-hoveretpacked-overlay,destinées à supprimer l'espace vertical occupé par les légendes sous les images, posent de sérieux problèmes d'affichage pour la plupart des galeries contenant des légendes. Ils doivent être utilisés avec précaution:

Sur les écrans ne disposant pas de la fonctionsurvol de la souris:
- enpacked-hover,la légende est totalement invisible sans possibilité de l'afficher;
- enpacked-overlay,seul le début de la légende est visible, sans possibilité d'afficher la suite.
Recouvrement de l'image par la légende:
- enpacked-overlay,selon la hauteur des images, la légende peut en recouvrir une bonne partie, empêchant de les voir correctement;
- dans les deux modes, au survol de la souris, la légende va encore davantage masquer l'image, voire déborder verticalement au-dessus de la galerie, recouvrant d'autres éléments de la page tels que le texte de l'article, et empêchant de cliquer sur l'image pour l'agrandir (il faut sortir la souris de la légende puis survoler à nouveau l'image dans une zone hors-légende).
Certains navigateurs (sans Javascript) affichent par défaut le modepacked(avec des images de hauteur fixe, non réajustées en taille entre les marges, seulement centrées).

Utilisez plutôt le modepackedpour toujours afficher la légende sous les images tout en conservant la disposition compacte et les images cadrées à la même hauteur. Une autre solution pour utiliser le modepacked-hoverest d'augmenter sensiblement la hauteur par défaut des images avec l'optionheights=200px(voir par exempleBéarn#Galerie d'images).

packed-overlay
Comme avec le paramètrepacked,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" >
```

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.

packed-hover
Variante depacked-overlay,la légende étant totalement cachée et n'apparaissant intégralement qu'au passage de la souris.

Certains navigateurs afficheront par défaut le modepacked-overlayà la place de celui-ci.
```
<gallery mode= "packed-hover" >
```

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

Il peut être déconseillé de personnaliser les galeries en dehors desmodesqui viennent d’être décrits ci-dessus, ce par souci de cohérence entre les diverses pages de Wikipédia et pour ne pas compliquer la syntaxe des articles et en conséquence leur maintenance.

Dans la Wikipédia francophone, par défaut, les galeries sont centrées, les légendes sont justifiées à gauche (sauf avec le modenolines) 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, voirAide:Galerie/avancée.

Notes

↑Depuis 2014, ces codes ne sont plus obligatoires pour le bon fonctionnement de la galerie, mais ladocumentation généralerecommande de les conserver pour la lisibilité du code.

Voir aussi

[1] Depuis 2014, ces codes ne sont plus obligatoires pour le bon fonctionnement de la galerie, mais ladocumentation généralerecommande de les conserver pour la lisibilité du code.

[1]