View source for Module:Location map/data/100x100/doc

<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
This map definition, '''Template:Location_map_100x100''', is intended for overlaying markers/labels on any specified image, using map coordinates ranging from 0-100.0 for [[latitude]] or [[longitude]]. See the technical design below, under: [[#Design issues]].<br/>
Some of the related mapping procedures are:

* [[Template:Location map]] - places a marker symbol/label on an image;
* [[Template:Location map+]] - places multiple marker symbols/labels on an image;

All mapping templates use similar parameters (see ''[[#Examples|Examples]]''):
<div style="font-family: monospace;">
:* 100x100 - the first parameter is always the map name
:* AlternativeMap - name of image (omit "Image:")
:* caption=text - caption text along bottom of image
:* width=250 - for image width (omit "px" or image will span page)
:* label - movable label (can be padded "&amp;nbsp;XX&amp;nbsp;YY&amp;nbsp;")
:* label_size - percent from 0-200 (default: 95)
:* background - color of label (such as: darkorange or #4499DD)
:* position=right - (or left, top, bottom) position of label at marker
:* lat =55.00 - for latitude 0-100.0 (higher towards top)
:* long=45.00 - for longitude 0-100.0 (higher towards right)
:* mark &nbsp; &nbsp; - name of image for marker symbol (omit "Image:")
:* marksize - size of image for marker symbol (default: 8px, 1px=none)
:* float=right (or left, center) - position of map formatted on page
</div>
Some common label background colors are: <small>#</small>CCCC55 for <span style="color:#CCCC55">'''dim yellow'''</span>,
::* <small>#</small>44EE44 for <span style="color:#44EE44">'''lime green'''</span>, <small>#</small>BBBBBB for <span style="color:#BBBBBB">'''gray'''</span>,
::* <small>#</small>44CCDD for <span style="color:#44CCDD">'''light aqua'''</span>, <small>#</small>DDDDDD for <span style="color:#DDDDDD">'''light gray'''</span> (almost white),
::* PaleGreen for <span style="color:PaleGreen">'''pale green'''</span>, <span style="color:PaleTurquoise">'''PaleTurquoise'''</span>, <span style="color:DarkOrange">'''DarkOrange'''</span>, etc.
::* By default, the label is ''transparent'' overwriting the image.
For small lettering use label_size=80, for tiny words use 55. Note that the words in the label will wrap unless using "nbsp": <small>DO&amp;nbsp;NOT&amp;nbsp;WRAP</small>.

When specifying image "width=270" be sure to ''OMIT'' "px" (which causes the image to span the width of the screen) because "px" cannot (yet) be detected by the (new) MediaWiki language which processes those mapping templates.

See each specific mapping template for other parameters to pass.

==Examples==
{{Location map | 100x100
| <!--AlternativeMap= --><!--name of image (omit "Image:")-->
| caption = Example on blank image
| width=250 <!--omit "px" or image will span page-->
| label=You are Here
| label_size=90
| background = #DDDD44
| position=bottom <!--or left/right/top -->
| lat  = 55.00  <!--latitude 0-100.0 -->
| long = 22.35  <!--longitude 0-100.0-->
| mark=Green_pog.svg <!--image for marker (omit "Image:")-->
| marksize=10 <!--marker size (default: 8px, 1px=none)-->
| float=right <!--(or left, center) - position of map-->
}}
<div style="font-family: monospace;"><!--indent next line by 1 space to trigger quote-box -->
 <nowiki>{{</nowiki>Location map | 100x100
 | caption = Example on blank image
 | width=250 <!--omit "px"-->
 | label=You are Here
 | label-size=90
 | background = #DDDD44
 | position=bottom <!--or left/right/top -->
 | lat  = 55.00  <!--latitude 0-100.0 -->
 | long = 22.35  <!--longitude 0-100.0-->
 | mark=Green_pog.svg <!--marker (omit "Image:")-->
 | marksize=10 <!--default: 8px, 1px=none-->
 | float=right <!--left/center-->
 }}
</div>

{{Location_map | 100x100
| AlternativeMap = Gold_star_on_blue.gif
| caption = Marker on star
| width=110 <!--omit "px" or image will span page-->
| label=Dot
| label_size=80
| background = #CCCCCC
| position=left <!--or left/right/top -->
| lat  = 81.00  <!--latitude 0-100.0 -->
| long = 42.90  <!--longitude 0-100.0-->
| mark=Red_pog.svg <!--image for marker (omit "Image:")-->
| marksize=8 <!--marker size (default: 8px, 1px=none)-->
| float=right <!--(or left, center) - position of map-->
}}
<div style="font-family: monospace;"><!--indent next line by 1 space to trigger quote-box -->
 <nowiki>{{</nowiki>Location map | 100x100
 | AlternativeMap = Gold star on blue.gif
 | caption = Marker on star
 | width=110 <!--omit "px"-->
 | label=Dot
 | label-size=80
 | background = #CCCCCC
 | position=left <!--or left/right/top -->
 | lat  = 81.00  <!--latitude 0-100.0 -->
 | long = 42.90  <!--longitude 0-100.0-->
 | mark=Red_pog.svg <!--marker (omit "Image:")-->
 | marksize=8 <!--default: 8px, 1px=none-->
 | float=right <!--left/center-->
 }}
</div>

==Other options==
It is possible to place markers/labels outside a map, by specifying latitude or longitude coordinates beyond 0-100.0:
::* Over longitude=99.0 will push a label off-map to the right;
::* Under longitude= -2.0 will push a label off-map to the left;
::* Over latitude= 101.0 will push a label off-map to the top.
For templates that restrict coordinates, expand the ''minutes'' field: lat_deg=100.0 but lat_min=120 yielding a combined 102 degrees (60 minutes = 1 degree).

==See also==
* [[Template:Superimpose]] - to label an image without a border box

<includeonly>
<!-- CATEGORIES HERE, THANKS -->
[[Category:Graphics templates]]
[[Category:Location map modules|100x100]]
</includeonly><noinclude>
[[Category:Module documentation pages]]
</noinclude>