imported>Cygz：WP:NFCC#9

2026-05-08T21:03:53Z

新页面

{{Lua|Module:Yesno|Module:Arguments|Module:Color contrast}}
{{Sidebar Adjacent stations}}
{{High-use|29734}}
{{NoteTA|G1=IT}}

本模块实现{{tl|Adjacent stations}}、{{tl|Rail icon}}、{{tl|Rail color box}}、{{tl|Line link}}、{{tl|Station link}}和{{tl|Rail color}}的功能。欲了解如何使用这些模板，请参阅其文档。（本模块的<code>convert</code>函数的指引置于{{tl|Adjacent stations}}的文档。）

前述的模板依赖于本模块的[[#子模块|子模块]]所存放的数据。例如，{{tl|Rail icon|Paris Métro}}从[[Module:Adjacent stations/Paris Métro]]生成{{Rail icon|Paris Métro}}。

下列示例对创建和编辑数据会有帮助，但有一定Lua基础能避免一些错误。如果你之前编写或是使用过Lua，你可以跳过下一小节。

== 术语 ==
{{for|更全面的Lua概述|:mw:Extension:Scribunto/Lua reference manual}}

* Lua有不同的数据类型（{{Lang|en|data types}}）。此处将会涉及到的有布尔型（{{Lang|en|boolean}}）、字符串（{{Lang|en|string}}）、数字（{{Lang|en|number}}）和表（{{Lang|en|table}}）。
** 布尔型数据只能是<code>true</code>（真）或<code>false</code>（假）。
** 字符串即文本，以字符列表的形式存储。Lua有数种方式在代码中表记字符串，此处的示例使用双引号包裹的方式表记（如<code>"这是一个字符串"</code>）。
** 数字即数值，像<code>0.5</code>或<code>42</code>。
** 表是可以包含其他对象的结构，并支持嵌套。
*** 空表在代码中形如<code>{}</code>。
*** 表有键（{{Lang|en|key}}）和值（{{Lang|en|value}}）典型结构如<code>["<var>key</var>"] = <var>value</var></code>；键值对（{{Lang|en|key-value pair}}）之间由西文逗号分隔。此处使用的键都是字符串或数字。
*** <code>{"text", "more text"}</code>等价于<code>{[1] = "text", [2] = "more text"}</code>。
* 使用<code>local <var>variable_name</var> = <var>"value"</var></code>可以定义一个变量（{{Lang|en|variable}}）。
* 空白（{{Lang|en|whitespace}}）包括制表符、换行符、空格及其任意组合。空白在Lua中不影响结果，但除了内置的文本，此处的所有示例都经过了缩进处理，根据键分行，以提高可读性。
* 返回语句（{{Lang|en|return statement}}，如<code>return <var>variable_name</var></code>）退出当前函数，并回报<code><var>variable_name</var></code>的值。此处的“函数”指主模块中调用子页面的代码，而<code><var>variable_name</var></code>应为表类型。

== 基本结构 ==
下面展示两个模块：
{|class="wikitable"
| [[Module:Adjacent stations/blank|空白]] || {{syntaxhighlight|lang=lua|{{Module:Adjacent stations/blank}}}}
|-
| [[Module:Adjacent stations/高雄捷運|示例]] || {{syntaxhighlight|lang=lua|{{Module:Adjacent stations/高雄捷運}}}}
|}
示例模块为[[Module:Adjacent stations/高雄捷運]]。
* 首先需要两条记录，<code>"station format"</code>和<code>"lines"</code>。前者用于生成指向车站条目的链接，后者包括各线路的表。
* <code>"system title"</code>是标题行中间的文本。
* <code>"station format"</code>定义车站条目名称的规则和例外。第一个变量<code>"%1 metro station"</code>是默认值。例外由键值对列出（如<code>"岡山"</code>–<code>"岡山車站"</code>），此处键是输入值。模块显示输入值，并根据处理后的值链接到条目，其中<code>%1</code>将被输入值替代。或者，也可以直接键入完整的维基链接，这样显示文本就可以与输入值不同。
* <code>"lines"</code>列出线路。此处的名称仅在内部使用，并不用于显示，所以请尽量简短。
* <code>"line title"</code>是显示在线路所在行中间的文本；<code>"left terminus"</code>是默认的左侧终点站，<code>"right terminus"</code>则是默认的右侧终点站。
* 每个<code>"color"</code>记录线路的颜色。
*首行定义的<code>x</code>是用于格式化车站名称的字符串。<code>"station format"</code>表中，<code>x</code>被用于数个需要“ (高雄捷运)”后缀的车站。这个方法是可选的，但在数个车站条目命名遵循另一条规则时相当有用。

以下是[[Module:Adjacent stations/台灣高鐵]]：
{{syntaxhighlight|lang=lua|{{Module:Adjacent stations/台灣高鐵}}}}
* 这个模块包括一条虚拟线路<code>["_default"]</code>。此处的标题和颜色被用于所有线路，除非被具体线路覆盖。当调用时不指定<code>line=</code>，此表就会被使用。

== 层级和参数列表 ==
# 表的第一层是整个系统的数据和输出选项。
# 系统表下层是线路的列表。
# 第三层是具体线路的数据。
# 每条线可以有多个“类型”。“类型”可以是服务类型（如不同速度等级）或线路的支线。
# 第五层是具体类型的数据。

未指明类型的键和值都是字符串。

=== 主层 (1) ===
{| class="wikitable"
|+
!参数
!类型
!被{{Tl|Adjacent stations}}使用
!描述
|-
|<code>["lang"]</code>
|{{No wrap|字符串}}
|{{Yes}}
|默认且仅有<code>"zh-CN"</code>，影响预置字符串的选择，本语言维基不使用此本地化方案，而是交由字词转换完成。
|-
|<code>["system title"]</code>
|字符串
|{{Yes}}
|标题行中间的文本。
|-
|<code>["system icon"]</code>
|字符串
|{{Yes}}
|{{tl|Adjacent stations}}标题行中间和{{tl|Rail icon}}使用的图标。
|-
|<code>["system icon format"]</code>
|字符串
|{{No}}
|图标类型，由{{tl|Rail icon}}使用。如果指定并且值不为<code>"image"</code>，图标数据将交由{{tl|Rail color box}}预处理。
|-
|<code>["system color"]</code>
|字符串
|{{No}}
|RGB十六进制三元值（三或六个字符长，如<code>"BE2D2C"</code>或<code>"039"</code>）。调用{{tl|Rail color}}时仅用一个参数时返回。
|-
|<code>["header stop noun"]</code>
|字符串
|{{Yes}}
|标题行左右单元格的“上一”和“下一”后使用的名词。默认值为<code>"station"</code>。
|-
|<code>["name format"]</code>
|字符串
|{{No}}
|{{tl|Infobox station}}表头的CSS，亦可使用{{para|1|header}}调用<code>style</code>函数取值。值可以为字符串或嵌套表，其中使用表的首层（对应{{tl|Infobox station}}的{{para|style2}}）。第二层目前未使用。嵌套表的第一项（无键项或键为<code>1</code>）为默认。
|-
|<code>["header background color"]</code>
|字符串
|{{No}}
|{{tl|Infobox station}}次表头使用的RGB十六进制三元值，亦可使用{{para|1|subheader}}调用<code>style</code>函数取值。默认为亮灰色。值可以为字符串或嵌套表，结构类似<code>"name format"</code>。
|-
|<code>["header text color"]</code>
|字符串
|{{No}}
|{{tl|Infobox station}}次表头使用的RGB十六进制三元值，亦可使用{{para|1|subheader}}调用<code>style</code>函数取值。默认根据背景色计算。值可以为字符串或嵌套表，结构类似<code>"name format"</code>。
|-
|<code>["station format"]</code>
|表或字符串
|{{Yes}}
|表包括车站格式化字符串。首条没有键的记录（也即键为<code>1</code>的记录）为默认，余下的记录须有匹配输入的键。没有维基链接括号的格式化字符串将会被转化为链接，输入（通常为车站名）将会被用作显示文本。本表可以嵌套表，用于表记传递给模板的线路和线路类型选项。
所有嵌套层级下的字符串都可以使用<code>%1</code>、<code>%2</code>和<code>%3</code>，分别用来表记输入的车站，输入的线路（经别名处理后）和输入的类型（经别名处理后）。
|-
|<code>["lines"]</code>
|表
|{{Yes}}
|包含数据的线路表。
|-
|<code>["aliases"]</code>
|表
|{{Yes}}
|包含线路（作为值）的别名（作为键）的表。所有的键都是小写，因为输入将被小写化，以实现大小写不敏感。
|}

=== 车站格式表 (2) ===
{| class="wikitable"
|+
!参数
!类型
!被{{Tl|Adjacent stations}}使用
!描述
|-
|<code>[1]</code>
|{{No wrap|字符串}}
|{{Yes}}
|默认格式。
|-
|<code>["''non-default station name''"]</code>
|字符串或表
|{{Yes}}
|不标准的车站格式，或是由线路确定的格式表。
|}

=== 依赖线路的格式表 (3) ===
{| class="wikitable"
|+
!参数
!类型
!被{{Tl|Adjacent stations}}使用
!描述
|-
|<code>[1]</code>
|{{No wrap|字符串}}
|{{Yes}}
|默认格式。
|-
|<code>["''line name''"]</code>
|字符串或表
|{{Yes}}
|不标准的车站格式，或是由类型确定的格式表。
|}

=== 依赖類型的格式表 (4) ===
{| class="wikitable"
|+
!参数
!类型
!被{{Tl|Adjacent stations}}使用
!描述
|-
|<code>[1]</code>
|{{No wrap|字符串}}
|{{Yes}}
|默认格式。
|-
|<code>["''type name''"]</code>
|字符串
|{{Yes}}
|不标准的车站格式。
|}

=== 线路表 (3) ===
可以添加虚拟线路<code>["_default"]</code>以为所有线路设定默认值。目前对两个参数有效。
{| class="wikitable"
!参数
!类型
!被{{Tl|Adjacent stations}}使用
!描述
|-
|<code>["title"]</code>
|{{No wrap|字符串}}
|{{Yes}}
|中间单元格显示的文本，通常是指向线路条目的链接。若不指定，将会使用<code>["_default"]</code>下的值（默认值中的<code>%1</code>为经别名处理的输入的线路）。
|-
|<code>["short name"]</code>
|字符串
|{{No}}
|{{tl|Rail color box}}使用的缩写。
|-
|<code>["icon"]</code>
|字符串
|{{No}}
|{{tl|Rail icon}}使用的图像。
|-
|<code>["icon format"]</code>
|字符串
|{{No}}
|{{tl|Rail icon}}使用的图像格式。如果指定并且值不为<code>"image"</code>，图像数据将交由{{tl|Rail color box}}预处理。
|-
|<code>["color"]</code>
|字符串
|{{Yes}}
|RGB十六进制三元值。如果线路自身没有指定值，将会回落到<code>["_default"]</code>颜色，乃至系统颜色；类型将依次尝试获取所在线路、<code>["_default"]</code>和系统颜色。颜色用于{{tl|Adjacent stations}}的第二和第四列，以及{{tl|Rail color box}}和{{tl|Rail icon}}的强调色。默认地，若类型和线路皆有颜色，那么线路颜色将会作为中间单元格背景色（见下一小节）。将类型背景色设为<code>""</code>或<code>"transparent"</code>可以避免。
|-
|<code>["background color"]</code>
|字符串
|{{Yes}}
|RGB十六进制三元值（三或六个字符）。颜色是可选的，并只在中间单元格线路名称后的背景显示。本模块会透明化颜色，使其上的文字可识读。
|-
|<code>["border color"]</code>
|字符串
|{{No}}
|{{tl|Rail color box}}使用的RGB十六进制三元值。
|-
|<code>["text color"]</code>
|字符串
|{{No}}
|{{tl|Rail color box}}使用的RGB十六进制三元值。
|-
|<code>["left terminus"]</code>
|字符串
|{{Yes}}
|通常是线路的左终点。若默认有多个值，应嵌套为顺序表（如<code>["left terminus"] = {"Chesham", "Amersham"}</code>）。表中的<code>["via"]</code>键可用于在其后加上“经”以及车站链接。
|-
|<code>["right terminus"]</code>
|字符串
|{{Yes}}
|通常是线路的右终点，表现同<code>["left terminus"]</code>。
|-
|<code>["note-mid"]</code>
|字符串
|{{Yes}}
|显示在线路和类型下方的默认小号文本。调用时由{{para|note-mid}}覆盖。
|-
|<code>["circular"]</code>
|布尔型
|{{Yes}}
|若值为<code>true</code>，终点文本将不会显示“往”。可以被类型覆盖。
|-
|<code>["oneway-left"]</code>
|布尔型
|{{Yes}}
|若值为<code>true</code>，那么左终点站处将会显示“单向运行”。
|-
|<code>["oneway-right"]</code>
|布尔型
|{{Yes}}
|对应oneway-left的右侧版本。
|-
|<code>["types"]</code>
|表
|{{Yes}}
|嵌套线路类型表的表。
|}

=== 类型表 (5) ===
{| class="wikitable"
!参数
!类型
!被{{Tl|Adjacent stations}}使用
!描述
|-
|<code>["title"]</code>
|{{No wrap|字符串}}
|{{Yes}}
|线路类型的名称。在{{tl|Adjacent stations}}中显示为普通大小的文本，位于中间单元格线路名称的下方；在{{tl|Rail color box}}中，某些选项下将显示在线路名称后，以带空格的[[en dash|同n宽连接号]]（亦用于不停站文本）。设为<code>""</code>可避免显示。
|-
|<code>["short name"]</code>
|字符串
|{{No}}
|{{tl|Rail color box}}使用的缩写。
|-
|<code>["icon"]</code>
|字符串
|{{No}}
|{{tl|Rail icon}}使用的图像。
|-
|<code>["icon format"]</code>
|字符串
|{{No}}
|{{tl|Rail icon}}使用的图像格式。如果指定并且值不为<code>"image"</code>，图像数据将交由{{tl|Rail color box}}预处理。
|-
|<code>["color"]</code>
|字符串
|{{Yes}}
|RGB十六进制三元值。如果线路自身没有指定值，将会回落到<code>["_default"]</code>颜色，乃至系统颜色；类型将依次尝试获取所在线路、<code>["_default"]</code>和系统颜色。颜色用于{{tl|Adjacent stations}}的第二和第四列，以及{{tl|Rail color box}}和{{tl|Rail icon}}的强调色。默认地，若类型和线路皆有颜色，那么线路颜色将会作为中间单元格背景色（见下一小节）。将类型背景色设为<code>""</code>或<code>"transparent"</code>可以避免。
|-
|<code>["background color"]</code>
|字符串
|{{Yes}}
|RGB十六进制三元值（三或六个字符）。颜色是可选的，并只在中间单元格线路名称后的背景显示。本模块会透明化颜色，使其上的文字可识读。
|-
|<code>["border color"]</code>
|字符串
|{{No}}
|{{tl|Rail color box}}使用的RGB十六进制三元值。
|-
|<code>["text color"]</code>
|字符串
|{{No}}
|{{tl|Rail color box}}使用的RGB十六进制三元值。
|-
|<code>["left terminus"]</code>
|字符串
|{{Yes}}
|通常是线路的左终点。若默认有多个值，应嵌套为顺序表（如<code>["left terminus"] = {"Chesham", "Amersham"}</code>）。表中的<code>["via"]</code>键可用于在其后加上“经”以及车站链接。
|-
|<code>["right terminus"]</code>
|字符串
|{{Yes}}
|通常是线路的右终点，表现同<code>["left terminus"]</code>。
|-
|<code>["note-mid"]</code>
|字符串
|{{Yes}}
|显示在线路和类型下方的默认小号文本。调用时由{{para|note-mid}}覆盖。
|-
|<code>["circular"]</code>
|布尔型
|{{Yes}}
|若值为<code>true</code>，终点文本将不会显示“往”。

|}

== 关于开发者 ==
本模块及其配套模版是由英语维基人进行编写和维护。中文维基版将会及时同步英文版本。如果您需要增加新功能，您需要在英文版本的讨论页面提出。

== 子模块 ==
{{subpagelist|Module:Adjacent stations|hideredirects=yes}}
<includeonly>{{Sandbox other||
[[Category:铁路运输前任继任模块| ]]
}}</includeonly>

Module:Adjacent stations/doc - 版本历史

imported>Cygz：​WP:NFCC#9

imported>Cygz：WP:NFCC#9