模組:RouteSequence/doc

此模块文档被引用於約14,000個頁面。
為了避免造成大規模的影響，所有對此模块文档的編輯應先於沙盒或測試樣例上測試。
測試後無誤的版本可以一次性地加入此模块文档中，但是修改前請務必於討論頁發起討論。

模板引用數量會自動更新。

本模块为方便填写{{鐵道路線}}模板中的线路图而设计。

基本用法[编辑]

站名1 ~ 站名2 ~ 站名3前缀#站名3#站名3后缀 ~ 站名4条目名!站名4

例如，代码

{{鐵道路線|lua=1
|模板名稱=昆明地铁6号线
|名稱=昆明地铁6号线
|代表色=#2c8195
|铁道系统 = 昆明地铁
|Logo=
|車站列表= （预留延伸）#东部汽车站~#大板桥##(未开通)~机场前~机场中心站!长水国际机场
}}

将显示为

站名的转换规则如下：

如果给出“铁道系统”参数，将依照“Module:Adjacent stations/{{{铁道系统}}}”中“stationNames”表的链接标题和条目名称转换站名，此为最高优先级。如果未定义数据模块，请勿使用该参数；
如果已经给出条目名，模板优先按照条目名进行显示，而不进行其他的判断；
如果给出的站名末尾为不包含“站”字，模板将自动追加这个“站”字；
如果给出的站名末尾为“站”，在最终显示的模板中，这个“站”字将被省略。因而，如果站名中本身末尾为“站”字，那么需要在末尾写连续两个“站”。例如，如果需要显示“城站”，那么提供给模板的站名应该是完整的条目名“城站站”；
如果给出的站名为消歧义，例如“客运中心站 (杭州地铁)”，将创建形如“[[客运中心站 (杭州地铁)|客运中心]]”的链接。

用于标识前缀/后缀的“#”如果单用，表示前/后缀与站名链接间不加空格。如果连用，即“##”，表示前/后缀与站名链接间加入空格，即“ ”。

站名样式[编辑]

现支持两种自定义站名样式的方法。

采用style标记[编辑]

Style标记给出一个CSS样式，此后的元素将加入这一样式。如果样式留空，则恢复默认样式。例如：

盛莫路 ~ 东环南路 ~ style=color:gray ~ 邱隘东站 ~ 五乡 ~ 宝幢站 (地铁) ~ style= ~ 邬隘站 (地铁)

将会输出

盛莫路 – 东环南路 – 邱隘东 – 五乡 – 宝幢 – 邬隘

对于未开通站点，常用的方法为将站名变灰。为此，模块提供了简易的方式进行书写，例如上面的例子可以改写为

盛莫路 ~ 东环南路 ~ gstart ~ 邱隘站 (地铁) ~ 五乡 ~ 宝幢站 (地铁) ~ gend ~ 邬隘站 (地铁)

另一种方法为将站名变斜体，类似的建议写法如下，即将“gstart/gend”替换为“istart/iend”：

盛莫路 ~ 东环南路 ~ istart ~ 邱隘站 (地铁) ~ 五乡 ~ 宝幢站 (地铁) ~ iend ~ 邬隘站 (地铁)

单站标注[编辑]

现支持标注单个车站的字体为斜体、粗体，增加删除线以及依照原始格式输出，例子见下方。

翔宇路北 ~ '''翔宇路南''' ~ %（支线：[[禄口机场站|禄口机场]]）% ~ ''铜山站 (南京)'' ~ '''s石湫s''' ~ (g明觉g)

将会输出

翔宇路北 – 翔宇路南 – （支线：禄口机场） – 铜山 – 石湫 – (明觉)

除“%”外，多个标注可重复使用。

自定义分隔符[编辑]

在线路定义中加入“sep=分隔符”可替换短横线为自定义分隔符，使用“sep=”可消除该设置。例如，

''北新桥'' ~ 东直门 ~ 三元桥 ~ sep=→ ~ 3号航站楼 ~ 2号航站楼 ~ 返回#三元桥

将输出

北新桥 – 东直门 – 三元桥 → 3号航站楼 → 2号航站楼 → 返回三元桥

为了简化常用分隔符的输入，下列箭头已被预先定义，输入标识符即可使用。

标识符	符号	说明
%rarrow%	→	右箭头
%larrow%	←	左箭头
%darrow%	↔	双向箭头
%rdarrow%	⇒	双线右箭头
%ldarrow%	⇐	双线左箭头
%ddarrow%	⇔	双线双向箭头

因而，上述线路也可改写为

''北新桥'' ~ 东直门 ~ 三元桥 ~ sep=%rarrow% ~ 3号航站楼 ~ 2号航站楼 ~ 返回#三元桥

条件输出[编辑]

在某些情况下，我们可能会希望模板在不同条件下显示不同车站，例如需要控制模板显示已运营车站还是全线所有车站。模块支持引入控制条件以显示不同的内容。

条件控制采用con标记，语法为“con=条件1#-条件2”，表示当条件1满足，或者条件2不满足时，显示con标记后的内容。下面的例子给出了使用该条件的一个模板：

{{鐵道路線|lua=1
| 模板名稱 = 上海轨道交通13号线车站
| 名稱 = [[上海轨道交通13号线]]
| 代表色 = {{上海地铁标志色|13|s}}
| Logo = [[File:Shanghai Metro logo.svg|20px|上海地铁标志]]
| 显示条件 = {{{2|}}}
| 車站列表 = con=-SB ~ 金运路 ~ 金沙江西路 ~ 丰庄 ~ 祁连山南路 ~ 真北路 ~ 大渡河路 ~ 金沙江路 ~ 隆德路 ~ 武宁路 ~ 长寿路站 (上海) ~ con=F ~ style=color:#888 ~ 江宁路 ~ 汉中路 ~ 自然博物馆 ~ 南京西路 ~ 淮海中路 ~ 一大会址·新天地 ~ con=F#SB ~ 马当路 ~ 世博会博物馆 ~ 世博大道 ~ con=F ~ 长清路 ~ 成山路 ~ 东明路站 (上海) ~ 华鹏路 ~ 下南路 ~ 北蔡 ~ 陈春路 ~ 莲溪路 ~ 华夏中路 ~ 中科路 ~ 学林路 ~ 张江路
}}

如果需要显示上海轨道交通13号线世博专线的内容，只需要将参数2填写为SB，此时模板将隐藏金运路站至新天地站以及长清路至张江路之间的车站：

如果需要显示2014年年底运营的线路，只需要保留参数2为空，此时江宁路至张江路的车站将不会显示：

如果需要显示整条线路，只需要将参数2置为F：

支线[编辑]

线路中，“blstart”、“blline”、“blend”三个标记表示支线开始、下一支线以及支线结束，可方便地书写较短的支线线路。如

blstart ~ （[[杭州至绍兴城际铁路|杭绍城际]]←）#中国轻纺城 ~ 瓜渚湖 ~ 镜水湖 ~ blline ~ 会展中心站 (绍兴市)!会展中心 ~ 绍兴北站 (地铁)!绍兴北站 ~ 大庆寺 ~ 高教园区 ~ 群贤路 ~ blend ~ 站前大道 ~ 绿云路 ~ 奥体中心站 (绍兴市)

将会输出

（杭绍城际←）中国轻纺城 – 瓜渚湖 – 镜水湖
会展中心 – 绍兴北站 – 大庆寺 – 高教园区 – 群贤路

> 站前大道 – 绿云路 – 奥体中心

模块会根据 blstart 左侧是否有其他车站决定支线文字的对齐方向和分隔符。相关情形列举如下

情形	对齐	分隔符变更
左侧无站	右对齐	右侧车站前分隔符改为“>”
右侧无站	左对齐	左侧车站前分隔符改为“<”
两侧均有站	左对齐	左、右侧车站前分隔符分别改为“<”和“>”

在两侧均有站的情况下，可能需要使站名居中以使得显示更为美观。此时，可通过“blstart=center”手动设置居中。如

乔司站 (铁路) ~ 笕桥 ~ blstart=center ~ 杭州东 ~ 盈宁 ~ 杭州南 ~ blline ~ 艮山门 ~ 杭州 ~ 南星桥站 (中国铁路)!南星桥 ~ 钱塘江 ~ 萧山西 ~ blend ~ 萧山 ~ 湄池 ~ 诸暨东

将会输出

乔司 – 笕桥 <

杭州东 – 盈宁 – 杭州南
艮山门 – 杭州 – 南星桥 – 钱塘江 – 萧山西

> 萧山 – 湄池 – 诸暨东

换行[编辑]

使用 line 标记可以换行。例如，

沪昆线：#杭州东 ~ 盈宁 ~ 杭州南 ~ line ~ 绕行线：#艮山门 ~ 杭州 ~ 南星桥站 (中国铁路)!南星桥 ~ 钱塘江 ~ 萧山西

将输出

沪昆线：杭州东 – 盈宁 – 杭州南
绕行线：艮山门 – 杭州 – 南星桥 – 钱塘江 – 萧山西

对于支线，使用 line 标记时，模块将结束支线模式，同时不会输出“>”符号。

测试用例[编辑]

本模块使用Module:UnitTests提供集成测试，测试代码见Module:RouteSequence/testcases。