编辑“︁Template:Location mark/doc”︁

{{NoteTA|G1=MediaWiki}}
<!-- 在这里加入模板的标识 -->
{{Documentation subpage}}
<!-- 在本行下編輯模板說明 -->
此模板用于在图片上放置标记，并可添加标签。它是{{tl|Location mark+}}的简化版本。

其他模板更适合叠加图片。本模板使用相对坐标值在任何图片上居中放置标记。即使合成图片的尺寸改变，标记的相对位置也不会改变。合成图片可以显示为普通图片、带边框图片或缩略图。

如果已知地理位置坐标且存在[[Template:Location_map#可用地圖|定位地图模板]]，则应使用Location map系列模板之一。下方的[[#参见|参见]]部分列出了替代模板。

== 用法 ==
{{Location mark
| image = Usa edcp location map.svg
| width = 300
| float = right
| caption = 美国的一个地点
| alt = 美国地图
| type = thumb
| label = 四角落
| label_alt = 四角落替代文字
| label_link = 四角落
| position = bottom
| background = #fefee9
| mark = Green pog.svg
| mark_width = 7
| x = 275
| y = 326
}}
{|
|- style="vertical-align:top;"
|<pre style="width:15em; margin-right:2em;">
{{Location mark
| image = 
| overlay = 
| width = 
| caption = 
| alt = 
| float = 
| type = 
| label = 
| position = 
| font_size = 
| background = 
| mark = 
| mark_width = 
| mark_alt = 
| mark_link = 
| x = 
| y = 
}}</pre>
|}

== 参数 ==

{| class="wikitable" style="font-size:90%; width:100%;"
! 参数
! 描述
|-
|<code>image</code>
| 必需。图片文件名。
|-
|<code>overlay</code>
| 要叠加在图片上的图片文件名。应与原图尺寸相同且背景透明。
|-
|<code>width</code>
| 设置图片宽度（像素）。默认220px。例如<code>width=240</code>而非<code>width=240px</code>。
|-
| <code>caption</code>
| 使用缩略图选项时显示在图片下方的说明文字。参见[[#示例|示例]]。
|-
|<code>alt</code>
| 地图的替代文字。参见[[WP:ALT]]。若未提供则使用<code>caption</code>文字。
|-
| <code>type</code>
| 设置显示格式。有效值为<code>thumb</code>和<code>border</code>。<code>thumb</code>生成类似<code><nowiki>[[File:|name|thumb]]</nowiki></code>的输出，<code>border</code>生成类似<code><nowiki>[[File:|name|border]]</nowiki></code>的输出。若未指定有效值，输出将无边框。参见[[#type参数|下文]]和[[:en:wp:Extended image syntax#Type|此页面]]。
|-
|<code>float</code>
| 设置图片在页面中的位置。有效值为<code>left</code>、<code>right</code>、<code>center</code>和<code>none</code>。默认为<code>right</code>。
|-
|<code>label</code>
| 可选。显示在标记旁的标签文字。可使用[[Wiki标记语言|维基链接]]。
|-
|<code>position</code>
| 标签相对于标记的位置。有效值为<code>left</code>、<code>right</code>、<code>top</code>和<code>bottom</code>。默认为<code>right</code>。''若未指定，模板将根据标记位置自动决定标签显示在左侧或右侧。''
|-
|<code>font_size</code>
|  标签字体大小（百分比）。默认为90%。例如<code>font_size=80</code>。
|-
|<code>background</code>
| 标签文字的背景颜色。参见[[网页颜色]]。默认继承标签后图片的背景色。
|-
|<code>mark</code>
| 用作标记的图片文件名。默认为[[:File:Red pog.svg|Red pog.svg]]。可前往[[commons:Location markers|这里]]和[[commons:Category:map icons|这里]]查看示例。
|-
|<code>mark_width</code>
| 标记宽度（像素）。默认为8px。例如<code>mark_width=7</code>而非<code>mark_width=7px</code>。大尺寸标记图片不适用于标签。本模板不适用于生成叠加效果。参见{{tl|Superimpose}}。
|-
|<code>mark_link</code>
| 指定点击标记时跟随的[[Wiki标记语言|维基链接]]。当鼠标悬停在标记上时，链接文章名称将显示为提示文字。
|-
|<code>mark_alt</code>
| 标记图片的替代文字。参见[[WP:ALT]]。若未提供则使用<code>label</code>文字。
|-
|<code>x</code><br/><code>y</code> || 指定标记在图片上的位置。坐标基于宽度为1000像素的地图以像素为单位。模板会自动缩放这些值以正确显示。参见[[#使用x和y参数在图片上放置标记|下文]]。
|-
|<code>x%</code><br/><code>y%</code> || 指定标记在图片上的位置。<code>x%</code>指定从左边缘开始的横向距离百分比，<code>y%</code>指定从上边缘开始的纵向距离百分比。参见[[#使用x%和y%参数在图片上放置标记|下文]]。
|}

== 标记放置参数 ==
有两种在图片上放置标记的方法。

=== 使用<code>x</code>和<code>y</code>参数在图片上放置标记 ===
<code>x</code>和<code>y</code>参数的值是当图片缩放至1000像素宽时，位置标记的像素坐标。

:<code>x</code>是标记距1000px宽图片左边缘的像素偏移量。
:<code>y</code>是标记距1000px宽图片上边缘的像素偏移量。

获取这些值至少有两种方法：

#从图片的[[Help:文件描述页|文件页面]]下载图片到电脑。用[[图像软件|图形编辑器]]（如[[GIMP]]或[[XnView]]）打开图片。将图片缩放至1000px宽，然后记下光标指向目标位置时的x、y坐标。直接使用这些值。
#从图片的[[Help:文件描述页|文件页面]]下载图片到电脑。用能显示光标坐标的[[图像浏览器|图片查看器]]（如微软的[[画图]]）打开图片。记下光标指向目标位置时的x'、y'坐标。然后：

::{{math|size=14pt|{{sfrac|1000{{·}}x'|w}} {{=}} {{math|size=13pt|x}}}}&nbsp; 和&nbsp; {{math|size=14pt|{{sfrac|1000{{·}}y'|w}} {{=}} {{math|size=13pt|y}}}}

::其中{{math|size=13pt|x'}}和{{math|size=13pt|y'}}是光标坐标，{{math|size=13pt|w}}是电脑上显示的图片宽度，{{math|size=13pt|x}}和{{math|size=13pt|y}}是要赋给<code>x</code>和<code>y</code>参数的值。

=== 使用<code>x%</code>和<code>y%</code>参数在图片上放置标记 ===
:x%指定从左边缘开始的横向距离百分比。
:y%指定从上边缘开始的纵向距离百分比。

== <code>type</code>参数 ==
<div class="center">
{| style="float: none;"
! <code>type=</code>
! <code>type=border</code>
! <code>type=thumb</code>
|- style="vertical-align:top;padding-left: 10em;" 
| width = "280px" | {{Location mark
| width = 200
| image = Scottish infobox template map.png
| caption = 苏格兰的Rattray Head
| float = none
| type = 
| label = '''Rattray Head'''
| position = left
| mark_width = 7
| x = 850 | y = 714
}}
| width = "280px" | {{Location mark
| width = 200
| image = Scottish infobox template map.png
| caption = 苏格兰的Rattray Head
| float = none
| type = border
| marks = 
| label = '''Rattray Head'''
| position = left
| mark_width = 7
| x = 850 | y = 714
}}
| width = "280px" | {{Location mark
| width = 200
| image = Scottish infobox template map.png
| caption = 苏格兰的Rattray Head
| float = none 
| type = thumb
| label = '''Rattray Head'''
| position = left
| mark_width = 7
| x = 850 | y = 714
}}
|}
</div>

== 示例 ==
前两个示例可使用{{tl|Location map+}}实现。

=== 使用大部分默认值 ===
{{Location mark
| width = 
| image = Scotland relief location map.jpg
| caption = Scotland
| float = 
| type = 
| label = '''Cape Wrath'''
| position = 
| x = 452 | y = 480
}}
<pre style="width: 50em;">
{{Location mark
| width = 
| image = Scotland relief location map.jpg
| caption = Scotland
| float = 
| type = 
| label = '''Cape Wrath'''
| position = 
| x = 452 | y = 480
}}
</pre>
{{clear}}

=== 为标签使用背景色 ===
{{Location mark
| image = North Rhine-Westphalia location map 05.svg
| width = 300
| caption = Location of Düsseldorf in [[North Rhine-Westphalia]]
| type = thumb
| label = Düsseldorf
| position = left
| background = #a7cb9d
| x = 267 | y = 574
}}
<pre style="width: 50em;">
{{Location mark
| image = North Rhine-Westphalia location map 05.svg
| width = 300
| caption = Location of Düsseldorf in [[North Rhine-Westphalia]]
| type = thumb
| label = Düsseldorf
| position = left
| background = #a7cb9d
| x = 267 | y = 574
}}
</pre>
{{clear}}

=== 使用不可见标记 ===
{{Location mark
| image = Take five.jpg
| caption = A cute chick
| type = thumb
| label = Rachel
| position = top
| background = #ae9074
| mark = Blanksvg.svg
| x = 433 | y = 295
}}
<pre style="width: 50em;">
{{Location mark
| image = Take five.jpg
| caption = A cute chick
| type = thumb
| label = Rachel
| position = top
| background = #ae9074
| mark = Blanksvg.svg
| x = 433 | y = 295
}}
</pre>
{{clear}}

== 参见 ==
* {{tl|Location mark+}}
* {{tl|Location map}}
* {{tl|Location map+}}
* {{tl|Superimpose}}
* {{tl|Superimpose2}}
* {{tl|Overlay}}
* {{tl|Annotated image}}
* {{tl|Image label}}

<includeonly>{{Sandbox other||<!-- 本行下加入模板的分類 -->
[[Category:圖像模板]]
}}</includeonly>