Difference between revisions of "Template:ImageMap"

[unchecked revision] [quality revision]
m
m

1 Usage[edit]

The ImageMap template is used to enhance images with dynamic contents (explanations and links) using image maps (aka "clickable images"). An image map is a list of coordinates in an image, that links areas of the image to multiple destinations. In the STM32 MPU wiki, the image maps rely on:

Usage:  {{ImageMap | File:<filename>.<extension> {{!}} <options> {{!}} <caption>
        <list of coordinates> <list of explanations and links>
        }}

Where:

  • <filename>, <extension>, <options> and <caption> are defined in the images help page
  • <list of coordinates> are the coordinates of forms (rectangles, circles...) in the image
  • <list of explanations and links> are the explanations and links associated with these forms

2 Basic examples[edit]

Example of image map
You type
{{ImageMap | File:Image_map_example.png {{!}}thumb frame {{!}} center {{!}} Add your text legend here
rect 160 2 248 77 [https://www.st.com/content/st_com/en.html StepRectangle 1 (rectangle example): external link to STMicroelectronics website]
poly 292 228 312 187 387 188 407 229 386 271 313 269 292 228 [[Contributors:Fake article | Step 2 (Polygon example): internal link to "Fake article"]]
circle 47 225 44 [[#Fake anchor | StepCircle 3 (circle example): no link (fake anchor) just an explanation about this area]]
poly 87 155 129 105 120 96 160 93 162 130 152 125 108 180 83 159 83 160 [[Contributors:Fake article | ArrowsPolygons (multiple polygons example): internal link to "Fake article"]]
poly 137 225 162 199 163 212 253 212 252 243 163 242 163 253 137 225 [[Contributors:Fake article | ArrowsPolygons (multiple polygons example): internal link to "Fake article"]]
poly 261 110 300 162 294 167 290 168 330 176 334 140 334 137 325 144 283 88 259 106 [[Contributors:Fake article | ArrowsPolygons (multiple polygons example): internal link to "Fake article"]]
}}
You get
Rectangle example: external link to STMicroelectronics Polygon example: internal link to "Fake article" Circle example: an explanation about this area Polygons example: internal link to "Fake article" Polygons example: internal link to "Fake article" Polygons example: internal link to "Fake article"
Add your text legend here
Info white.png Information
  • Areas which overlap give precedence to the first link listed: this gives the possibilities to create links on boxes that are drawn inside a bigger one, declaring the biggest box at the end of the list
  • Do not use <br>, but <br/> in image maps

3 References[edit]

4 Code[edit]

Error: Must specify an image in the first line.

<noinclude>

==Usage==
The [[Template:ImageMap|ImageMap]] template is used '''to enhance images with dynamic contents''' (explanations and links) using '''image maps''' (aka "clickable images").  An image map is a list of coordinates in an image, that links areas of the image to multiple destinations. In the STM32 MPU wiki, the image maps rely on:
* the MediaWiki ImageMap extension<ref>[https://www.mediawiki.org/wiki/Extension:ImageMap MediaWiki Extension:ImageMap]</ref>

* the [[MediaWiki:Imagemap-Highlight.js]] script

 Usage:  <nowiki>{{</nowiki>ImageMap | File:{{HighlightParam|<filename>}}.{{HighlightParam|<extension>}} <nowiki>{{</nowiki>!}} {{HighlightParam|<options>}} <nowiki>{{</nowiki>!}} {{HighlightParam|&lt;caption>}}
         {{HighlightParam|<list of coordinates>}} {{HighlightParam|<list of explanations and links>}}
         }}
Where:
* {{HighlightParam|<filename>}}, {{HighlightParam|<extension>}}, {{HighlightParam|<options>}} and {{HighlightParam|&lt;caption>}} are defined in the [[Contributors:Images|images help]] page
*  {{HighlightParam|<list of coordinates>}} are the coordinates of forms (rectangles, circles...) in the image
*  {{HighlightParam|<list of explanations and links>}} are the explanations and links associated with these forms

==Basic examples==
{| class="st-table"
|+ Example of image map
! scope="row"| You type
| <pre style="white-space: pre-wrap">

{{ImageMap | File:Image_map_example.png{{!}}thumb{{!}}center{{!}} {{!}} frame {{!}} center {{!}} Add your text legend here
rect 160 2 248 77 [https://www.st.com/content/st_com/en.html Step 1 (rectangle example)Rectangle example: external link to STMicroelectronics website]
poly 292 228 312 187 387 188 407 229 386 271 313 269 292 228 [[Contributors:Fake article | Step 2 (Polygon example): internal link to "Fake article"]]
circle 47 225 44 [[#Fake anchor | Step 3 (circle example): no link (fake anchor) just Circle example: an explanation about this area]]
poly 87 155 129 105 120 96 160 93 162 130 152 125 108 180 83 159 83 160 [[Contributors:Fake article | Arrows (multiple polygons example)Polygons example: internal link to "Fake article"]]
poly 137 225 162 199 163 212 253 212 252 243 163 242 163 253 137 225 [[Contributors:Fake article | Arrows (multiple polygons example)Polygons example: internal link to "Fake article"]]
poly 261 110 300 162 294 167 290 168 330 176 334 140 334 137 325 144 283 88 259 106 [[Contributors:Fake article | Arrows (multiple polygons example)Polygons example: internal link to "Fake article"]]
}}</pre>

|-
! scope="row"| You get
|
{{ImageMap | File:Image_map_example.png {{!}} frame {{!}} center {{!}} Add your text legend here
rect 160 2 248 77 [https://www.st.com/content/st_com/en.html Rectangle example: external link to STMicroelectronics website]
poly 292 228 312 187 387 188 407 229 386 271 313 269 292 228 [[Contributors:Fake article | Polygon example: internal link to "Fake article"]]
circle 47 225 44 [[#Fake anchor | Circle example: an explanation about this area]]
poly 87 155 129 105 120 96 160 93 162 130 152 125 108 180 83 159 83 160 [[Contributors:Fake article | Polygons example: internal link to "Fake article"]]
poly 137 225 162 199 163 212 253 212 252 243 163 242 163 253 137 225 [[Contributors:Fake article | Polygons example: internal link to "Fake article"]]
poly 261 110 300 162 294 167 290 168 330 176 334 140 334 137 325 144 283 88 259 106 [[Contributors:Fake article | Polygons example: internal link to "Fake article"]]
}}
|}

{{Info|
* Areas which overlap give precedence to the first link listed: this gives the possibilities to create links on boxes that are drawn inside a bigger one, declaring the biggest box at the end of the list
* Do not use <code><nowiki><br></nowiki></code>, but <code><nowiki><br/></nowiki></code> in image maps
}}

==References==<references />


==Code==</noinclude>
<div class="imageMapHighlighter">

{{#tag:imagemap|
{{{1}}}
desc none
}}</div>
Line 18: Line 18:
 
! scope="row"| You type
 
! scope="row"| You type
 
| <pre style="white-space: pre-wrap">
 
| <pre style="white-space: pre-wrap">
{{ImageMap | File:Image_map_example.png{{!}}thumb{{!}}center{{!}}Add your text legend here
+
{{ImageMap | File:Image_map_example.png {{!}} frame {{!}} center {{!}} Add your text legend here
rect 160 2 248 77 [https://www.st.com/content/st_com/en.html Step 1 (rectangle example): external link to STMicroelectronics website]
+
rect 160 2 248 77 [https://www.st.com/content/st_com/en.html Rectangle example: external link to STMicroelectronics]
poly 292 228 312 187 387 188 407 229 386 271 313 269 292 228 [[Contributors:Fake article | Step 2 (Polygon example): internal link to "Fake article"]]
+
poly 292 228 312 187 387 188 407 229 386 271 313 269 292 228 [[Contributors:Fake article | Polygon example: internal link to "Fake article"]]
circle 47 225 44 [[#Fake anchor | Step 3 (circle example): no link (fake anchor) just an explanation about this area]]
+
circle 47 225 44 [[#Fake anchor | Circle example: an explanation about this area]]
poly 87 155 129 105 120 96 160 93 162 130 152 125 108 180 83 159 83 160 [[Contributors:Fake article | Arrows (multiple polygons example): internal link to "Fake article"]]
+
poly 87 155 129 105 120 96 160 93 162 130 152 125 108 180 83 159 83 160 [[Contributors:Fake article | Polygons example: internal link to "Fake article"]]
poly 137 225 162 199 163 212 253 212 252 243 163 242 163 253 137 225 [[Contributors:Fake article | Arrows (multiple polygons example): internal link to "Fake article"]]
+
poly 137 225 162 199 163 212 253 212 252 243 163 242 163 253 137 225 [[Contributors:Fake article | Polygons example: internal link to "Fake article"]]
poly 261 110 300 162 294 167 290 168 330 176 334 140 334 137 325 144 283 88 259 106 [[Contributors:Fake article | Arrows (multiple polygons example): internal link to "Fake article"]]
+
poly 261 110 300 162 294 167 290 168 330 176 334 140 334 137 325 144 283 88 259 106 [[Contributors:Fake article | Polygons example: internal link to "Fake article"]]
 
}}
 
}}
 
</pre>
 
</pre>
Line 31: Line 31:
 
|
 
|
 
{{ImageMap | File:Image_map_example.png {{!}} frame {{!}} center {{!}} Add your text legend here
 
{{ImageMap | File:Image_map_example.png {{!}} frame {{!}} center {{!}} Add your text legend here
rect 160 2 248 77 [https://www.st.com/content/st_com/en.html Rectangle example: external link to STMicroelectronics website]
+
rect 160 2 248 77 [https://www.st.com/content/st_com/en.html Rectangle example: external link to STMicroelectronics]
 
poly 292 228 312 187 387 188 407 229 386 271 313 269 292 228 [[Contributors:Fake article | Polygon example: internal link to "Fake article"]]
 
poly 292 228 312 187 387 188 407 229 386 271 313 269 292 228 [[Contributors:Fake article | Polygon example: internal link to "Fake article"]]
 
circle 47 225 44 [[#Fake anchor | Circle example: an explanation about this area]]
 
circle 47 225 44 [[#Fake anchor | Circle example: an explanation about this area]]