Aide:Images

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Images and the translation is 100% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Tiếng Việt • ‎Türkçe • ‎Zazaki • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎slovenčina • ‎suomi • ‎čeština • ‎русский • ‎српски / srpski • ‎українська • ‎עברית • ‎العربية • ‎سنڌي • ‎پښتو • ‎हिन्दी • ‎中文 • ‎日本語 • ‎한국어
PD Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur les pages d’aide concernant le domaine public.
PD

Cette page explique la syntaxe des images lors de l'édition du wiki. Vous, ou un autre utilisateur devez habituellement téléverser une image sur un serveur avant de pouvoir l'utiliser dans une page.

Les images ainsi stockées sur un serveur MediaWiki sont généralement accessibles en utilisant le préfixe de l'espace de noms File: (mais l'ancien préfixe d'espace de noms Image: est encore utilisable en tant que synonyme) pour la cible d'un lien MediaWiki. Le préfixe alternatif d'espace de noms Media: peut être également utilisé pour référencer le contenu originel du fichier média (pour un rendu ou un téléchargement séparé, en dehors de toute page MediaWiki).

Types de médias pris en charge pour les images

Les formats suivants sont supportés par défaut :

  • .jpg or .jpeg : image bitmap compressée au format standard JPEG (ce format avec pertes est le plus approprié pour les photographies).
  • .png : image bitmap au format Portable Network Graphics (spécifié par le W3 Consortium).
  • .gif : image bitmap au format ancien Graphics Interchange Format.

Les autres formats utilisés sur Wikimedia, et généralement activés ailleurs (cela peut nécessiter des étapes d'installation supplémentaire au delà de ce qui est activé par défaut) sont :

  • .svg : image redimensionnable dans le format Scalable Vector Graphics (spécifié par le W3 Consortium). Voir Manual:Image Administration#SVG.
  • .tiff : Format tagged image. Souvent utilisé pour l'archivage de photographies haute résolution. Souvent utilisé avec Extension:PagedTiffHandler .
  • .ogg, .oga, .ogv : Ogg multimedia (audio ou video). Pas un format image, mais traité de la même manière. Souvent utilisé avec Extension:OggHandler .
  • .pdf : documents multi-pages dans le Portable Document Format (initialement spécifié par Adobe). Souvent utilisé en conjonction avec Extension:PdfHandler .
  • .djvu : documents bitmap multipages dans le formatDejaVu (le plus souvent, scan de livre). Voir Manual:How to use DjVu with MediaWiki
    Seule une page de fichier .pdf ou .djvu est affichée à la fois.

D'autres types de supports peuvent être pris en charge, mais il peut ne pas être possible de les afficher en ligne.

Affichage d'une seule image

Syntaxe

Voici la syntaxe complète pour afficher une image :

[[File:filename.extension|options|caption]]

où « options » peut être vide ou bien est composé des éléments suivants, séparés par le symbole '|' (pipe) :

Pour de meilleurs résultats, utilisez les minuscules pour toutes les options listées ci-dessous (par exemple utilisez thumb, et non Thumb). Certaines options peuvent fonctionner quand la première lettre est une majucsule, mais la plupart sont ignorées. (Voir tâche T216566 pour les détails.)
  • Option de format : une parmi border et/ou frameless, frame, thumb (ou thumbnail); (respectivement bordure, sans cadre, avec cadre, miniature). Si plusieurs de ces options sont présentes, seule la première sera utilisée.
    Ceci contrôle la manière dont l'image affichée est formatée et incluse dans le reste de la page.
  • Option de Redimensionement : une valeur parmi :
    • {width}px — Redimensionne l'image pour l'adapter à la largeur maximale donnée en pixels, sans restreindre sa hauteur. (Vous pouvez mettre un caractère espace entre la valeur de la largeur et « px ».)
    • x{height}px — Redimensionne l'image pour l'adapter à une hauteur maximale donnée en pixels, sans restreindre sa largeur
    • {width}x{height}px — Redimensionne l'image pour l'adapter à la largeur et la hauteur données en pixels
    • upright — Redimensionne une image pour l'adapter à des dimensions raisonnables, selon les préférences de l'utilisateur (adapté aux images dont la hauteur est plus grande que la largeur). En fixant |upright=1.0| vous affichez l'image avec la largeur d'image par défaut de l'utilisateur. Avec |upright=2.0| vous afficherez l'image deux fois plus grande que la largeur par défaut de l'utilisateur.
    L'image gardera toujours ses proportions.
    Les images ayant des types de média non-redimensionnables peuvent être réduites en taille, mais pas agrandies; c'est par exemple le cas des images au format bitmap.
    L'initialisation de upright ne nécessite pas d'utiliser le signe égale, c'est à dire que |upright 2.0| opère de la même manière que |upright=2.0|.
    Si utilisé sans valeur ou de signe égale (par exemple, |upright|), il équivaut à la valeur par défaut |upright=0.75| (bien que |upright=| soit la même chose que |upright=1.0|).
    Si à la fois |upright| et |upright=number| sont présents, le premier |upright| sera ignoré. Voir tâche T216003 pour les détails.
    S'il existe un caractère espace entre « upright » et le signe égale (par exemple |upright =number|), la valeur upright sera ignorée. Voir tâche T216003 pour les détails.
    La taille maximale par défaut dépend du format et des dimensions internes de l'image (en fonction de son type de support).
  • Option Horizontal alignment : une parmi left (gauche), right (droite), center (centré), none (aucun); Si plusieurs de ces options sont présentes, seule la première sera utilisée.
    Contrôle l'alignement horizontal (et les styles en-ligne/bloc ou flottant) de l'image dans un texte (pas de valeur par défaut).
  • Option Vertical alignment : une parmi baseline (line de base), sub (sous), super (au-dessus), top (haut), text-top (haut du texte), middle (milieu), bottom (bas), text-bottom (bas du texte).
    Contrôle l'alignement vertical d'une image non-flottante en ligne avec le texte avant ou après l'image, et dans le même bloc (l'alignement vertical par défaut est au milieu middle ).
  • Option Link: une parmi:
    • link={cible} — Permet de changer la cible du lien généré (vers un titre de page arbitraire, ou une URL), activable pour l'affichage de l'image; par exemple [[File:Example.jpg|20px|link=http://www.wikipedia.org]] est interprété comme Example.jpg (lien externe), ou [[File:Example.jpg|20px|link=MediaWiki]] est interprété comme Example.jpg (lien interne).
    • link= (valeur vide) — (MediaWiki 1.14+) Affiche une image sans aucun lien activable; à savoir [[File:Example.jpg|20px|link=]] est interprété comme Example.jpg.
    S'il y a un caractère espace entre link et le signe égale, la déclaration du lien sera traitée comme une légende.
    ! Pour MW 1.24 et plus ancien : si vous définissez |link=| (vide), alors aucun title ne sera interprété (voir phabricator:T23454).
  • Autres options spécifiques :
    • alt={texte alternatif} — (MediaWiki 1.14+) Définit le texte alternatif (correspond à l'attribut HTML alt="..." de l'élément d'une image <img />) généré qui sera affiché soit si l'image référencée ne peut pas être téléchargée et intégrée, soit si le support du média nécessite l'utilisation du texte de description de remplacement (par exemple lors de l'utilisation d'un lecteur Braille ou avec des options d'accessibilité définies par l'utilisateur dans son navigateur).
    S'il y a un caractère espace entre alt et le signe égale, la déclaration de alt sera traitée comme une légende.
    • page={nombre} — Affiche le numéro de page spécifié (actuellement seulement applicable lors de l'affichage d'un fichier .djvu ou .pdf).
    • class={classe html} — (MediaWiki 1.20+) Définit les classes (correspond à l'attribut HTML class="..." de l'élément <img /> généré).
    • lang={language code} — (MediaWiki 1.22+) Pour les fichiers SVG contenant des instructions <switch> qui dépendent d'un attribut langue système. Sélectionne la langue dans laquelle le fichier doit être affiché. Par défaut il s'agit de la langue de la page (la langue par défaut du projet pour la plupart des projets).

Si un paramètre ne correspond à aucune des autres possibilités, il est supposé être le texte de la légende. S'il y a plus d'une chaîne présente qui ne soit pas un paramètre, la dernière de ces chaînes sera utilisée en tant que légende. Le texte de la légende s'affiche sous l'image pour les formats vignette(thumb) et cadre(frame), et correspond au texte d'une infobulle pour les autres formats. Pour les formats thumb et frame, le texte affiché dans la légende peut contenir des liens wiki et d'autres marques de formatage. D'autres options peuvent êtres ajoutées par les extensions MediaWiki.

Si l'option 'alt' n'est pas renseignée, et qu'une légende est fournie, le texte alternatif (alt) sera créé automatiquement à partir de la légende, sans marques de formatage, sauf en mode vignette ou cadre car la légende est déjà lisible par les lecteurs d'écran dans ce cas.

Format

Le tableau suivant montre l'effet de tous les formats disponibles.

Lorsque la hauteur d'une image en miniature est plus grande que sa largeur (c'est à dire en orientation portrait plutôt que paysage) et que vous trouvez qu'elle est trop grande, vous pouvez essayer l'option upright=N, où N est le rapport d'aspect de l'image (largeur de l'image divisée par sa hauteur; fixée par défaut à 0,75). L'alternative est de spécifier explicitement la hauteur maximale souhaitée (en pixels).

Notez qu'en écrivant thumb={filename}, vous pouvez utiliser une image différente pour la vignette.

Taille et cadre

Parmi les différents formats, l'effet du paramètre de taille peut être différent, comme indiqué ci-dessous.

  • Pour savoir comment il apparaît lorsque sa taille est pas spécifiée, voir la section Format ci-dessus.
  • Lorsque le format est pas spécifié, ou seulement avec border, la taille peut être à la fois réduite ou agrandie à la valeur que vous indiquez.

Dans les exemples ci-dessous, la taille originale de l'image est de 400 × 267 pixels. Une image avec frame ignore toujours la spécification de la taille; l'image originale sera réduite si elle dépasse la taille maximale définie dans les préférences de l'utilisateur. La taille d'une image avec thumb ou frameless peut être réduite, mais ne peut pas être élargie au-delà de la taille originale de l'image.

Format Réduit Agrandi
(non spécifié)
[[File:Example.jpg|50px]]

Example.jpg

[[File:Example.jpg|200px]]

Example.jpg


border
[[File:Example.jpg|border|50px]]

Example.jpg

[[File:Example.jpg|border|200px]]

Example.jpg


frame
[[File:Example.jpg|frame|50px]]
Example.jpg
[[File:Example.jpg|frame|200px]]
Example.jpg


thumb
[[File:Example.jpg|thumb|50px]]
Example.jpg
[[File:Example.jpg|thumb|200px]]
Example.jpg


frameless
[[File:Example.jpg|frameless|50px]]

Example.jpg

[[File:Example.jpg|frameless|200px]]

Example.jpg

Alignement horizontal

Notez qu'en utilisant les formats frame ou thumb[nail], l'alignement horizontal par défaut sera à droite (right).

Description Vous tapez Vous obtenez
aucun alignement horizontal n'a été spécifié , ou alignement par défaut
Affiché comme un bloc flottant: non
Affiché "inline": oui
... texte texte texte
[[File:example.jpg|100px|légende]]
texte texte texte ...
... texte texte texte

légende texte texte texte ...

alignement horizontal none (aucun)
Affiché comme un bloc flottant: non
Affiché "inline": non
... texte texte texte
[[File:example.jpg|none|100px|légende]]
texte texte texte ...
... texte texte texte
légende

texte texte texte ...

alignement horizontal centrer (centré)
Affiché comme un bloc flottant: non
Affiché "inline": non
... texte texte texte
[[File:example.jpg|center|100px|légende]]
texte texte texte ...
... texte texte texte
légende

texte texte texte ...

alignement horizontal left (à gauche)
Affiché comme un bloc flottant: oui
Affiché "inline": non
... texte texte texte
[[File:example.jpg|left|100px|légende]]
texte texte texte ...
... texte texte texte
légende

texte texte texte ...

alignement horizontal right (à droite)
Affiché comme un bloc flottant: oui
Affiché "inline": non
... texte texte texte
[[File:example.jpg|right|100px|légende]]
texte texte texte ...
... texte texte texte
légende

texte texte texte ...

Alignement vertical

Les options d'alignement vertical n'ont d'effet que si l'image est rendue comme un élément en-ligne (inline) et non pas en flottant. Ils modifient la façon dont l'image en ligne sera alignée verticalement avec le texte présent dans le même bloc avant ou après cette image sur la même ligne d'affichage.

Notez que la ligne de texte affichée là où les images en ligne sont insérées (et les lignes de texte affichées ensuite) peut être déplacée vers le bas (cela va augmenter la hauteur de ligne conditionnée par l'espacement de ligne additionnel, exactement comme s'il s'agissait d'un span avec du texte de taille variable, ou avec des exposants ou des indices) pour permettre à l'image d'être pleinement affichée avec cette contrainte d'alignement.

Afficher/Masquer le code source
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|100px|top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|100px|text-top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sup>super:</sup> [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|100px|super]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|100px|baseline]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sub>'''sub:'''</sub> [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|100px|sub]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|100px]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|100px|middle]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|100px|text-bottom]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]]
<del>text</del></u></span></p>

Pour afficher le résultat d'alignement plus clairement, les span du texte sont surlignés et soulignés, la taille de police est augmentée à 200%, et le bloc de paragraphe est encadré avec une bordure mince; en outre, des images de tailles différentes sont alignées:

text top: Example.jpg Example.jpg Example.jpg text

text text-top: Example.jpg Example.jpg Example.jpg text

text super: Example.jpg Example.jpg Example.jpg text

text baseline: Example.jpg Example.jpg Example.jpg text

text sub: Example.jpg Example.jpg Example.jpg text

text default: Example.jpg Example.jpg Example.jpg text

text middle: Example.jpg Example.jpg Example.jpg text

text text-bottom: Example.jpg Example.jpg Example.jpg text

text bottom: Example.jpg Example.jpg Example.jpg text

Notes:

  1. La position « middle » d'alignement vertical de l'image (qui est aussi la valeur par défaut) se réfère généralement au milieu entre la « hauteur de x » et la ligne de base du texte (sur lequel le milieu vertical de l'image sera aligné, et sur lequel le texte peut habituellement être en dépassement), mais pas au milieu de la hauteur de ligne de la hauteur de la police qui se réfère à la hauteur entre les positions « haut du texte » (text-top) et « bas du texte » (text-bottom); la hauteur de la police exclut :
    • l'espacement inter-ligne supplémentaire normalement divisé également en deux marges (ici 0.5em, selon la hauteur de ligne-fixé à 200%) au-dessus et au-dessous de la hauteur de la police).
    • l'espacement inter-ligne supplémentaire qui peut être ajouté par les exposants et les indices.
  2. Toutefois, si la hauteur de l'image provoque un dépassement au-dessus ou en dessous de la ligne pleine hauteur normale du texte, la position médiane sera ajustée par augmentation de la marge supérieure et/ou inférieure de telle sorte que l'image puisse s'adapter et aligner correctement, et que toutes les images (y compris celles d'hauteurs plus petites) soient centrées verticalement sur la position médiane ajustée (pour calculer la hauteur de ligne effective, on considère le texte de chaque rangée affichée avec la hauteur de police la plus grande).
  3. Les positions d'alignement « haut du texte » (text-top) et « bas du texte » (text-bottom) excluent également l'ajout d'espacement supplémentaire de ligne lié aux exposants et indices, mais pas l'espacement supplémentaire interligne défini par la hauteur de ligne.
  4. Les positions d'alignement « top » et « bottom » prennent en compte tous les espacements supplémentaires des lignes (y compris les exposants et les indices, s'ils ont été inclus dans un span). Lorsque l'alignement d'images contraint l'image à croître au-dessus ou en dessous du seuil d'espacement normal de ligne, et que l'image n'est pas en positionnée en absolu, l'image provoque l'ajustement des positions « haut » (top) et « bas » (bottom) (tout comme les exposants et indices), de sorte que la hauteur effective rendue entre les lignes de texte, sera plus grande.
  5. Les positions des décorations de texte « underline », « overline » et « overstrike » devraient être quelque part entre ces deux limites et peuvent dépendre du type et de la taille des polices utilisées (les styles exposant et indice peuvent être pris en compte dans certains navigateurs, mais généralement ces styles sont ignorés et la position de ces décorations ne peuvent pas être ajustées); de sorte que ces décorations n'ont normalement pas d'incidence sur la position verticale des images, par rapport au texte.

Arrêter le flux du texte

A l'occasion, il est souhaitable d'arrêter le flux du texte (ou d'autres images en ligne non flottantes) autour d'une image flottante. En fonction de la résolution de l'écran du navigateur web et autres, le flux du texte sur le côté droit d'une image peut provoquer qu'un en-tête de section (par exemple, == My Header ==) apparaisse à droite de l'image, au lieu de se trouver en dessous, comme un utilisateur pourrait s'y attendre. Le flux du texte peut être arrêté en plaçant <br clear=all> (ou si vous préférez, <div style="clear: both"></div>) avant le texte qui doit commencer sous l'image flottante. (Cela peut aussi se faire sans ligne vide, en encadrant la section des images flottantes avec <div style="overflow: hidden">…</div>, ce qui efface tous les flottants à l'intérieur de l'élément div.)

Toutes les images affichées sous forme de blocs, y compris les images non-flottantes centrées (center), les images flottantes alignées à gauche (left) ou à droite (right), ainsi que les images flottantes encadrées (frame) ou sous forme de vignette (thumbnail), cassent implicitement les lignes du texte enveloppant (elles terminent le bloc de texte actuel précédent l'image et créent un nouveau paragraphe pour le texte qui les suit). Elles seront ensuite empilées verticalement le long de leur marge d'alignement à gauche ou à droite (ou le long de la ligne médiane entre ces marges pour les images centrées).

Modifier la cible du lien par défaut

Le tableau suivant illustre comment modifier la cible du lien (dont la valeur par défaut est la page de description de l'image) ou comment l'enlever. Changer le lien ne modifie pas le format décrit dans les sections précédentes.

Avertissement:

Les exigences de licence sur votre wiki peuvent ne pas vous permettre de supprimer tous les liens vers la page de description qui affiche les attributions d'auteurs requises, les déclarations de droits d'auteur, les conditions de licence applicables, ou une description plus complète de l'image affichée (y compris son historique des modifications) .
Si vous modifiez ou supprimez le lien cible d'une image, vous devrez alors fournir sur votre page un lien explicite vers un autre endroit où se trouve cette page de description, ou afficher les droits et la déclaration de l'auteur, ainsi qu'un lien vers la licence applicable, si ceux-ci sont différents des éléments applicables à la page d'intégration elle-même.
Votre politique de wiki peut restreindre l'utilisation du paramètre de lien alternatif, ou peut même appliquer une interdiction de paramètres de liaison alternatifs pour les fichiers multimédias intégrés (dans ce cas, le paramètre de liaison sera ignoré), ou ne peut les accepter qu'après validation par les utilisateurs autorisés ou les administrateurs.


Affichage d'une galerie d'images

Syntaxe pour une galerie

Il est facile de faire une galerie de miniatures en utilisant la balise $galery . La syntaxe est :

<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>

Notez que le code de l'image n'est pas entre crochets lorsqu'il est entre les balises de galerie.

Les légendes sont optionnelles, et peuvent contenir des liens wiki et autres balises de formatage. Certains paramètres contrôlant l'affichage des vignettes peuvent également être utilisés ici, notamment ceux qui modifient le fichier (contrairement à ceux qui contrôlent le positionnement de l'image dans la page). Par exemple, avec les médias multi-pages comme les PDF, vous pouvez utiliser du code comme page=4.

Le préfixe File: peut être omis. Cependant, il est pratique de l'inclure comme une aide pour localiser rapidement les attributs d'image dans le wikicode (pour par exemple, nettoyer la mise en page).

Par exemple :

<gallery>
File:Example.jpg|Item 1
File:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=An example image. It has flowers
File:Example.jpg|''italic caption''
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>

est formaté comme :

Le paramètre mode

Version de MediaWiki : 1.22

Depuis la version 1.22, un paramètre mode expérimental est disponible, qui dispose des options suivantes :

  • traditional est le type de galerie original utilisé par MediaWiki.
  • nolines est similaire à traditional, mais sans bordure.
  • packed implique des images de même hauteur mais avec des largeurs différentes, et séparées par de petite espaces. Les rangées dans ce mode adaptatif (responsive) s'organisent suivant la largeur de l'écran.
  • packed-overlay affiche la légende au-dessus de l'image, dans une boîte blanche semi-transparente.
  • packed-hover est similaire à packed-overlay, mais la légende et la boîte n'apparaîssent qu'avec le survol de la souris.
  • slideshow crée un diaporama avec les images.

Par exemple :

<gallery mode="packed-hover">
Image:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar)
Image:Salmonlarvakils.jpg|''[[commons:Salmo salar|Salmo salar]]'' (Salmon Larva)
Image:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper)
Image:Pterois volitans Manado-e.jpg|''[[commons:Pterois volitans|Pterois volitans]]'' (Red Lionfish)
Image:Macropodus opercularis - front (aka).jpg|''[[commons:Macropodus opercularis|Macropodus opercularis]]'' (Paradise fish)
Image:Canthigaster valentini 1.jpg|''[[commons:Canthigaster valentini|Canthigaster valentini]]'' (Valentinni's sharpnose puffer)
Image:Flughahn.jpg|[[Image:POTY ribbon 2007.svg|25px]] ''[[commons:Dactylopterus volitans|Dactylopterus volitans]]'' (Flying gurnard)
Image:Fishmarket 01.jpg|''[[commons:Semicossyphus pulcher|Semicossyphus pulcher]]'' (California Sheephead)
Image:Pseudorasbora parva(edited version).jpg|''[[commons:Category:Pseudorasbora parva|Pseudorasbora parva]]'' (Topmouth gudgeon)
Image:MC Rotfeuerfisch.jpg|''[[commons:Category:Pterois antennata|Pterois antennata]]'' (Antennata Lionfish)
Image:Cleaning station konan.jpg|''[[commons:Novaculichthys taeniourus|Novaculichthys taeniourus]]''
Image:Synchiropus splendidus 2 Luc Viatour.jpg|''[[commons:Synchiropus splendidus|Synchiropus splendidus]]'' (Mandarin fish)
File:Psetta maxima Luc Viatour.jpg|''[[commons:Psetta maxima|Psetta maxima]]'' (Turbot)
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]''
</gallery>

Qui donne (mode : packed-hover) :

Exemples des autres modes :

mode="traditional"

mode="nolines"

mode="packed"

mode="packed-overlay"

Version de MediaWiki : 1.28

mode="slideshow"


Attributs facultatifs pour la galerie

La balise galerie prend elle-même plusieurs paramètres additionnels, spécifiés comme des attributs de paires (clé, valeur) :

<gallery {parameters}>
{images}
</gallery>
  • caption="{caption}" : (le texte de la légende entre guillemets doubles pour plusieurs mots) définit une légende centrée en tête de la galerie. Seul le texte brut peut être utilisé dans la légende; le formatage, les modèles et autres ne fonctionneront pas
  • widths={width}px: définit la largeur (max) des images ; par défaut 120px (notez le pluriel : widths).
  • heights={heights}px : définit la hauteur (max) des images ; par défaut 120px (notez le pluriel : heights).
  • perrow={integer} : définit le nombre d'images par rangées. 0 signifie ajustement automatique basé sur la largeur de l'écran.
  • showfilename={anything} : affiche les noms des fichiers d'images dans les légendes individuelles de chaque image (1.17+).
  • mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow} : Voir la section ci-dessus (1.22+ ; 1.28+ pour « slideshow »).
  • showthumbnails: pour le mode «  diaporama » (slideshow) seulement, affiche par défaut la bande avec les vignettes des images sous le diaporama (1.29+).
Les paramètres de largeur et de hauteur sont davantage pris comme suggestion que comme valeurs strictes pour les modes packed (et leurs dérivés). Les modes packed ajusteront la largeur des images de sorte à rendre toutes les rangées de même largeur.

Exemple :

Le code :

<gallery widths=60px heights=60px perrow=7 caption="sunflowers are groovy">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

A pour résultat :


Rangées d'images qui s'adaptent à la largeur du navigateur

Une méthode qui fonctionne pour une rangée d'images avec différentes largeurs est de ne pas utiliser « thumb » ni « left » ni « none ». Si le mode vignette (« thumb ») n'est pas utilisé (et donc sans les légendes), une rangée d'images occupera la largeur du navigateur. Si nécessaire, réduire la fenêtre du navigateur pour voir les images s'enrouler à la rangée suivante.

[[File:Example.jpg|220px]]
[[File:Example.jpg|100px]]
[[File:Example.jpg|150px]]
[[File:Example.jpg|250px]]
[[File:Example.jpg|200px]]
[[File:Example.jpg|50px]]
[[File:Example.jpg|220px]]
[[File:Example.jpg|175px]]

Example.jpg Example.jpg Example.jpg Example.jpg Example.jpg Example.jpg Example.jpg Example.jpg

Pour justifier les images de largeur variable avec légendes, il est is nécessaire d'utiliser un <div> HTML avec une liste non ordonnée avec aussi style="display:inline-block;". Pour plus d'infos et d'idées voir : Give Floats the Flick in CSS Layouts (en anglais).

<div><ul> 
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
  • Caption 1
  • Caption 2
  • Caption 3
  • Caption 4
  • Caption 5
  • Caption 6
  • Caption 7
  • Caption 8

Certaines fermes de wikis n'ont pas toutes les options de galerie (telles que « widths »). En outre, quelque fois, un veut des largeurs variables pour les images d'une rangée. Hors de la galerie, ou du div HTML, il est impossible d'avoir des légendes individuelles pour les images d'une rangée qui occupe la largeur du navigateur. Testez et voyez. Il n'y a pas d'autre possibilité que d'utiliser le texte wiki correctement. Les images iront soit s'entasser sur la droite, ou provoquer l'apparition d'une barre de défilement horizontale.

L'utilisation en flottant à gauche (« left ») pour certaines images, combiné à « none » pour quelques-unes d'entre elles, ne fonctionne pas toujours non plus, surtout s'il y a en plus une barre latérale d'images à droite. Des choses bizarres se produisent. Pour les navigateurs ou les écrans dont la largeur est plus étroite, une image d'une rangée peut apparaître loin en bas sur la page après la fin de la barre d'images latérale droite.

Comportement des liens

Par défaut une image est liée à la page de description de son fichier. L'option « link= » modifie ce comportement pour créer un lien vers une autre page ou site web, ou pour désactiver le comportement de liaison de l'image.

Alternativement, vous pouvez créer un lien texte vers une page de description du fichier ou vers le fichier lui-même. Voir Help:Linking to files .

Afficher une image et la lier à une autre page ou site web

Utiliser l'option « link= » pour lier l'image à une autre page ou un site web :

Cliquer sur l'image ci-dessous vous dirigera vers MediaWiki :

[[File:Wiki.png|50px|link=MediaWiki]]

Wiki.png

Cliquer sur l'image ci-dessous vous dirigera vers « example.com » :

[[File:Wiki.png|50px|link=http://example.com]]

Wiki.png

Afficher une image sans lien

Utiliser l'option « link= » sans valeur attribuée, pour désactiver le lien; l'image ci-dessous n'a pas de lien :

[[File:Wiki.png|50px|link=]]

Wiki.png

Lien vers une image

Ajoutez : comme préfixe au lien que vous devez créer.

[[:File:Wiki.png]]

File:Wiki.png

[[:File:Wiki.png|Wiki]]

Wiki

Obtenir un lien direct vers une image

Pour obtenir un lien direct vers une image (en contournant la page de description de l'image), certains Mots magiques peuvent être utilisés.

{{filepath:Wiki.png}}

Devient :

//upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png

Dans le cas où cela est utilisé à partir d'un modèle où l'espace de noms File: doit être supprimé, {{PAGENAME}} peut le faire :

{{filepath:{{PAGENAME:File:Wiki.png}}}}

Devient :

//upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png

Pré-requis

Avant d'utiliser des images dans votre page, l'administrateur système de votre wiki doit avoir activé le téléversement de fichiers et un utilisateur doit téléverser le fichier de l'image. Les administrateurs système peuvent également définir le wiki pour accepter les fichiers de dépôts externes comme Wikimedia Commons. Pour le redimensionnement des images côté serveur il est nécessaire d'avoir une librairie graphique configurée (telle que GD2, ImageMagick, etc.).

Fichiers sur d'autres sites web

Vous pouvez lier vers un fichier externe disponible en ligne en utilisant la même syntaxe que celle des liens vers une page web externe. Avec ces syntaxes, l'image ne sera pas affichée, mais seulement le texte du lien correspondant sera affiché.

[http://url.for/some/image.png]

Ou avec un texte différent affiché :

[http://url.for/some/image.png texte du lien ici]

Les balises MediaWiki supplémentaires ou les mises en forme HTML/CSS (pour les éléments en ligne) sont autorisés dans ce texte affiché (à l'exception des liens intégrés qui pourraient casser le lien englobant) :

[http://www.example.com/some/image.png Exemple ici '''<del>riche</del>'''
''<ins>texte du lien</ins>'' .]

est interprété comme : Exemple ici riche texte du lien .

Si les utilisateurs ont le droit d'importer une image intégrée à partir d'une URL externe (voir Manuel:$wgAllowExternalImages ), vous pouvez aussi incorporer des images externes. Pour cela, insérez simplement l'URL de l'image :

http://url.for/some/image.png

Pour le moment, les images incorporées ne peuvent pas être redimensionnées, mais elles peuvent être formatées à l'aide de balises MediaWiki ou du code HTML/CSS.

Si cette option n'est pas activée, l'image ne sera pas incorporée mais affichée comme un lien textuel vers le site externe, juste comme précédemment.

Accès direct aux images

MediaWiki prend en charge l'accès au fichier via la page Special:Redirect/file, ou à l'aide d'une URL directe :

https://www.mediawiki.org/w/index.php?title=Special:Redirect/file/Wikipedia.png&width=100&height=100

A la fois la hauteur et la largeur sont facultatives. Les proportions de l'image sont toujours conservées.

Voir aussi