Brontekst bekijken van Sjabloon:S-line/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

{{Esoteric}}

''S-line'' is a specialised [[Template:S-start|succession box]] template that links railway station articles. 

'''Note''': this template is called by {{t1|s-rail-national}}; an alias. If a change is made which alters/adds parameters names that template must be updated to reflect the new situation.

===Usage===

S-line must be encased within {{tl|s-rail-start}} and {{tl|s-end}}. The use of {{tl|s-rail}} is highly recommended but not required.

S-line has the following parameters:

{| class="wikitable"
!Parameter!!Description!!Notes
|-
|system||The system to which the line belongs||This should correspond to an entry in [[:Template:S-rail/lines]]
|-
|line||The name of the line||This should be obvious shorthand (e.g. Orange for Orange Line)
|-
|previous||The name of the previous station||
|-
|next||The name of the next station||
|-
|type||The left-hand line branch||''Optional''
|-
|type2||The right-hand line branch||''Optional''
|-
|note||Information about the left-hand line branch||''Optional''
|-
|note2||Information about the right-hand line branch||''Optional''
|-
|notemid||Information about the station itself||''Optional''
|-
|oneway1||Indicates that trains do not operate towards the Previous station||''Optional''
|-
|oneway2||Indicates that trains do not operate towards the Next station||''Optional''
|-
|rows1, hide1||Used to have the Previous Station box cover multiple lines. See below for details.||''Optional''
|-
|rows2, hide2||Used to have the Next Station box cover multiple lines. See below for details.||''Optional''
|-
|rowsmid, hidemid||Used to have the middle (Line) box cover multiple lines. See below for details.||''Optional''
|-
|transfer||Used to show lines available by direct transfer at an adjoining station. See below for details.||''Optional''
|-
|branch||Used to denote specific line branch information, in lieu of or in addition to the <code>type</code> parameters.||''Optional''
|-
|state1, state2||Allows the passing of an additional station parameter. Useful for disambiguation.||''Optional''
|-
|through1, through2||Allows, instead of a next station, service passing to another line on the system.||''Optional''
|}

==Making it work==

S-line depends on sub-templates for the proper display of information. For an example, here are the templates necessary to properly display this box (a version of which is at [[Kalamazoo Transportation Center]]:

{{s-rail-start}}
{{s-rail|title=Amtrak}}
{{s-line|system=Amtrak|line=Wolverine|previous=Dowagiac|next=Battle Creek}}
{{s-end}}

First of all, here's the underlying code:

<pre>
{{s-rail-start}}
{{s-rail|title=Amtrak}}
{{s-line|system=Amtrak|line=Wolverine|previous=Dowagiac|next=Battle Creek}}
{{s-end}}
</pre>

[[:Template:S-rail-start]] is a variant of the generic template {{t1|s-start}} used to begin thousands of succession boxes. '''Important note:''' No form of start template ({{tl|s-rail-start}} or {{tl|s-start}}) is needed when the succession box is in side the ''service'' parameter of {{tl|Infobox rail line}}. [[:Template:S-rail]] is used to generate headings for each grouping of rail services in a box. Here we have only one, but some particularly large terminals may have three or four (see [[Union Station (Chicago)]] or [[30th Street Station]]). S-rail uses the translation table at [[:Template:S-rail/lines]]; if the entry is undefined, it simply links the text. Therefore, Amtrak produces [[Amtrak]], while LUL gives [[London Underground]].

You can see that S-line takes only parameters &ndash; no linking necessary! S-line accomplishes this through two assumptions: (1) groups of articles on train stations are named in a predictable manner; (2) redirects are cheap. For S-line to produce the table above five separate templates were defined. Before discussing them, however, let's review the parameters:
* SYSTEM: The company or grouping to which the line belongs. This is case-sensitive and must be consistent. In this case, the value is '''Amtrak'''.
* LINE: The line name. This is also case-sensitive and must be consistent throughout. Here, we're describing the '''Wolverine'''.
* PREVIOUS and NEXT: The names of the previous and next stations on the line. Current convention suggests West/East Left/Right, followed by North/South, but your mileage may vary. Whenever possible, succession boxes should make geographic sense (i.e. don't have one line running west-east and the other east-west).

You need templates to define the following things: the formatting/linking of the line, the formatting/linking of the previous and next stations, the display of the line's colour, and the display of the appropriate termini &ndash; all automatic.

===Line===

<nowiki>[[Template:{{{SYSTEM}}} lines]]</nowiki> ([[:Template:Amtrak lines]])

This template carries a translation table for the formatting/linking of the line. The template receives one parameter, <nowiki>{{{1}}}</nowiki> from S-line. With systems that have unusual or non-uniform naming, like Amtrak, it may be necessary to have a test case for every line. The relevant line from [[:Template:Amtrak lines]] is this:
<pre>| Wolverine=''[[Wolverine (passenger train)|Wolverine]]''</pre>
This links to the article on the ''Wolverine'' and italicizes the article, appropriate for a named train. This means if the article ever moves, you need only to update switch statement, not individual articles. When a system has uniform naming, you may be able to get away with a default case and only one or two exceptions, as in [[:Template:LUL lines]]:
<pre>
{{#switch:{{{1}}}
 | #default=[[{{{1}}} Line]]
}}
</pre>

===Station===

<nowiki>[[Template:{{{SYSTEM}}} stations]]</nowiki> ([[:Template:Amtrak stations]])

This template carries a translation table for the formatting/linking of the line. The template receives two parameters from S-line, <nowiki>{{{station}}}</nowiki> and <nowiki>{{{line}}}</nowiki>, although use of the latter is not often necessary. Station will be either the PREVIOUS or NEXT parameter; both are handled the same way behind the scenes. The easiest way to start the station template is with the default case that reflects how articles on system stations are named. With Amtrak, it's done this way:
<pre> | #default=[[{{{station}}} (Amtrak station)|{{{station}}}]]</pre>
Therefore, "Dowagiac" produces <nowiki>[[Dowagiac (Amtrak station)|Dowagiac]]</nowiki>, all linked and ready to go.

===Colour===

<nowiki>[[Template:{{{SYSTEM}}} color]]</nowiki> ([[:Template:Amtrak color]])

Note that colour is spelled the American way in the template; the creator apologizes in advance and it's probably not worth the hassle to change it at this stage. This template is designed the same way as the others except that a default case is rare--lines within a system tend to have a different colour. Amtrak is an important exception, and doesn't even have a switch statement: the template consists only of the hex code: 004670. The pound sign is included within s-line so it isn't necessary. This also forces the use of hex codes; no nouns are permitted (e.g. red, white). The template takes one parameter, <nowiki>{{{1}}}</nowiki>. A good example is found here at [[:Template:SEPTA color]]:
<pre>
{{#switch:{{{1}}}
 | Broad Street=F58735
 | Market-Frankford=0081C4
 | Subway-Surface=5D9842
 | Route 100=993F96
 | Route 101
 | Route 102=AF5F18
 | R1=F9EF02
 | R2=A80058
 | R3=F9812A
 | R5=0255A1
 | R6=049471
 | R7=E63641
 | R8=CF731E
}}
</pre>

===Termini===

<div><nowiki>[[:Template:S-line/{{{SYSTEM}}} left/{{{LINE}}}]]</nowiki> ([[:Template:S-line/Amtrak left/Wolverine]])</div>
<div><nowiki>[[:Template:S-line/{{{SYSTEM}}} right/{{{LINE}}}]]</nowiki> ([[:Template:S-line/Amtrak right/Wolverine]])</div>
These are the all-important templates which produce the "towards..." part of the templates. They can also get pretty tricky depending on the setup. The ''Wolverine'' is an easy example. It runs end-to-end from Chicago, Illinois to Pontiac, Michigan. Therefore, the "left" (westbound) template contains "Chicago" while the "right" (eastbound) template contains "Pontiac". These names are plugged in to the STATION template just as NEXT and PREVIOUS were, with the results that you can see above. A feature of S-line is that if it detects that the next station is the name as the terminus, it will display a note to that effect instead of the destination. Hence,
<pre>
{{s-rail-start}}
{{s-rail|title=Amtrak}}
{{s-line|system=Amtrak|line=Wolverine|previous=Chicago|next=Battle Creek}}
{{s-end}}
</pre>
produces:
{{s-rail-start}}
{{s-rail|title=Amtrak}}
{{s-line|system=Amtrak|line=Wolverine|previous=Chicago|next=Battle Creek}}
{{s-end}}

Now, let's say we've got a more complicated example, like the ''[[Lake Shore Limited]]'', which runs from Chicago east to either Boston or New York. The ''Limited's'' "left" template is still a simple line of text &ndash; Chicago &ndash; but the "right" template needs a switch statement. The left and right templates receive one parameter, <nowiki>{{{type}}}</nowiki>, from s-line, which tells them which termini to return. Here's the ''Limited's'' "right" template:
<nowiki>
{{#switch:{{{type}}}
|Both=New York or Boston South
|New York=New York
|Boston=Boston South
}}
</nowiki>
This allows three eastbound destinations: New York, Boston, or both if the train hasn't reached the junction point yet. A default statement is acceptable here if it is true for disproportionate length of the line. In order to make this work properly, you have to define the concept of "New York or Boston South" in the STATION template, like so:
<pre> | New York or Boston South=[[Pennsylvania Station (New York City)|New York]] or [[Boston South (Amtrak station)|Boston South]]</pre>
Here's a hypothetical example of this at work:
<pre>
{{s-rail-start}}
{{s-rail|title=Amtrak}}
{{s-line|system=Amtrak|line=Lake Shore Limited|previous=Chicago|next=Battle Creek|type2=Both}}
{{s-end}}
</pre>
'''produces'''
{{s-rail-start}}
{{s-rail|title=Amtrak}}
{{s-line|system=Amtrak|line=Lake Shore Limited|previous=Chicago|next=Battle Creek|type2=Both}}
{{s-end}}

===One-way operation===

For rail lines that operate in only one direction (such as going around a loop), the ''oneway1'' or ''oneway2'' parameters are used, to indicate that the Previous or Next station, respectively, does not have service going towards it. When these parameters are present with any non-null value, the ''toward [Terminal]'' line is replaced with ''One-way operation''. For example, for a CTA station in the Chicago Loop:
<pre>{{s-rail-start}}
{{s-rail|title=CTA}}
{{s-line|system=CTA|line=Brown|previous=Clark/Lake|next=Randolph/Wabash|type=Kimball|oneway2=true}}
{{s-line|system=CTA|line=Green|previous=Clark/Lake|next=Randolph/Wabash|type2=Both}}
{{s-line|system=CTA|line=Orange|previous=Clark/Lake|next=Randolph/Wabash|oneway1=true|type2=Midway|rows1=3}}
{{s-line|system=CTA|line=Purple|previous=Clark/Lake|next=Randolph/Wabash|oneway1=true|type2=Linden|hide1=true}}
{{s-line|system=CTA|line=Pink|previous=Clark/Lake|next=Randolph/Wabash|oneway1=true|type2=54|hide1=true}}
{{s-end}}</pre>
Produces the box:
{{s-rail-start}}
{{s-rail|title=CTA}}
{{s-line|system=CTA|line=Brown|previous=Clark/Lake|next=Randolph/Wabash|type=Kimball|oneway2=true}}
{{s-line|system=CTA|line=Green|previous=Clark/Lake|next=Randolph/Wabash|type2=Both}}
{{s-line|system=CTA|line=Orange|previous=Clark/Lake|next=Randolph/Wabash|oneway1=true|type2=Midway|rows1=3}}
{{s-line|system=CTA|line=Purple|previous=Clark/Lake|next=Randolph/Wabash|oneway1=true|type2=Linden|hide1=true}}
{{s-line|system=CTA|line=Pink|previous=Clark/Lake|next=Randolph/Wabash|oneway1=true|type2=54|hide1=true}}
{{s-end}}

===Parallel lines===

For lines that operate on the same tracks and serve the same next station and final terminal, the ''rows1'', ''rows2'', ''hide1'', and ''hide2'' optional parameters can be used to have the Previous (the 1s) or Next (the 2s) Station boxes cover more than one line. The rows parameters specify how many lines the station should cover, while the hide parameters ensure that the table formatting remains intact. The two parameters must be used together, with hide specified for every line that is being covered by the first line. An example of this use can be seen in the preceding CTA box. Note that, in the preceding CTA example, the ''previous'' and ''oneway1'' parameters could have been omitted from the Purple and Pink line entries, but were left in for consistency's sake.

Another example of this:
<pre>{{S-start}}
{{S-rail|title=LUL}}
{{S-line|system=LUL|line=Circle|previous=Westbourne Park|next=Paddington|type2=Aldgate|rows1=2}}
{{S-line|system=LUL|line=Hammersmith & City|previous=Westbourne Park|next=Paddington|hide1=yes}}
{{S-end}}
</pre>
'''Produces''':
{{S-start}}
{{S-rail|title=LUL}}
{{S-line|system=LUL|line=Circle|previous=Westbourne Park|next=Paddington|type2=Aldgate|rows1=2}}
{{S-line|system=LUL|line=Hammersmith & City|previous=Westbourne Park|next=Paddington|hide1=yes}}
{{S-end}}

===Transfers===

The <code>transfer</code> parameter makes it possible to show within the box lines available at a different station with which there's a direct transfer from the current station. This snippet is taken from the article about the [[Finchley Road tube station]]. The [[North London Line]] does not actually serve the station itself, but there's an official out of system transfer designated between [[London Underground]] services at Finchley Road and [[London Overground]] services at the nearby [[Finchley Road & Frognal railway station|Finchley Road & Frognal]] station:
<pre>{{s-start}}
{{s-rail|title=LUL}}
{{s-line|system=LUL|line=Jubilee|previous=West Hampstead|next=Swiss Cottage|type2=one}}
{{s-line|system=LUL|line=Metropolitan|previous=Wembley Park|next=Baker Street|type=Four|rowsmid=2|rows2=2}}
{{s-line|system=LUL|line=Metropolitan|previous=Harrow-on-the-Hill|next=Finchley Road|type=Four|hidemid=yes|hide2=yes|note=Peak periods only}}
{{s-note|text=Out-of-system interchange}}
{{s-rail|title=LOG}}
{{s-line|system=LOG|line=North London|previous=West Hampstead|next=Hampstead Heath|transfer=Finchley Road & Frognal}}
{{s-end}}</pre>
'''Produces''':
{{s-start}}
{{s-rail|title=LUL}}
{{s-line|system=LUL|line=Jubilee|previous=West Hampstead|next=Swiss Cottage|type2=one}}
{{s-line|system=LUL|line=Metropolitan|previous=Wembley Park|next=Baker Street|type=Four|rowsmid=2|rows2=2}}
{{s-line|system=LUL|line=Metropolitan|previous=Harrow-on-the-Hill|next=Finchley Road|type=Four|hidemid=yes|hide2=yes|note=Peak periods only}}
{{s-note|text=Out-of-system interchange}}
{{s-rail|title=LOG}}
{{s-line|system=LOG|line=North London|previous=West Hampstead|next=Hampstead Heath|transfer=Finchley Road & Frognal}}
{{s-end}}

===Branches===

The <code>branch</code> parameter can be used to describe a subset of a <code>line</code>. In the example hereafter, the <code>branch</code> parameter designates four different parts of the MBTA Green Line. When passed to the left and right termini templates, the <code>branch</code> and <code>line</code> parameters identify destinations. Additionally, the branch name is displayed beneath the line name.

Optionally, <nowiki>[[Template:{{{SYSTEM}}} lines/branches]]</nowiki> may be defined, which allows the linking of the branch parameter.

In this example below, the branch template ([[:Template:MBTA lines/branches]]) is defined, allowing branch linking. Additionally, left and right termini are returned based on the passed <code>branch</code> parameter:

<pre>{{s-rail-start}}
{{s-rail|title=MBTA}}
{{s-line|system=MBTA|line=Green|branch="B" Branch|previous=Copley|next=Boylston|rows2=2}}
{{s-line|system=MBTA|line=Green|branch="D" Branch|previous=Copley|next=|hide2=yes}}
{{s-line|system=MBTA|line=Green|branch="C" Branch|previous=Copley|next=Boylston}}
{{s-line|system=MBTA|line=Green|branch="E" Branch|previous=Copley|next=Boylston}}
{{s-end}}</pre>

{{s-rail-start}}
{{s-rail|title=MBTA}}
{{s-line|system=MBTA|line=Green|branch="B" Branch|previous=Copley|next=Boylston|rows2=2}}
{{s-line|system=MBTA|line=Green|branch="D" Branch|previous=Copley|next=|hide2=yes}}
{{s-line|system=MBTA|line=Green|branch="C" Branch|previous=Copley|next=Boylston}}
{{s-line|system=MBTA|line=Green|branch="E" Branch|previous=Copley|next=Boylston}}
{{s-end}}

In this example hereafter, taken from the [[Acton Town tube station]] article, the branch template ([[:Template:LUL lines/branches]]) is defined, allowing branch linking. Additionally, through the <code>branch</code> parameter, the left and right hand terminis are generated. In some cases, a <code>type</code> parameter can be used to supplement the <code>branch</code> parameter. If necessary, a <code>notemid=</code> parameter can be used to substitute for a <code>branch</code> parameter.

<pre>
{{s-start}}
{{s-rail|title=LUL}}
{{s-line|system=LUL|line=District|previous=Ealing Common|next=Chiswick Park|type=Ealing Broadway|type2=One}}
{{s-line|system=LUL|line=Piccadilly|type=Uxbridge|notemid=[[Piccadilly line#Uxbridge branch|Uxbridge branch]]|previous=Ealing Common|next=Turnham Green|note2=Early morning and late evening service only|rowsmid=2|rows1=2}}
{{s-line|system=LUL|line=Piccadilly|branch=Uxbridge|previous=Ealing Common|next=Hammersmith|hidemid=yes|hide1=yes}}
{{s-line|system=LUL|line=Piccadilly|branch=Heathrow|previous=South Ealing|next=Turnham Green|note2=Early morning and late evening service only|rowsmid=2|rows1=2}}
{{s-line|system=LUL|line=Piccadilly|branch=Heathrow|previous=South Ealing|next=Hammersmith|hidemid=yes|hide1=yes}}
{{s-end}}</pre>
'''produces:'''
{{s-start}}
{{s-rail|title=LUL}}
{{s-line|system=LUL|line=District|previous=Ealing Common|next=Chiswick Park|type=Ealing Broadway|type2=One}}
{{s-line|system=LUL|line=Piccadilly|type=Uxbridge|notemid=[[Piccadilly line#Uxbridge branch|Uxbridge branch]]|previous=Ealing Common|next=Turnham Green|note2=Early morning and late evening service only|rowsmid=2|rows1=2}}
{{s-line|system=LUL|line=Piccadilly|branch=Uxbridge|previous=Ealing Common|next=Hammersmith|hidemid=yes|hide1=yes}}
{{s-line|system=LUL|line=Piccadilly|branch=Heathrow|previous=South Ealing|next=Turnham Green|note2=Early morning and late evening service only|rowsmid=2|rows1=2}}
{{s-line|system=LUL|line=Piccadilly|branch=Heathrow|previous=South Ealing|next=Hammersmith|hidemid=yes|hide1=yes}}
{{s-end}}

===Styles===

<nowiki>[[Template:{{{SYSTEM}}} style]]</nowiki> ([[:Template:Amtrak style]])

The style template allows the modification, at a system level, of display parameters for inter-related templates, including [[:Template:Infobox Station]].

{| class="wikitable"
!Parameter!!Description!!Notes
|-
|lang||Which version of English to output display in. Specify GB for British; the default is US. If '''GB''' is specified, the boxes will say "towards" (station). If '''US''' is specified, the boxes will say "toward" (station).||''Optional; S-line only''
|-
|name_format||Formatting for the <code>{{{name}}}</code> parameter itself||''Optional; Infobox Station only''
|-
|showterm||A "No" value suppresses the display of termini information||''Optional; S-line only''
|-
|stop_noun||Type of stop (e.g. station, tram stop); default is "station"||''Optional; S-rail only''
|-
|thcolor||Font color for table headings||''Optional; Infobox Station only''
|-
|thbgcolor||Background color for table headings||''Optional; Infobox Station only''
|-
|title_nowrap||If "yes", will apply the nowrap style to s-rail headings. Not recommended for use within Infobox Station||''Optional; S-rail only''
|}

===See also===
* {{tiw|s-rail-start}}
* {{tiw|s-rail}}
* {{tiw|s-rail-next}}
* {{tiw|s-note}}
* {{tiw|s-end}}

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Exclude from print]]
[[Category:Rail transport succession templates|{{PAGENAME}}]]
</includeonly>