模組:Infobox mapframe/doc

用法

该模块可自动生成适合信息框的mapframe，编者只需输入少量信息即可。

通用用法

只需使用模板{{Infobox mapframe}}，按照其文档进行操作即可。该模块也可以导入到另一个Lua模块中。

信息框中的自动地图

示例编辑: Template:Infobox prison、Template:Infobox prison/doc

编辑信息框模板（或其沙盒）。

在信息框中添加类似以下示例的行。将数字（4，或97至99）替换为适当的数字，具体数字取决于已有多少其他图像或data参数。

如果放在信息框顶部附近	如果放置在信息框底部或底部附近
| image4 = {{#invoke:Infobox mapframe|auto}} | caption4 = {{#invoke:Infobox mapframe|autocaption}}	| header97 = {{#if:{{{mapframe|}}}|地图}} | data98 = {{#invoke:Infobox mapframe|auto}} | data99 = {{#invoke:Infobox mapframe|autocaption}}

如果模板中使用了{{#invoke:Check for unknown parameters|check}}，请向其添加以下参数：

|mapframe|mapframe-area_km2|mapframe-area_mi2|mapframe-caption|mapframe-coord|mapframe-coordinates|mapframe-custom|mapframe-frame-coord|mapframe-frame-coordinates|mapframe-frame-height|mapframe-frame-width|mapframe-geomask|mapframe-geomask-fill|mapframe-geomask-fill-opacity|mapframe-geomask-stroke-color|mapframe-geomask-stroke-colour|mapframe-geomask-stroke-width|mapframe-height|mapframe-id|mapframe-length_km|mapframe-length_mi|mapframe-marker|mapframe-marker-color|mapframe-marker-colour|mapframe-point|mapframe-shape|mapframe-shape-fill|mapframe-shape-fill-opacity|mapframe-stroke-color|mapframe-stroke-colour|mapframe-stroke-width|mapframe-switcher|mapframe-width|mapframe-wikidata|mapframe-zoom

完成此操作后，模板即可使用上述参数。

这些参数也可以在前述#invoke调用中指定默认值，例如{{#invoke:Infobox mapframe|auto|mapframe-marker=library}}表示默认使用“library”图标，除非模板调用时传入不同值。

• 地图功能默认处于关闭状态，这意味着除非模板调用中包含|mapframe=yes参数，否则地图不会显示。如需默认开启地图功能，可在上述#invoke调用中添加|onByDefault=yes——这将使得地图默认显示，除非模板调用中包含|mapframe=no参数。onByDefault也可以设置为一个条件，例如|onByDefault={{#if:{{{pushpin_map|}}}|no|yes}}，表示若使用了{{{pushpin_map|}}}参数，则关闭地图功能，否则开启地图功能。
• 模板文档中的参数说明可以使用{{Infobox mapframe/doc/parameters}}进行更新。通过以|参数名=值的形式指定默认值（如果在#invoke调用中使用了默认值）。以下是默认输出：

延伸內容

• 基本参数：
  • mapframe — 指定yes或no以显示或隐藏地图，覆盖默认值。默认：no
  • mapframe-caption — 地图说明。默认： 空白（或如果设置了|mapframe-geomask=，则：“在<遮罩标签>的位置”）
  • mapframe-custom — 使用自定义地图代替自动地图框架。请使用{{maplink}}模板（或其他可生成地图框架的模板）或图像文件名称。如果使用，后续的mapframe参数将被忽略。默认：未指定
  • mapframe-id或id或qid — 要使用的维基数据项QID。默认：当前页面对应数据项
  • mapframe-coordinates或mapframe-coord或coordinates或coord — 指定的坐标，而不是维基数据上的坐标。使用{{Coord}}模板，例如：|coord={{Coord|12.34|N|56.78}}。默认：来自维基数据的坐标
  • mapframe-wikidata — 当设置了|coord=时，设为yes以显示维基数据中的面/线特征（如果有）。默认： 未指定
• 自定义显示哪些特征：
  • mapframe-point — 设为none时关闭点标记的显示。设为on时强制显示点标记。默认： 未指定
  • mapframe-line — 设为none时关闭线特征的显示。默认： 未指定
  • mapframe-shape — 设为none时关闭面特征的显示。设为inverse时使用反转形状（geomask）代替常规形状。默认： 未指定
  • mapframe-geomask — 用作遮罩的维基数据项（遮罩边界外的区域变暗）。可以是特定的维基数据项（QID），或数据项的属性（例如，P17表示国家 (P17)，P131表示所在行政领土实体 (P131)）。默认： 未指定
  • mapframe-switcher — 设置为auto或geomasks或zooms，以启用切换多个地图框架的功能（以Template:Switcher的风格）。默认： 未指定
    • auto — 以维基数据项的位置 (P276)和所在行政领土实体 (P131)声称为遮罩进行切换，递归搜索。例如，数据项的城市、该城市的州以及该州的国家。
    • geomasks — 在mapframe-geomask参数中的维基数据项（QID）列表（以逗号分隔）指定的遮罩之间切换。
    • zooms — 在“zoomed in”/“zoomed midway”/“zoomed out”之间切换，其中“zoomed in”为默认缩放（最小值为3），“zoomed out”为1，而“zoomed midway”为平均值。
• 其他可选参数：
  • mapframe-frame-width或mapframe-width — 框架宽度。默认：270
  • mapframe-frame-height或mapframe-height — 框架高度。默认：200
  • mapframe-shape-fill — 面特征的填充颜色。默认：#606060
  • mapframe-shape-fill-opacity — 面特征填充的不透明度，数值介于0和1之间。默认：0.5
  • mapframe-stroke-color或mapframe-stroke-colour — 线特征、面特征轮廓的颜色。默认：#ff0000
  • mapframe-stroke-width — 线特征、面特征轮廓的粗细。默认：5
  • mapframe-marker — 用于坐标点标记的符号；具体选项参见mw:Help:Extension:Kartographer/Icons。默认： 未指定（即blank）
    • 也可以设置为blank以覆盖默认标记符号。
  • mapframe-marker-color或mapframe-marker-colour — 点标记的背景颜色。默认：#5E74F3
  • mapframe-geomask-stroke-color或mapframe-geomask-stroke-colour — 遮罩轮廓的颜色。默认：#555555
  • mapframe-geomask-stroke-width — 遮罩轮廓的粗细。默认：2
  • mapframe-geomask-fill — 遮罩外部区域的填充颜色。默认：#606060
  • mapframe-geomask-fill-opacity — 遮罩外部区域填充的不透明度，数值介于0和1之间。默认：0.5
  • mapframe-zoom — 设置缩放级别，从“1”（全球地图）到 “18”（最大级别），用于无法根据对象长度或面积自动确定缩放级别的情况。默认：10
  • mapframe-length_km或mapframe-length_mi或mapframe-area_km2或mapframe-area_mi2 — 通过输入对象的长度（以公里或英里为单位）或面积（以平方公里或平方英里为单位）来确定缩放级别。默认：未指定
  • mapframe-frame-coordinates或mapframe-frame-coord — 地图初始位置的备用坐标，使用使用{{coord}}模板。默认：衍生自项目坐标

• 模板数据部分，可插入Template:Infobox mapframe/doc#模板数据的内容来更新。

常见问题及解答

Q1：为什么来自OpenStreetMap的线状或面状要素没有显示？

A1：有几种可能的原因：

• 根据mw:Help:Extension:Kartographer/OSM，OSM上的要素需要标记维基数据ID。仅在维基数据项上设置OSM关系标识符 (P402)是不够的。
• 只能使用某些OSM关系（类型为multipolygon、route、waterway和boundary的关系），而不能使用其他类型如建筑物和公共交通主干路线。请参阅mw:Help:Extension:Kartographer/OSM#Limitation和phab:T156433。
• 在OSM上标记后，可能需要1到2天数据才能在此处可用。
• 维基媒体偶尔在复制OSM数据时出现问题（例如phab:T218097），或因其他问题有意禁用复制（例如phab:T243609）

Q2：当底图出现问题时在哪里提交错误报告？（例如缺失湖泊）

A2：如果该问题也出现在OpenStreetMap上，则需要在OpenStreetMap上修复。如果问题仅出现在维基媒体地图上，可以在Phabricator上报告（您可以使用维基百科账户登录）。请参阅mw:How to report a bug获取操作说明（对于标签，请使用Maps）。（或者，您可以尝试mw:Help talk:Extension:Kartographer）

Q3：在哪里报告地图的其他错误或问题？

A3：这可能是维基百科模块的问题，也可能是底层软件的错误（这类错误很多）。

• 如果使用纯<mapframe>...</mapframe>标签时也出现该问题，则应在Phabricator上报告（您可以使用维基百科账户登录）。请参阅mw:How to report a bug获取操作说明（对于标签，请使用Maps）。（或者，您可以尝试mw:Help talk:Extension:Kartographer）
• 如果问题仅出现在维基百科的模板/模块中，或者您不确定，请在Wikipedia:互助客栈/技术报告。

Q4：为什么查看页面时缩略图地图呈现为静态图像，而编辑页面时却是交互式的？

A4：在维基百科以及除维基导游外的大多数wiki上，嵌入的缩略图是静态地图，需要打开全屏地图后才能进行缩放或平移。这是出于性能考虑，以便在禁用JavaScript时能显示某些内容，并方便打印。
预览模式显示交互式地图是一个错误，phab:T203863（也是一个性能问题）。更多解释可以在phab:T202793的评论中找到。

Q5：为什么编辑或添加地图后，线状、面状或点状要素没有显示，尽管它们在页面预览中显示过？

A5：这是一个与生成缩略图图像相关的错误。它应该在一两个小时内自行修复。详情请参阅phab:T269984。

Q6：使用mapframe的|raw=参数（在使用Module:Infobox mapframe的信息框的|mapframe-custom=参数内）的页面显示“运行脚本的分配时间已到”的错误消息。该怎么办？

A6：如果要处理的原始数据量过大，可能会显示该超时消息。您可以尝试将原始数据移至Commons（示例）或使用Special:ExpandTemplates将mapframe模板替换为等效的wikitext（示例）

参见

• en:Wikipedia:Mapframe maps in infoboxes
• Module:Mapframe & Template:Maplink