Extension:ImageMap

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:ImageMap and the translation is 100% complete.
Cette extension est fournie avec MediaWiki 1.21 et supérieur. Ainsi vous n'avez pas besoin de la télécharger à nouveau. Néanmoins, vous devez encore suivre les autres instructions fournies.
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
ImageMap
État de la version : stable
Implémentation Balise
Description Autorise les images HTML cliquables
Auteur(s) Tim Starlingdiscussion
Dernière version mises à jour continues
MediaWiki 1.23+
PHP 5.4+
Composer mediawiki/image-map
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement
log
Exemple Children's encyclopedia
Traduire l’extension ImageMap sur translatewiki.net si elle y est disponible

Vérifier la matrice des utilisations et des versions.

Problèmes Tâches ouvertes · Signaler un bogue

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.

Exemples

Exemple simple sans légendə

<imagemap>
File:Example2.png|150px|alt=Alt text
default [[Main Page|Go to main page]]
</imagemap>
Alt text

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 <syntaxemphasis lang="text" inline>Alt text</syntaxemphasis>

Exemple complexe avec légendə

This example display a thumbnail with dimensions (width × height) 500 × 250 pixels; the original image has dimensions 9,600 × 4,800 pixels. The coordinates of each vertex are given in pixels and represent a point on the original image. So for example, the vertices of the polygon surrounding "Jude" (second to the far right in the image) has horizontal-coordinates (measured in pixels from the left) ranging between 79048635 and vertical-coordinates (measured in pixels from the top) ranging between 20963260, which are far outside of the range of the displayed 500 × 250 thumbnail but within range of the 9,600 × 4,800 original image. Note that one vertex of the polygon surrounding "Simon" (at the very right of the image), specifically the vertex with coordinate 9625 3301, lies outside of the bounds of the original 9,600 × 4,800 image.

<imagemap>
Image:The Last Supper - Leonardo Da Vinci - High Resolution 32x16.jpg|thumb|center|500px|alt=''The Last Supper'' by Leonardo da Vinci - Clickable Image|Image map example. Clicking on a person in the picture causes the browser to load the appropriate article.

poly 550 2550 750 2400 1150 2300 1150 2150 1200 2075 1500 2125 1525 2300 1350 2800 1450 3000 1700 3300 1300 3475 650 3500 550 3300 450 3000 [[w:Bartholomew the Apostle|Bartholomew]] 
poly 1575 2300 1625 2150 1900 2150 1925 2500 1875 2600 1800 2750 1600 3250 1425 3100 1400 2800 1375 2600 [[w:James, son of Alphaeus|James Minor]]
poly 1960 2150 2200 2150 2350 2500 2450 2575 2375 2725 2375 2900 2225 3100 2225 3225 1600 3225 1825 2700 1975 2450 1925 2300 [[w:Saint Andrew|Andrew]]
poly 2450 2575 2775 2500 2700 2650 2800 2700 2600 3000 2600 3250 2300 3250 2200 3200 2300 3000 [[w:Saint Peter|Peter]]
poly 2750 2500 2950 2400 3125 2600 3175 2700 3300 2850 3700 3200 3750 3200 3650 3350 3400 3200 3000 3350 2600 3325 2750 2800 2900 2700 2700 2650 [[w:Judas Iscariot|Judas]]
poly 3000 2350 3300 2350 3350 2660 3560 2600 3565 2690 3250 2800 3125 2575 [[w:Saint Peter|Peter]]                                     
poly 3332 2338 3528 2240 4284 3024 4074 3332 3864 3290 3780 3150 3668 3192 3598 3024 3374 2870 3388 2772 3542 2800 3668 2702 3542 2590 3430 2604 3350 2600 3300 2500[[w:John the Apostle|John]]
poly 4775 2184 4915 2128 5055 2212 5083 2352 5111 2464 5181 2604 5307 2744 5573 3052 5615 3192 5657 3290 5573 3402 5461 3332 5335 3248 4495 3248 4439 3388 4243 3388 4075 3360 4173 3136 4327 3010 4509 2730 4663 2520 4733 2394 [[w:Jesus]]
poly 5900 2100 5900 2150 5800 2400 5800 2500 5675 2589 5480 2671 5438 2507 5425 2301 5589 2452 5630 2301 5650 2100 [[w:Thomas the Apostle|Thomas]]
poly 5918 2150 6041 2109 6137 2246 6192 2411 6110 2589 6110 2726 6192 2822 6302 2740 6589 3109 5658 3178 5575 2918 5300 2698 5233 2589 5274 2438 5370 2507 5521 2685 5617 2671 5712 2575 5822 2507 5808 2287 5822 2175 [[w:James, son of Zebedee|James Greater]]
poly 6137 2013 6439 2013 6863 2260 7110 2515 6726 2675 6507 2548 6425 2630 6356 2753 6548 2849 6699 2781 7082 2794 7178 3109 6699 3178 6548 2986 6397 2835 6165 2775 6110 2589 6233 2438 6302 2383 6151 2287 6096 2164 [[w:Philip the Apostle|Philip]]
poly 7635 2123 7800 2013 8000 2055 8025 2287 7950 2438 8000 2698 8055 2918 7959 3164 7233 3164 7124 2972 7124 2794 6548 2794 6384 2781 6384 2671 6493 2575 6750 2650 7075 2550 7219 2400 7625 2300 [[w:Matthew the Apostle|Matthew]]
poly 8325 2096 8600 2109 8635 2493 8615 2726 8439 2781 8274 2740 8125 2835 8151 2931 8400 2975 8411 3068 8589 3041 8617 3205 7987 3260 8124 3027 7987 2644 7904 2493 7959 2425 8096 2356 [[w:Judas Thaddaeus|Jude]]
poly 8800 2150 8900 2125 9055 2150 9125 2397 9400 2475 9550 2931 9625 3301 9151 3397 8535 3219 8726 3014 8466 3068 8411 2918 8178 2931 8124 2835 8329 2753 8535 2794 8726 2603 8725 2342 [[w:Simon the Zealot|Simon]]
</imagemap>
The Last Supper by Leonardo da Vinci - Clickable ImageBartholomewJames MinorAndrewPeterJudasPeterJohnw:JesusThomasJames GreaterPhilipMatthewJudeSimon
Image map example. Clicking on a person in the picture causes the browser to load the appropriate article.

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 ‎<imagemap> 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 "thumb" or "frame" 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 , qui renvoie à la description de l'image. Valeurs possibles : top-right, bottom-right (par défaut), bottom-left, top-left, none. Ce paramètre est ignoré pour les images "thumb" ou "frame", qui utilisent plutôt l'icône double rectangle habituelle .
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
<imagemap>
Image:PolierMartinWombwellZoffany.jpg|thumb|200px|Colonel Antoine Polier
rect 269 140 344 305 [[Claude Martin]]
rect 124 147 181 298 [[Antoine Polier|Antoine-Louis Polier]]
desc none
</imagemap>
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 [[Page title|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

This extension is bundled with MediaWiki 1.21 and above. Thus you do not have to download it again.

Assurez-vous que les téléchargements et ImageMagick sont installés:

$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
  • Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé ImageMap dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'ImageMap' );
    
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Pour les utilisateurs de MediaWiki 1.24 ou précédents :

Les instructions ci-dessus décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension(). Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.24 ou antérieur), à la place de wfLoadExtension( 'ImageMap' );, vous devez utiliser :

require_once "$IP/extensions/ImageMap/ImageMap.php";
Dépannage
  1. Vérifiez si votre DOM php est activé. Vous devrez peut-être l’installer si ce n’est pas le cas.
  2. Check whether ImageMagick 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. Sur OVH hébergement mutualisé $wgUseImageMagick devrait être commeː $wgUseImageMagick=false;

Composer

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

composer require mediawiki/image-map @dev
Utiliser Composer pour installer cette extension provoquera l’installation de la dernière version de développement de cette extension chaque fois que vous faites une commande "composer update --no-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. Dans ce cas, la barre verticale | doit être remplacée par un modèle {{!}}, où le texte source du modèle est | (sauf quand ils apparaissent dans les liens ou les paramètres).

Exemple - formulaire standard
<imagemap>
Image:ExamplePlant80.png|60px|ExamplePlant
rect 0 107 294 260 [[Plants/ExamplePlant|ExamplePlant]]
desc none
</imagemap>
Example - with variable {{PAGENAME}}
{{#tag:imagemap|
Image:ExamplePlant80.png{{!}}60px{{!}}ExamplePlant
rect 0 107 294 260 [[{{PAGENAME}}/ExamplePlant|ExamplePlant]]
desc none
}}
Exemple – Modification pour accepter un paramètre d’entrée pour contrôler la taille de l’image

Ces modifications permettent d’ajuster la taille du modèle sur la page modifiée (cible) et d’éliminer la nécessité de créer des modèles en double de différentes tailles d’images.

{{#tag:imagemap|
Image:Examplename.jpg {{!}}{{{1|640px}}}
rect 0 107 294 260
circle 360 114 70
poly 357 216 363 417 211
desc none
}}

Where {{{1|640px}}} 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 {{TemplateName|400px}} will display the template at 400 pixels.

Pour convertir les cartes d’images standard (existantes) dans ce format facultatif:

  • Replace the initial ‎<imagemap> with {{#tag:imagemap|
  • Add {{!}}{{{1|640px}}} after the image name (change the default image size to match the currently existing size).
Note:By changing the default size (640px in this example) to the current image size, none of the existing template calls will have to be modified and will display correctly. Existing template calls can still be modified later by using the input parameter.
  • Replace the final ‎</imagemap> with }} (the trailing braces).

Voir aussi

Instructions
Outils Wiki
Outils en ligne
Fonctionnalités similaires