模組: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