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