模組:Routemap/doc

此頁面為 Module:Routemap 的說明文件

package.lua第80行Lua錯誤：module 'Module:Transclusion_count/data/R' not found

本模組已評為通用版，其已臻成熟，可正常使用於各處而不會出現錯誤。已可在幫助頁面和其他維基百科資源中提及，以幫助新用戶學習。為降低服務器負載和錯誤輸出，改善本模組前應進行沙盒測試，而不是重複的試錯性編輯。

本模塊由俄語維基百科用戶KPu3uC B Poccuu及YLSS創建維護。

基本用法

圖標代碼\圖標代碼\圖標代碼~~時間距離~~主文字~~備註~~右備註

或

圖標代碼\圖標代碼\圖標代碼~~主文字

{{BS-map
|map-title=例1
|map=
KBHFa~~起點
WASSERq\hKRZW\WASSERq~~ ~~ ~~ ~~天橋
LDER\INT\~~1公里~~中途站~~轉乘高鐵
\KBHFe\BUS~~2公里~~終點~~巴士總站
}}

Template:BS-map

圖標分隔的斜間（\)與XML元素的終結斜間（/）正好相反。
如果圖標欄後只有一個文字欄分隔「波浪-波浪」（~~），後面的文字會顯示在主文字欄而非時間距離欄。
文字欄之間留空的話必須輸入空格，否則維基軟件會誤認為用戶簽名，且會被防濫用過濾器阻擋編輯。

圖標重疊與圖標鏈接

{{BS-map
|map-title=例2
|map=
uSTRq!~STR2!~BHF!~lHUB~~圖標重疊
uBHF!@超級站~~圖標鏈接
}}

Template:BS-map

重疊分隔「感嘆號-波浪」（!~）必須跟隨在下一層被重疊的圖標代碼之後。
圖標重疊數基本是無限。
使用圖標鏈接的話，圖標鏈接分隔符（!@）必須跟隨在最後（最頂）的圖標代碼之後，鏈接目的詞條之前。

摺疊

{{BS-map
|map-title=例3.1：基本摺疊
|text-width=100
|map=
-startCollapsible-collapsed
\KBHFa\~~起點
hSTRa@g
WASSERq\hKRZW\WASSERq~~ ~~ ~~ ~~天橋
hSTRe@f
-endCollapsible-
LDER\INT\~~ ~~中途站~~轉乘高鐵
\KBHFe\BUS~~ ~~終點~~巴士總站
|map2-title=例3.2：單雙圖標行混用的摺疊
|text-width2=100
|map2=
-startCollapsible-collapsed
d\KBHFa\d~~起點
hKRZW~~ ~~ ~~ ~~天橋
-endCollapsible-
BS2+l\BS2+r~~分叉
}}

Template:BS-map

調整{{{text-width}}}參數直到路線圖的圖標之間沒有斷裂。
- 默認單位為px，可以使用其他單位如em。
- 注意要為不同瀏覽器調整最合適的最大寬度。
摺疊行（摺疊區域的首行）的圖標欄數目必須等於整個路線圖的最大圖標欄數目。
- 單雙數量的圖標行混用的場合下如例3.2，可以用半寬的空白圖標Template:Bsq作為填塞。
將「collapsed」改為「nil」可以令摺疊部分預設為展開。

摺疊取代

{{BS-map
|map-title=例4.1
|text-width=110
|map=
KBHFa~~起點
-startCollapsible-collapsed-replace
\LSTR\~~可有可無的部分
\hSTRa@g\
WASSERq\hKRZW\WASSERq~~ ~~ ~~ ~~天橋
hSTRe@f
-endCollapsible-
LDER\INT\~~ ~~中途站~~轉乘高鐵
\KBHFe\BUS~~ ~~終點~~巴士總站
|map2-title=例4.2：空白填塞
|text-width2=100
|map2=
-startCollapsible-collapsed-replace
exCONTg~~建築中
leer
exKBHFa~~未來起點
exBHF~~未來站
-endCollapsible
KBHFxa~~起點
KBHFe~~終點
}}

Template:BS-map

取代與被取代的兩行的圖標欄數目都必須等於整個路線圖的最大圖標欄數目。
如欲隱藏取代行展開後的圖標，可以如例4.2以空白圖標Template:Bsq作為填塞。

雙文字欄

左左備註~~左備註~~左主文字~~左時間距離! !圖標代碼~~右時間距離~~右主文字~~右備註~~右右備註

或

左主文字! !圖標代碼~~右主文字

{{BS-map
|map-title=例5
|map=
通勤起點! !uKBHFa\\KBHFa~~區域起點
鹹魚河~~ ~~ ~~! !uhKRZW\WASSERq\hKRZW~~ ~~ ~~ ~~天橋
轉乘高鐵~~中途站~~1公里! !uINT\LDER\LSTR
通勤終點~~2公里! !uKBHFe\\KBHFe~~2公里~~區域終點
}}

Template:BS-map

左文字欄以「感嘆號-空格-感嘆號」（! !）分隔圖標欄。
「感嘆號-空格-感嘆號」的左邊沒有任何「波浪-波浪」（~~）文字分隔的話，其左邊第一組及唯一一組文字會顯示在左主文字欄。

雙文字欄摺疊

{{BS-map
|map-title=例6.1：使用了全部文字欄
|text-width=40,60,35,35,60,
|map=
-startCollapsible
通勤起點! !uKBHFa\leer\KBHFa~~區域起點
鹹魚河~~ ~~ ~~! !uhKRZW\WASSERq\hKRZW~~ ~~ ~~ ~~天橋
-endCollapsible
轉乘高鐵~~中途站~~1公里! !uINT\LDER\LSTR
通勤終點~~2公里! !uKBHFe\\KBHFe~~2公里~~區域終點
|map2-title=例6.2：只用了主文字欄
|text-width2=,60,,,60,
|map2=
-startCollapsible
通勤起點! !uKBHFa\\KBHFa~~區域起點
鹹魚河! !uhKRZW\WASSERq\hKRZW~~天橋
-endCollapsible
中途站! !uINT\LDER\LSTR
通勤終點! !uKBHFe\\KBHFe~~區域終點
}}

Template:BS-map

需要使用{{{text-width}}}參數的進階定義避免圖標行之間斷裂：
- 只有一個數值時僅代表右主文字+右備註的寬度
- 有3個數值時，以半型逗號分隔代表文字欄的寬度為：右時間距離,右主文字+右備註,右右備註
- 6個數值：左左備註,左備註+左主文字,左時間距離,右時間距離,右主文字+右備註,右右備註
- 數值不是1、3或6組會令參數失效。
右右備註的文字長度少於一定量可以省略其寬度定義，如例6.1。
如果整個路線圖都沒有使用某一組文字欄，該欄的寬度定義可以省略留空，如例6.2。
摺疊行的空白圖標欄如果被擠壓，可以使用空白圖標Template:Bsq固定寬度。