Aide:Galerie

Une page de Wikipédia, l'encyclopédie libre.
Aller à : navigation, rechercher
Sommaire de l'aide Aide de Wikipédia >Insérer un élément >Galerie
Information icon.svg
Vous êtes actuellement sur une page d'aide : Galerie. Cette page est destinée aux contributeurs débutants.
Pour accéder à l'aide avancée pour les utilisateurs expérimentés suivez ce lien : Aide:Galerie/avancée .

Une galerie d'images sur Wikipédia est une succession d'images organisée horizontalement. Elle se situe souvent en bas des articles, quand des images particulièrement pertinentes sont présentes en trop grand nombre et ne peuvent pas être placées directement en lien avec le texte.

La galerie peut avoir un titre ; chaque image doit avoir une légende. Dans la Wikipédia francophone, les galeries sont centrées par défaut. La largeur des galeries s'adapte à la taille d'écran du visiteur.

Attention, en français le terme « galerie » s'écrit avec un seul « l », mais le code source utilise comme balise HTML le terme anglais gallery qui prend deux « l ».

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.

Syntaxe d'une galerie[modifier | modifier le code]

Récapitulatif des codes à employer[modifier | modifier le code]

Cette liste résume les codes habituellement utilisés ; seuls <gallery> et </gallery> et le nom des fichiers d'images sont obligatoires. Les paragraphes suivants illustrent leur fonctionnement.

Codes obligatoires :

  • <gallery>: obligatoire, ce code marque l'ouverture de votre galerie
  • nom du fichier.extension : exemple de contenu minimaliste avec une première ligne de contenu variable (Exemple1.jpg) en principe trouvé sur Commons
  • nom 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> : obligatoire, ce code clôt la galerie

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 vignette, 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 réduites, et les légendes centrées
  • mode=packed : images affichées avec une hauteur identique (largeur adaptée automatiquement si besoin), légendes en 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 sur les images.

Message d'aide :

  • {{message galerie}}

Explications[modifier | modifier le code]

Syntaxe usuelle[modifier | modifier le code]

La syntaxe usuelle d'une galerie d'image est la suivante :

<gallery>
Tomato.svg|Une légende.
Tomato.svg|Une légende.
Tomato.svg|Une légende.
Tomato.svg|Une légende avec un [[Wikipedia|lien]].
Tomato.svg|Une légende.
Tomato.svg|Une légende.
</gallery>

avec pour résultat :

Options de base[modifier | modifier le code]

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é avec mode=packed et ses déclinaisons.
  • caption permet d'afficher un titre au-dessus de la galerie.
  • alt permet, comme les images avec thumb, 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">
Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée.
Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée.
Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée.
Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée.
Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée.
Tomato.svg|alt=Moitié de tomate coupée dans sa hauteur|Une tomate coupée.
</gallery>

Résultat :


Message explicatif[modifier | modifier le code]

En ajoutant sous la galerie le modèle {{message galerie}} on obtient ce message :

Cliquez sur une vignette pour l’agrandir

Note : il est a priori inutile d'ajouter ce message pour chaque galerie d'un même article, à moins que celles-ci ne soient très éloignées l'une de l'autre.

Autres options[modifier | modifier le code]

D'autres fonctionnalités permettent 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">
  • nolines

La présentation est sensiblement la même que le mode traditional, mais les bordures sont réduites et les légendes centrées.

<gallery mode="nolines">
  • packed

Les images sont affichées avec une hauteur identique, la largeur pouvant varier pour respecter le ratio original. L'espace entre les images est réduit.

<gallery mode="packed">
Variantes de "packed"[modifier | modifier le code]

Ces modes posent des problèmes d'affichage pour certains utilisateurs et doivent être utilisés avec précaution : quand la légende recouvre toute l'image, il n'y a quasiment plus de place pour cliquer, puisque la légende elle-même n'est pas cliquable. En mode "packed-hover", la légende est invisible pour les écrans ne disposant pas de la fonction survol de la souris. De plus, certains navigateurs afficheront par défaut le mode packed.

  • packed-overlay

Comme avec le paramètre packed, les images sont affichées avec une hauteur identique, mais la légende apparaît de manière constante sur l'image.

<gallery mode="packed-overlay">
  • packed-hover

Variante de packed-overlay, la légende n'apparaissant qu'au passage de la souris.

Certains navigateurs afficheront par défaut le mode packed à la place de celui-ci.

<gallery mode="packed-hover">

Avec cette option il est recommandé d'ajouter le modèle {{Message galerie 2}} qui affichera ceci :

Cliquez sur une image pour l'agrandir, ou survolez-la pour afficher sa légende.


Personnalisation[modifier | modifier le code]

Dans la Wikipédia francophone, par défaut, les galeries sont centrées, les légendes sont justifiées à gauche (sauf 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

Modifier une galerie[modifier | modifier le code]

Pour le moment la modification d'une galerie avec l'ÉditeurVisuel (onglet Modifier) n'est pas encore possible (mais c'est prévu). Pour modifier le contenu d'une galerie, il faut donc éditer le code source (onglet Modifier le code).

Voir aussi[modifier | modifier le code]