Modèle:Gallery/Documentation

Une page de Wikipédia, l'encyclopédie libre.
Aller à : navigation, rechercher
Illustration de documentation
Ceci est la page de documentation de Modèle:Gallery (modifier).
Cette sous-page contient les instructions, les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Utilisation[modifier | modifier le code]

Ce modèle permet de présenter des séries d'images en galerie, et de déterminer globalement ou séparément la taille (largeur, hauteur) qu'elles doivent avoir.

Contraintes liées à l'accessibilité[modifier | modifier le code]

Voir la discussion archivée du projet accessibilité, qui fait a fait remonter des problèmes lié à l'affichage en fonction des écrans :

  • Taille fixée des images en pixels (180 px par défaut), sans redimensionnement automatique des vignettes en fonction de la taille des écrans
  • Hauteur des légendes limitée
  • Vide trop important entre le bas de la légende et le texte sous les images quand il y a deux rang d'images

Syntaxe[modifier | modifier le code]

Chaque image doit être intégrée à la galerie avec la syntaxe suivante :

  • {{Gallery|File:Nom du fichier |altn=Texte Alternatif |Légende}}

Paramètres[modifier | modifier le code]

  • File : indique le nom complet du fichier image. Les deux préfixes File: ou Image: peuvent être utilisés au choix.
  • Altn : l'attribut alt se divise en alt1= pour la première image, alt2= pour la deuxième image, etc. Ce texte alternatif qui accompagne et décrit l'image est utilisé par les déficients visuels, ou par d'autres lecteurs qui ne peuvent pas bien voir cette image. S'il n'est pas précisé ici, aucun texte alternatif n'apparaîtra.
  • Légende : texte de la légende à placer sous l'image.

Paramètres optionnels[modifier | modifier le code]

Les paramètres suivants s'appliquent à l'ensemble de la galerie :

  • title : titre de la galerie ;
  • align : définit la position de la galerie sur la page, qui peut être alignée sur left (par défaut), center ou right ;
  • footer : permet d'insérer un texte en petits caractères en-dessous de la galerie, aligné à droite ;
  • style : définit les règles de style CSS à appliquer sur l'ensemble de la galerie.

Les paramètres suivants s'appliquent à toutes les images de la galerie :

  • height : la hauteur maximale de chaque image. La valeur par défaut est de 180 pixels ;
  • width : la largeur maximale, dont la valeur par défaut est de 180 pixels ;
  • cellwidth : la largeur de chaque case ou cellule contenant une image. Par défaut, sa valeur est la même que width. En revanche, si une valeur est précisée, alors elle prend le pas sur celle indiquée pour width ;
  • lines : le nombre de lignes requises pour la légende la plus grande (par défaut, sa valeur est de 2).

Le paramètre suivant s'applique à chaque image individuellement :

  • widthn (n étant un chiffre) : détermine la largeur de l'image n quand celle-ci doit être différente de la valeur indiquée par width.

Exemples[modifier | modifier le code]

  • {{Gallery | title = {{m|Gallery}} | lines = 5 | width = 200 | height= 250 | align = center | footer=Texte sous les images | File:Deutsch-französische Grenzländer, mit genauer Einzeichnung der französischen Befestigungs-Anlagen.jpg |Frontière franco-allemande, montrant l'emplacement exact du système de fortifications français. 1/400 000e. Version réduite de la carte spéciale d'Alsace-Lorraine d'Algermissen. | File:Big Sur McWay Falls May 2011.jpg|Les chutes McWay (McWay Falls) dans le parc d'État Julia Pfeiffer, à [[Big Sur]] en Californie. | File:Kaleidoscope.webm|Vue intérieure d'un kaléidoscope. }}
{{Gallery}}
Frontière franco-allemande, montrant l'emplacement exact du système de fortifications français. 1/400 000e. Version réduite de la carte spéciale d'Alsace-Lorraine d'Algermissen. 
Les chutes McWay (McWay Falls) dans le parc d'État Julia Pfeiffer, à Big Sur en Californie. 
Vue intérieure d'un kaléidoscope. 
Texte sous les images
  • {{Gallery |title=Représentations de George Washington |width=120 |height=100 |lines=4 |align=center |footer=Exemple 2 |File:Federal Hall NYC 27.JPG | alt1=Une statue fait face à un bâtiment avec des colonnes grecques |Statue de Washington devant le [[Federal Hall]] de [[New York City]], face à [[Wall Street]]. |File:Mount Rushmore2.jpg | alt2=Un visage en pierre sculpté dans la montagne, vu de profil, avec 3 ouvriers. |Création du portrait de Washington sur le [[Mont Rushmore]], v. 1932. |File:2006 Quarter Proof.png | alt3=Pièce argentée brillante, arborant un buste de Washington. |Washington représenté sur une pièce de 25 cents. |File:United_States_one_dollar_bill,_obverse.jpg | width4=200 | alt4=Recto d'un billet de banque américain, avec le portrait de Washington au centre. |Billet d'un dollar américain. |File:George Washington Presidential $1 Coin obverse.png | alt5=Pièce d'or arborant un buste de Washington tourné vers la gauche |Washington sur une pièce d'un dollar. }}
Représentations de George Washington
Une statue fait face à un bâtiment avec des colonnes grecques
Statue de Washington devant le Federal Hall de New York City, face à Wall Street
Un visage en pierre sculpté dans la montagne, vu de profil, avec 3 ouvriers.
Création du portrait de Washington sur le Mont Rushmore, v. 1932. 
Pièce argentée brillante, arborant un buste de Washington.
Washington représenté sur une pièce de 25 cents. 
Recto d'un billet de banque américain, avec le portrait de Washington au centre.
Billet d'un dollar américain. 
Pièce d'or arborant un buste de Washington tourné vers la gauche
Washington sur une pièce d'un dollar. 
Exemple 2

Dans cet exemple, le paramètre width4=200 détermine la largeur de la 4e image, de sorte que le billet de un dollar est plus large que les autres images de la galerie. On voit que la place allouée à la légende en revanche n'est pas modifiée, et elle est sur deux lignes alors qu'une seule suffirait.