Дидани манбаъи Шаблон:Location map+/doc

{{Documentation subpage}}
<includeonly>{{high-use|13,000+}}</includeonly>
{{Lua|Module:Location map/multi}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->

{{Location map+|England|width=300|AlternativeMap=England_locator_map_with_North_East_England_highlighted.svg|alt=Map of England showing the locations of towns and battles. Bosworth is in the centre, northwest of London.|float=right|caption=<span style="font-size:95%;">[[File:Battle icon active (crossed swords).svg|16px|link=]] [[Battle of Bosworth Field]] [[File:Battle icon (crossed swords).svg|14px|link=]] other battles</span> |places=
  {{Location map~ |England |label='''[[Battle of Bosworth Field|Bosworth]]''' |label_size=86 |position=right |lat=52.591265 |long=-1.410327 |mark=Battle_icon_active_(crossed_swords).svg |marksize=18 |link=Battle of Bosworth Field}}
  {{Location map~ |England |label=[[Battle of Blore Heath|Blore Heath]] |label_size=86 |position=top |lat=52.913611 |long=-2.424722 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Battle of Blore Heath}}
  {{Location map~ |England |label=[[Battle of Barnet|Barnet]] |label_size=86 |position=top |lat=51.662233 |long=-0.200039 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Battle of Barnet}}
  {{Location map~ |England |label=[[Battle of Stoke Field|East Stoke]] |label_size=86 |position=top |lat=53.029058 |long=-0.892586 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Battle of Stoke Field}}
  {{Location map~ |England |label=[[Battle of Tewkesbury|Tewkesbury]] |label_size=86 |position=top |lat=51.986389 |long=-2.161389 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Battle of Tewkesbury}}
  {{Location map~ |England |label=Berwick |label_size=86 |position=bottom |lat=55.771 |long=-2.007 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=London |label_size=86 |position=bottom |lat=51.507778 |long=-0.128056 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=York |label_size=86 |position=bottom |lat=53.958333 |long=-1.096667 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=Plymouth |label_size=86 |position=bottom |lat=50.371397 |long=-4.142431 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=Poole |label_size=86 |position=bottom |lat=50.71942 |long=-1.98113 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=Wem |label_size=86 |position=left |lat=52.8555 |long=-2.7211 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=Northumberland |label_size=86 |position=right |lat=55.1 |long=-1.68 |mark=Steel pog.svg |marksize=1}}
  {{Location map~ |England |label=Shrewsbury |label_size=86 |position=bottom |lat=52.7077 |long=-2.7541 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=Milford Haven |label_size=86 |position=bottom |lat=51.71418 |long=-5.04274 |mark=Steel pog.svg |marksize=6}}
}}

{{tl2|Location map+}} places one or more location marks on a map, with optional labels. It is in the same family of templates as the [[Template:Location map|Location map]] template and the documentation for that template might be helpful.

Template:Location map+ uses a helper template, {{tl2|Location map~}}, one or more times to generate a mark for each location.

== Usage ==

{|
|- style="vertical-align:top;"
|<pre style="width:15em; margin-right:2em;">
{{Location map+
| {{{1}}}
| width          =
| float          =
| border         =
| caption        =
| alt            =
| relief         =
| AlternativeMap =
| overlay_image  =
| places         =
}}</pre>
|<pre style="width:15em;">
{{Location map~
| {{{1}}}
| label      =
| label_size =
| position   =
| background =
| mark       =
| marksize   =
| link       =
| lat_deg    =
| lat_min    =
| lat_sec    =
| lat_dir    =
| lon_deg    =
| lon_min    =
| lon_sec    =
| lon_dir    =
}}</pre>
|}

{{clear}}

== Parameters ==
{| class="wikitable" style="width:100%;"
|+ Parameters for Location map+
! Parameter
! Description
|-
| <tt>{{{1}}}</tt>
| Required. Use the name of the map as the first unnamed parameter. For example, specifying ''England'' will use the values for England in [[Module:Location map/data/England]] if it exists, or {{tld|Location map England}} otherwise. See the [[#Examples|examples]] below.
|-
| <tt>width</tt>
| Determines the width of the map in [[pixel]]s, overriding any default values. Do not include <code>px</code>, for example: <code>width=300</code>, not <code>width=300px</code>.
|-
| <tt>default_width</tt>
| Determines the default width of the map in pixels, intended for use by templates e.g. place infoboxes. The default value is 240. Do not include <code>px</code>. This value will be multiplied by the <code>defaultscale</code> parameter specified in individual map templates, if it exists, in order to achieve an appropriate size for vertical maps. For example, if <code>default_width=200</code> is given, a map of Thailand will be displayed with a width of 200 * 0.57 = 114 pixels (as specified in [[Module:Location map/data/Thailand]]).
|-
| <tt>float</tt>
| Specifies the position of the map on the page. Valid values are <code>left</code>, <code>right</code>, <code>center</code> and <code>none</code>. The default is <code>right</code>.
|-
| <tt>border</tt>
|  Specifies the color of the 1px map border. The default is ''lightgrey'' (see [[web colors]]). If set to <code>none</code>, no border will be generated. This parameter is seldom used.
|-
| <tt>caption</tt>
| The text of a caption to be displayed below the map. Specifying a caption will cause the map to be displayed with a frame. If <code>caption</code> is defined but is not assigned a value, the map will not be framed and no caption will be displayed. If <code>caption</code> is not defined, the map will not be framed and a default caption will be generated. The default caption is created from the <tt>label</tt> parameter (or the current page name if label not defined) and the <tt>name</tt> parameter from map definition template. See the [[#Examples|examples]] below.
|-
| <tt>alt</tt>
| Alt text for map; used by [[screen reader]]s, see [[WP:ALT]].
|-
| <tt>relief</tt>
| Any non-blank value (1, yes, etc.) will cause the template to display the map specified in the map definition template as <tt>image1</tt>, which is usually a [[Relief mapping (computer graphics)|relief map]]. See the example at [[Template:Location map+/relief|Location map+/relief]].
|-
| <tt>AlternativeMap</tt>
| Allows the use of an alternative map. The image must have the same edge coordinates as the location map template. See the example at [[Template:Location map+/AlternativeMap|Location map+/AlternativeMap]].
|-
| <tt>overlay_image</tt>
| Allows an overlay to be superimposed on the map. This parameter is seldom used. See the example at [[Template:Location map+/overlay|Location map+/overlay]].
|-
| <tt>places</tt>
| Specifies one or more place markers using <code>Location map~</code>.
|}

{| class="wikitable" style="width:100%;"
|+ Parameters for Location map~
! Parameter
! Description
|-
| <tt>{{{1}}}</tt>
| Required. Use the name of the map as the first unnamed parameter. For example, specifying ''England'' will use the values for England in [[Module:Location map/data/England]] if it exists, or {{tld|Location map England}} otherwise. See the [[#Examples|examples]] below.
|-
| <tt>label</tt>
| The text of the label to display next to the mark. A [[Wiki markup|wiki link]] can be used. The default if not specified is no label, just the marker.
|-
| <tt>label_size</tt>
|  The font size to use for the label, given as a percentage of the normal font size (<100 = smaller, >100 = larger). The default is 90. Do not include <code>%</code>, for example: <code>label_size=80</code>, not <code>label_size=80%</code>. If set to 0, the label is only displayed when the user hovers over the mark.
|-
| <tt>position</tt>
| The position of the label relative to the mark. Valid values are <code>left</code>, <code>right</code>, <code>top</code> and <code>bottom</code>. The default is <code>right</code>.
|-
| <tt>background</tt>
| The background color to use for the label. See [[Web colors]]. The default is no background color, which shows the map image behind the label.
|-
| <tt>mark</tt>
| The name of an image to display as the mark. The default is [[:File:Red pog.svg|Red pog.svg]] ([[File:Red pog.svg|8px]]). See examples at [[Commons:Location markers]] and [[Commons:Category:Map icons]].
|-
| <tt>marksize</tt>
| The size of the mark in [[pixel]]s. The default is 8. Do not include <code>px</code>, for example: <code>marksize=10</code>, not <code>marksize=10px</code>.
|-
| <tt>link</tt>
| Specifies a [[Wiki markup|wiki link]] which will be followed if the reader clicks on the mark. Do not include <code>[[]]</code>, for example: <code>link=Yellowstone National Park</code>, not <code>link=[&#91;Yellowstone National Park&#93;]</code>.
|-
|<tt>lat_deg</tt>
| Required. The degrees of [[latitude]]. This value can be specified using [[decimal degrees]] and when this format is used minutes and seconds should not be specified.<ref group=Note name="precision" />
|-
| <tt>lat_min</tt>
| The minutes of latitude.<ref group=Note name="precision" />
|-
| <tt>lat_sec</tt>
| The seconds of latitude. Usually not necessary.<ref group=Note name="precision" />
|-
| <tt>lat_dir</tt>
| N if north (default value) or S for south of the [[Equator]]. Other values will be disregarded. Not required if using signed decimal degrees (i.e. negative numbers for southern latitude).
|-
| <tt>lon_deg</tt>
| Required. The degrees of [[longitude]]. This value can be specified using [[decimal degrees]] and when this format is used minutes and seconds should not be specified.<ref group=Note name="precision" />
|-
| <tt>lon_min</tt>
| The minutes of longitude.<ref group=Note name="precision" />
|-
| <tt>lon_sec</tt>
| The seconds of longitude. Usually not necessary.<ref group=Note name="precision" />
|-
| <tt>lon_dir</tt>
| E for east (default value) or W for west of the [[IERS Reference Meridian|Prime Meridian]]. Other values will be disregarded. Not required if using signed decimal degrees (i.e. negative numbers for western longitude).
|}

Notes:
{{Reflist 
| group = Note 
| refs =
<ref group=Note name="precision">Appropriate precision should be used. For example, the whole US map, with a 1000-pixel width, has a resolution of about 5km/pixel. Only 2 decimal places of precision in decimal degrees (~1km), or whole minutes (~1.7km) in DMS format, are required.</ref>
}}

== Available maps ==

Location maps can be found using these sources:

:[[Special:PrefixIndex/Module:Location map/data/]] - Checked before a map template is searched for. New maps should be created here rather than creating new templates.
:[[Template:Location map/List|List of templates]] - 1050 templates available when the list was generated.
:[[:Category:Location map templates]] - templates sorted by category.
:[[Special:WhatLinksHere/Template:Location map/Info]] - a search that might help.
:[[Special:Prefixindex/Template:Location map]] - another search that might help.




{{Location map many |Europe
|AlternativeMap = Europe.svg
|width   = 600
|float   = right
|caption = Location of VHF transmitters
|alt     = 
|label   = Dourbes
|lat_deg = 50.098
|lon_deg = 4.59
}}

== Template data ==
{{TemplateData header}}
{{Template:{{BASEPAGENAME}}/TemplateData}}

== See also ==
* [[Template:Location map]] for displaying one mark using latitude and longitude.
* [[Template:Location map many]] for displaying multiple marks using latitude and longitude.

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!--Categories below this line, please; interwikis at Wikidata-->
[[Category:Location map templates| ]]
[[Category:Graphics templates]]

}}<!--(end #ifeq)--></includeonly>