Template:Adjacent stations/doc

This is a documentation subpage for Template:Adjacent stations.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 40,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Shortcut

{{adjstn}}

This template uses TemplateStyles:

Template:Adjacent stations/styles.css

Adjacent stations is a specialised succession box template that links adjacent station articles, along with the termini of one or more lines or services. It is a Lua version of {{S-line}} (see differences).

Usage

Data module

Before the template can be used, a module needs to be created that includes information about the transport system such as the title, lines and the termini of those lines. The data module needs to be a sub-page of Module:Adjacent stations (Module:Adjacent stations/system), and needs to be of a specific structure.

See Module:Adjacent stations for a guide on creating and editing data modules. Note that not all variables are used by this template.

If a system exists in {{S-line}}, you can also use {{Adjacent stations/row|system|line}} inside Special:ExpandTemplates to simplify subpage creation for lines with two termini. You will need to replace every two spaces with a tab space afterwards.

Transclusion

For multiple lines or systems, this template only needs to be transcluded once. Each line is assigned a number. The parameters for the corresponding line are suffixed by the number (e.g. system2, line2). Parameters without a number suffix are treated as group 1.

Parameters


Parameter	Description	Behaviour if absent	Notes
system`n`	The system to which line `n` belongs. This should correspond to a subpage of Module:Adjacent stations.	System for `n` assumed to be same as the previous group. Renders empty table if no systems are entered.	Displays error message if unrecognised.
line`n`	The name of line `n` (or recognised alias). This should correspond to a key under `["lines"]` in data. Displays the termini of the line as subtext in left and right cells by default. Renders Terminus as subtext if adjacent station is terminus.	Line for `n` assumed to be same as the previous group. Renders only header row if no lines are entered.	Displays error message if unrecognised.
left`n`	The name of the previous station. Renders the formatted station name in the left cell as main text.	Renders Terminus in the left cell as main text.
right`n`	The name of the next station. Renders the formatted station name in the right cell as main text.	Renders Terminus in the right cell as main text.
to-left`n`	The left terminus name or alias. Used to replace left terminus where it is non-default.	Uses default left terminus.	Uses un-formatted name if terminus is absent in data.
to-right`n`	The right terminus name or alias. Used to replace right terminus where it is non-default.	Uses default right terminus.	Uses un-formatted name if terminus is absent in data.
to`n`	Terminus name or alias on either side. Used to replace either terminus where it is non-default.	Uses default termini.	Only replaces side with defined terminus in data.
transfer`n`	The name of the transfer station for the line, at stations where an interchange with a line at another nearby station is possible.
oneway-left`n`	If entered, 'One-way operation' is displayed in the left cell instead of the small text which indicates the line terminus. This can also be entered for the whole line in the system subpage.
oneway-right`n`	If entered, 'One-way operation' is displayed in the right cell instead of the small text which indicates the line terminus. This can also be entered for the whole line in the system subpage.
nonstop`n`	If entered, instead of displaying previous and next stations, displays '`line` does not stop here'. If the value for this parameter is 'former', then 'did not stop here' will be used instead.
header`n`	A table header across the width of the table, displayed above the succession for the line. This will display with or without other parameters with the same number.
hide-system`n`	When set to any value, the system row is not displayed. This is useful in the middle of a table when a different module is used but the displayed system name would be the same.	System name is displayed.	See Coevorden railway station for an example.
note-row`n`	A note across the width of the table, displayed below the succession for the line. This will display with or without other parameters with the same number.
note-left`n`	A note, displayed below the left (previous) station's name.
note-mid`n`	A note, displayed below the line name.
note-right`n`	A note, displayed below the right (next) station's name.
through`n`	The through line – trains on the line run through to this line. If this is entered, 'through to `line'`, in italics, displays where 'Terminus' would.
through-left`n`	The through line for the left cell only (primarily for compatibility purposes).
through-right`n`	The through line for the right cell only (primarily for compatibility purposes).
reverse`n`	If this is entered, 'reverses direction', in italics, displays where 'Terminus' would.
reverse-left`n`	The same for the left cell only (primarily for compatibility purposes).
reverse-right`n`	The same for the right cell only (primarily for compatibility purposes).
noclear	Prevents the template from inserting the equivalent of {{clear}} before the template. In the article body, this parameter can be set to `y` for an inline version of the template. Do not use this parameter inside {{Infobox station}}'s `\|services=` parameter.	The equivalent of {{clear}} is inserted before the template. This is the default.

Conversion from S-line

After creating the module subpage, you can use the convert function of Module:Adjacent stations to replace transclusions of the S-line series templates (this currently does not work with {{Rail line}}-series templates). This can be semi-automated using regular expressions in AWB and other tools:

Find	Replace	Notes
\\|\ssystem\s=\s*`oldSystem`	\|system=`newSystem`	Replacement for system name in {{S-line}}, if the old system is different from the new system. (Not necessary for {{S-rail}}, which is ignored.) Use the g regular expression flag to replace multiple uses.
(\\| (?:services\|other_services) =)((?:\s*\{\{.+\}\})+)	`$1 {{subst:#invoke:Adjacent stations\|convert\|$2}}`	Replacement for {{Infobox station}}'s `\|services=` and `\|other_services=` parameters.
(\{\{[Ss](?:(?:-rail)?-s)?tart\}\}(?:\s\{\{.+\}\})+\s\{\{(?:[Ss]-end\|[Ee]nd)\}\})	{{subst:#invoke:Adjacent stations\|convert\|$1}}	Replacement for standalone succession boxes. Use the g regular expression flag to replace multiple boxes on the page.

The conversion will not work if

the input includes templates other than those in the S-line series;
a system or line in the input is unrecognized or otherwise invalid;
there are unmatched square or curly brackets in the input.

Differences from S-line

The output of {{Adjacent stations}} is nearly identical to that of {{S-line}}, but is used differently. Here are lists of comparable elements in the two templates.

Data

Item	{{S-line}}	{{Adjacent stations}}
System name, title and icon	In {{S-rail/lines}}	Subpage name, values of `["system title"]` and `["system icon"]`
Line name and title	In Template:system lines	Key beneath `["lines"]` and value of `["title"]` beneath the corresponding line
Branch/type name and title	In Template:system branches	Key beneath `["types"]` and value of `["title"]` beneath the corresponding type
Station format	In Template:system stations	Key–value pairs beneath `["station format"]`
Colour	In Template:system color	Value of `["color"]` beneath the corresponding line or type
Left terminus name	In Template:S-line/system left/line	Value of `["left terminus"]` beneath the corresponding line
Right terminus name	In Template:S-line/system right/line	Value of `["right terminus"]` beneath the corresponding line

Transclusion parameters

{{S-line}}	{{Adjacent stations}}
`system`	`system`
`line`	`line`
`previous`, `next`	`left`, `right`
`type`, `type2`	`to-left`, `to-right`
New feature	`to` (for both sides)
{{S-text}}	`note-row`
`note`, `notemid`, `note2`	`note-left`, `note-mid`, `note-right`
{{S-note}}	`header`
`oneway1`, `oneway2`	`oneway-left`, `oneway-right`
`rows1`, `hide1`	Not needed
`rows2`, `hide2`	Not needed
`rowsmid`, `hidemid`	Not needed
`transfer`	`transfer`
`circular`, `circular1`, `circular2`	Must be set for whole line in data
`round1`, `round2`	`reverse` (for both sides), `reverse-left`, `reverse-right`
`branch`	`type`
`state1`, `state2`	Not implemented
`through1`, `through2`	`through-left`, `through-right`

Examples

Markup

Renders as

{{Adjacent stations
|system=JR East
|line=Tohoku Shinkansen|type=Yamabiko
|left=Fukushima|right=Sendai
}}

Module:Adjacent stations/JR East
(Shiroishi-Zaō Station)

Preceding station	JR East			Following station
Fukushima towards Tokyo		Tōhoku Shinkansen Yamabiko		Sendai towards Morioka

{{Adjacent stations
|system=New York City Subway
|line=Rockaway
|left=Rockaway Boulevard|right=Aqueduct–North Conduit Avenue
|oneway-right=yes
}}

Module:Adjacent stations/New York City Subway
(Aqueduct Racetrack station)

Preceding station	New York City Subway			Following station
Rockaway Boulevard toward Inwood–207th Street				Aqueduct–North Conduit Avenue One-way operation

{{Adjacent stations
|system=London Underground
|line1=Bakerloo|left1=Regent's Park|right1=Piccadilly Circus
|line2=Central|left2=Bond Street|right2=Tottenham Court Road
|line3=Victoria|left3=Green Park|right3=Warren Street
}}

Module:Adjacent stations/London Underground
(Oxford Circus tube station)

Preceding station		Following station
Regent's Park towards Harrow & Wealdstone	Bakerloo line	Piccadilly Circus towards Elephant & Castle
Bond Street towards Ealing Broadway or West Ruislip	Central line	Tottenham Court Road towards Epping, Hainault or Woodford via Newbury Park
Green Park towards Brixton	Victoria line	Warren Street towards Walthamstow Central

{{Adjacent stations
|system=Walt Disney World Monorail
|line1=Resort|left1=Contemporary|right1=Polynesian Village
|oneway-left1=yes
|line2=Express|left2=Magic Kingdom|right2=Magic Kingdom
|oneway-right2=yes
|line3=Epcot|right3=Epcot
}}

Module:Adjacent stations/Walt Disney World Monorail
(Transportation and Ticket Center)

Preceding station		Following station
Disney's Contemporary Resort One-way operation	Resort Line	Disney's Polynesian Village Resort Next clockwise
Magic Kingdom Park Next counter-clockwise	Express Line	Magic Kingdom Park One-way operation
Terminus	Epcot Line	Epcot Terminus

{{Adjacent stations
|system1=Taiwan High Speed Rail
|left1=Nangang|right1=Banqiao
|system2=Taiwan Railways
|line2=West Coast|left2=Songshan|right2=Wanhua
}}

Module:Adjacent stations/Taiwan High Speed Rail
Module:Adjacent stations/Taiwan Railways
(Taipei Main Station)

Preceding station	Taiwan High Speed Rail		Following station
Nangang Terminus		THSR	Banqiao towards Zuoying
Preceding station	Taiwan Railway		Following station
Songshan towards Keelung		Western Trunk line	Wanhua towards Pingtung

{{Adjacent stations
|system=RTA Rapid Transit
|line1=Red
|left1=West 25th–Ohio City|right1=Tri-C–Campus District
|line2=Blue
|through-left2=Waterfront Line|right2=Tri-C–Campus District
|line3=Green
|through-left3=Waterfront Line|right3=Tri-C–Campus District
|line4=Waterfront
|left4=Settlers Landing|through-right4=Blue and Green Lines
}}

Module:Adjacent stations/RTA Rapid Transit
(Tower City station)

Preceding station		Following station
West 25th–Ohio City toward Airport	Red Line	Tri-C–Campus District toward Windermere
through to Waterfront Line	Blue Line	Tri-C–Campus District toward Warrensville–Van Aken
through to Waterfront Line	Green Line	Tri-C–Campus District toward Green Road
Settlers Landing toward South Harbor	Waterfront Line	through to Blue and Green Lines

{{Adjacent stations
|system=MTR
|line1=Tung Chung|left1=Tsing Yi|right1=Tung Chung
|line2=Disneyland Resort|right2=Disneyland Resort
|line3=Airport Express|nonstop3=yes
}}

Module:Adjacent stations/MTR
(Sunny Bay station)

Preceding station		Following station
Tsing Yi towards Hong Kong	Tung Chung line	Tung Chung Terminus
Terminus	Disneyland Resort line	Disneyland Resort Terminus
Airport Express does not stop here