Help:Images/fr

Cette page explique la syntaxe des "images" lors de l'édition du wiki. Vous, ou un autre utilisateur doit habituellement téléverser une image avant que vous ne puissiez l'utiliser sur une page.

Les images stockées sur un serveur MediaWiki sont généralement accessibles en utilisant le préfixe  (l'ancien préfixe   est toujours utilisable en tant que synonyme) pour la cible d'un lien MediaWiki. Le préfixe alternatif  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).

Type d'image supporté
Les formats suivants sont supportés par défaut :


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

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):


 * .svg : image vectorielle 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.
 * .ogg, .oga, .ogv : Ogg multimedia (audio or video). Pas un format image, mais traité de la même manière. Souvent utilisé avec.
 * .pdf : documents multi-pages dans le Portable Document Format (initialement spécifié par Adobe). Souvent utilisé en conjonction avec.
 * .djvu : documents bitmap multipages dans le formatDejaVu (le plus souvent, scan de livre). Voir
 * Seule une page d'un 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.

Syntaxe
Pour afficher une image, voici la syntaxe complète:

ou "options" peut être vide ou bien est composé des éléments suivants, séparés par le symbole tube (pipe) "|"

Contrôle la façon dont l'image affichée est formatée et incluse dans le reste de la page.
 * Option du format : un des bordure et/ou sans cadre, avec cadre, miniature;
 * Option de redimensionement : un de
 * {width}px — Redimensionne l'image pour l'adapter dans la largeur maximale donnée en pixels, sans restreindre sa hauteur;
 * x{height}px — Redimensionne l'image pour l'adapter à une hauteur maximale donnée en pixels, sans restreindre sa largeur;
 * {width}x{height}px — Redimensionner l'image pour l'adapter à une largeur et une 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 taille est supérieure à la largeur).
 * Notez que l'image conserve toujours son ratio d'aspect, et ne peut être réduite (pas augmenté) de taille sauf si elle est dans un type de support extensible (images bitmap ne peuvent pas être étendus).
 * La taille maximale par défaut dépend du  format  et des dimensions de l'image interne (en fonction de son type de support).
 * Option Horizontal alignment : pami left (gauche), right (droite), center (centré), none (aucun);
 * Contrôle l'alignement horizontal (et en ligne / bloc ou styles flottants) de l'image dans un texte (pas de valeur par défaut).
 * Option Vertical alignment : parmi baseline (line de base), sub (sous), super, 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  'milieu' ).
 * Option Link: parmi
 * link={cible} — Permet de changer la cible (vers un titre de page arbitraire, ou une URL) du lien généré, activable pour l'affichage de l'image; à savoir, affichage  interprété comme Example.jpg (lien externe), ou   interprété comme Example.jpg (lien interne).
 * link= (valeur vide) —  Affiche une image sans aucun lien activable; à savoir   interprété comme Example.jpg.


 * ! pour MW 1.24 et inférieure : Si vous définissez  (vide), alors aucun   ne sera interprété. (Voir T23454.)
 * Autre option spécifiques :
 * alt={texte alternatif} — Définit le texte alternatif (attribut HTML   de l'élément d'une image  ) généré qui sera affiché soit si l'image référencée ne peut pas être téléchargé et/ou intégré, 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).
 * page={nombre} — Affiche le numéro de page spécifié (actuellement seulement applicable lors de l'affichage d'un fichier .djvu ou .pdf).
 * class={class html} — (MediaWiki 1.20+) Définit les classes (attribut HTML  de l'élément   généré).
 * lang={language code} — (MediaWiki 1.22+) Pour les fichier SVG contenant &lt;switch&gt; des instructions variables selon l'attribut langue système, sélectionne quelle langue pour afficher le fichier. La valeur par défaut est toujours l'anglais, même sur la non-anglais wikis.

Si un paramètre ne correspond à aucune de ces possibilités, il est interprété comme étant le texte de la légende de l'image. La légende s'affiche en dessous de l'image pour les formats "thumb" et "frame", pour les autres c'est une infobulle. Dans le cas "thumb" ou "frame", la légende peut contenir des liens wiki ou autre marques de formatage. Des options supplémentaires peuvent êtres disponibles selon les extensions MediaWiki installées.

Si l'option "alt" n'est pas renseignée, et qu'une légende est présente, le texte alternatif (le champ alt de l'élément HTML img) sera créé automatiquement à partir de la légende, avec les marques de formatage automatiquement supprimées.

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 (ie en orientation portrait plutôt que paysage) et vous trouvez qu'il est trop grand, vous pouvez essayer l'option, où N est l'image de rapport d'aspect (sa largeur divisée par sa hauteur, par défaut à 0,75). L'alternative est de spécifier la hauteur maximale souhaitée (en pixels) de manière explicite.

Notez qu'en écrivant, 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.

Dans les exemples ci-dessous, la taille originale de l'image est de 400 × 267 pixels. Une image avec  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  peut être réduite, mais ne peut pas être élargie au-delà de la taille originale de l'image.
 * Pour savoir comment il apparaît lorsque sa taille est pas spécifié, voir Format section ci-dessus.
 * Lorsque le format est pas spécifié, ou seulement, la taille peut être à la fois réduit et agrandi à toutes les tailles spécifiées.

Alignement horizontal
Notez qu'utilisé les formats  ou , l'alignement horizontal par défaut sera.

Alignement vertical
Les options de l'alignement verticales entrent seulement en vigueur si l'image  est  a rendu comme un élément de l'inline et  n'est pas  flotter. Ils modifient la façon dont l'image en ligne sera alignée verticalement avec le présent texte dans le même bloc avant et / ou après cette image sur la même ligne affichée.

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



Pour afficher le résultat d'alignement plus clairement, les  de 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: text

 text text-top: text

 text super: text

 text baseline: text

 text sub: text

 text default: text

 text middle: text

 text text-bottom: text

 text bottom: text

Notes:

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 qui 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 le "text-top" et positions "text-bottom»; la hauteur de la police exclut: 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é par augmentation de la marge supérieure et / ou inférieure de telle sorte que l'image peut s'adapter et aligner correctement, et toutes les images (y compris de petites hauteurs) soient centrées verticalement sur la position médiane ajustée (pour calculer la hauteur de ligne effective, le texte de chaque rangée affiché avec la hauteur de police la plus grande sera considéré). Les positions des décoration 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.
 * 1) * l'espacement inter-lignes 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 police).
 * 2) * l'espacement inter-lignes supplémentaire qui peut être ajouté par superscript et subscript.
 * 1) Les positions d'alignement "text-top" et "text-bottom" exclut également l'espacement supplémentaire de ligne ajoutée par les exposants et indices, mais pas l'espacement supplémentaire défini par la hauteur de ligne.
 * 2) Les positions d'alignement "top" et "bottom" prennent en compte tous les espacements supplémentaires de ligne (y compris les indices supérieurs et, si elles sont présentes dans un  ). Lorsque l'alignement d'images contraint l'image à croître au-dessus ou en dessous du seuil d'espacement normal, et l'image n'est pas en position absolue, l'image provoque l'ajustement des positions "top" et «bottom» (tout comme les exposants et indices), de sorte que la hauteur effective de l'interligne sera plus grande..

Stopping the text flow
On occasion it is desirable to stop text (or other inline non-floating images) from flowing around a floating image. Depending on the web browser's screen resolution and such, text flow on the right side of an image may cause a section header (for instance, == My Header == ) to appear to the right of the image, instead of below it, as a user may expect. The text flow can be stopped by placing   (or if you prefer,  ) before the text that should start below the floating image. (This may also be done without an empty line by wrapping the section with the floating images with …, which clears all floats inside the   element.)

All images rendered as blocks (including non-floating centered images, left- or right-floating images, as well as framed or thumbnailed floating images) are implicitly breaking the surrounding lines of text (terminating the current block of text before the image, and creating a new paragraph for the text after them). They will then stack vertically along their left or right alignment margin (or along the center line between these margins for centered images).

Altering the default link target
The following table shows how to alter the link target (whose default is the image description page) or how to remove it. Changing the link does not alter the format described in the previous sections.

Warning:
 * The licencing requirements on your wiki may not allow you to remove all links to the description page that displays the required authors attributions, the copyrights statements, the applicable licencing terms, or a more complete description of the rendered image (including its history of modifications).
 * If you change or remove the target link of an image, you will then have to provide somewhere else on your page an explicit link to this description page, or to display the copyright and author statement and a link to the applicable licence, if they are different from the elements applicable to the embedding page itself.
 * Your wiki policy may restrict the use of the alternate link parameter, or may even enforce a prohibition of alternate link parameters for embedded media files (in which case, the link parameter will be ignored), or may only accept them after validation by authorized users or administrators.

Gallery syntax
It's easy to make a gallery of thumbnails with the  tag. The syntax is:

Mode paramètre
Starting in 1.22 we have an experimental  parameter, taking options as follows:


 * is the original gallery type used by MediaWiki.
 * is similar to, but with no border lines.
 * causes images to have the same height but different widths, with little space between the images. The rows in this responsive mode organize themselves according to the width of the screen.
 * shows the caption overlaid on the image, in a semi-transparent white box.
 * is similar to, but with the caption and box only showing up on hover.
 * creates a slideshow, with thumbnails.

Par exemple:

Gives (mode: packed-hover):

Attribue optionnel pour la galerie
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:

Row of images that will wrap to browser width
One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. If necessary, narrow the browser window to see the images wrap to the next row.





To wrap images of varying widths with captions it is necessary to use div HTML for an unordered list. Along with. For more info and ideas see: Give Floats the Flick in CSS Layouts.

      </li>  </li>  </li>  </li>  </li>  </li> </ul>

Some wiki farms do not have all gallery options (such as "widths"). Also, sometimes one wants varying widths for images in a row. Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar.

Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. Weird things will occur. At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images.

Link behavior
By default an image links to its file description page. The "link=" option modifies this behavior to link to another page or website, or to turn off the image's linking behavior.

Alternatively, you can create a text link to a file description page or to the file itself. See.

Display image, link it to another page or website
Use "link=" option to link image to another page or website:

Clicking on the below image will take you to MediaWiki:





Clicking on the below image will take you to example.com:





Display image, turn off link
Use "link=" option with no value assigned to turn link off entirely; the below image is not a link:





Requisites
Before using images in your page, the system administrator of your wiki must have enabled file uploads and a user has to upload the file. System administrators may also set the wiki to accept files from foreign repositories, such as the Wikimedia Commons. For server side image resizing it is necessary to have a scaler configured (such as GD2, ImageMagick, etc.).

Files at other websites
You can link to an external file available online using the same syntax used for linking to an external web page. With these syntaxes, the image will not be rendered, but only the text of the link to this image will be displayed.



Or with a different displayed text:

link text here

Additional MediaWiki markup or HTML/CSS formatting (for inline elements) is permitted in this displayed text (with the exception of embedded links that would break the surrounding link): Example  rich   link text  here. which renders as: Example  rich   link text  here.

If it is enabled on your wiki (see ), you can also embed external images. To do that, simply insert the image's url: http://url.for/some/image.png Currently, embedded images cannot be resized, but they may be formatted by surrounding MediaWiki markup or HTML/CSS code.

If this wiki option is not enabled, the image will not be embedded but rendered as a textual link to the external site, just like above.