Extension:ImageMap/fr

L'extension 'ImageMap permet de cliquer sur image maps. Une image interactive est une liste de coordonnées dans une image spécifique, qui relie des zones de l'image à plusieurs destinations (contrairement à un lien d'image normal, dans lequel la totalité de la zone de l'image est liée à une seule destination). Par exemple, sur une carte du monde, chaque pays peut être relié par un hyperlien à d'autres informations sur ce pays. L'objectif d'une image interactive est de fournir un moyen facile de lier différentes parties d'une image sans diviser l'image en fichiers image séparés.

Exemple simple sans légendə
L'exemple ci-dessus renvoie toujours à la Page principale, peu importe où vous cliquez dessus. Pour en savoir plus sur l'image, cliquez sur l'icône bleue "i". Une autre façon de créer une telle image liée, sans utiliser cette extension, serait avec 150px|alt=Alt text|title=Aller à la page principale|link=Page principale

Exemple complexe avec légendə
L'exemple ci-dessus renvoie à de nombreuses pages différentes, selon l'endroit où vous cliquez dessus. Pour en savoir plus sur l'image, cliquez sur l'icône double rectangle .

Description de la syntaxe
The contents of an tag consists of blank lines, comments (starting with #) and logical lines. La première ligne logique spécifie l'image à afficher. This must be in the same format as an ordinary MediaWiki image link (see Images help), except without the enclosing  and   markup. If the first line specifies a " " or " " image, then the first line's caption and any alt parameter are treated as the image's caption and alt text in the usual way; otherwise, the first line's alt parameter (or, if absent, any caption) specifies the image's alt text. Dans aucun des cas, l'image elle-même n'a de texte de titre (souvent utilisé pour les info-bulles) ; tout texte de titre est tiré des régions décrites dans les lignes suivantes.

D'autres lignes sont divisées en jetons, séparés par des espaces. La fonction de chaque ligne est déterminée par le premier jeton de la ligne.

Une coordonnée se compose de deux jetons. Le premier jeton est la position horizontale (X) et le second est la position verticale (Y). Toutes les coordonnées sont en fonction de l'image pleine taille, pas de l'image visible. Les jetons X et Y doivent être spécifiés comme étant la distance du bord gauche (nombre de pixels horizontaux) et la distance du haut (nombre de pixels verticaux) de l'image pleine grandeur.


 * desc
 * Spécifie l'emplacement d'une icône "i" bleue [[Image:Desc-20.png|link=|alt=]], qui renvoie à la description de l'image. Valeurs possibles :,   (par défaut),  ,  ,  . Ce paramètre est ignoré pour les images " " ou " ", qui utilisent plutôt l'icône double rectangle habituelle [[Image:Magnify-clip.png|link=|alt=]].


 * poly
 * Un polygone. Les coordonnées des sommets sont indiquées, suivies d'un lien entre crochets.


 * rect
 * Un rectangle. Les paramètres sont les coordonnées des coins supérieur gauche et inférieur droit, suivis d'un titre à lier entre crochets.
 * Exemple


 * circle
 * Un cercle. Les deux premiers paramètres sont les coordonnées du centre, le troisième est le rayon. Les coordonnées sont suivies d'un lien entre crochets.


 * default
 * Cela donne le lien par défaut, où aucune autre région n'est spécifiée.

Toutes les coordonnées sont spécifiées par rapport à l'image source. L'image peut être mise à l'échelle à l'aide de la syntaxe des vignettes, auquel cas les coordonnées de l'image seront mises à l'échelle automatiquement.

All links are given in either the form Page title or description. Dans ce dernier cas, la partie après le caractere pipe "|" devient l'attribut de titre du lien - dans la plupart des navigateurs, il apparaîtra sous forme d'info-bulle lorsque l'utilisateur le survolera ; la partie après le pipe devient également le texte alternatif du lien. Si aucune description de lien explicite n'est donnée, le titre de la page est utilisé.

Les zones qui se chevauchent donnent la priorité au premier lien répertorié.

Installation
Make sure that uploads and ImageMagick are installed:


 * Troubleshooting
 * 1) Check to see if your php DOM is turned on. You may need to install it if it is not.
 * 2) Check whether  is installed, since this extension relies on /usr/bin/convert for the resizing. If it is not present, you could get a page with only XML errors (tip: use the back-button in the browser, because you can still edit the page).
 * 3) On OVH mutualized hosting $wgUseImageMagick should be like:

Composer
You can also install this extension using built-in Composer support.

composer require mediawiki/image-map @dev

Utilisation avec des modèles, des mots magiques ou des fonctions d'analyse. If you want this extension (as with most tag extensions) to parse template parameters, magic words, or parser functions, you will need to use #tag syntax, such as w:Template:Click did. In this case the vertical bar  must be replaced by a template , where the source text of the template is   (except when they appear inside links or parameters).


 * Example - standard form:


 * Example - with variable :


 * Example – Modified to accept an input parameter to control image size:

These modifications allow the template size to be adjusted on the edited (target) page and eliminate the need to create duplicate templates of various image sizes.

Where is the input parameter “1” and a default image size of 640px. Note: the input parameter requires a text string ending with “px” to function properly. For example, calling a template will display the template at 400 pixels.

 To convert the standard (existing) image maps to this optional format: 
 * Replace the initial  with   (the trailing braces).

Voir aussi

 * Instructions
 * A simple guide on how to use the Image Map editor with the ImageMap extension can be found at ImageMapEdit Howto on meta.
 * A detailed guide for using the maschek image map editor can be found at this site.
 * Wikimedia Commons also has a resource page on image maps: c:Commons:Image_map_resources
 * Existing image maps examples: w:Category:Wikipedia image maps


 * Wiki tools
 * meta:User:Dapete/ImageMapEdit - ImageMapEdit script, a graphical tool to determine the coordinates that can be installed on any wiki.


 * Online tools
 * http://www.maschek.hu/imagemap/imgmap Online image map editor, supports all shapes, Extension:ImageMap compatible.
 * http://www.image-maps.com/index.php? Basic on-line image mapper.
 * http://summerstyle.github.io/summer/ - Open-source interactive online image mapper


 * Similar functionalities
 * - working with diagrams and drawings