# Template:Rail-interchange/doc

The {{rail-interchange|…}} template is an abstraction layer to cope with rebranding and renaming of transport systems. The template maps $f(where,how) \to brand,link,icon(s)$ allowing the whole of Wikipedia to be easily updated when a transport network switches operator, changes name or updates their logo.

## Usage

The optional named parameter size will override the default height of the icon (from 10 to 20 pixels):

 {{rail-interchange|buenosaires|A|size=10}} {{rail-interchange|buenosaires|A}} {{rail-interchange|buenosaires|A|size=20}}

The value for size must be an integer and should not be any larger than the display height of the diagram icons themselves (20 pixels in most diagrams).

The icons' wikilink and alternate text can be overridden by adding the optional parameters |link=newlink and |alt=othertext. Note that if only the |link= parameter is changed then the |alt= parameter will change from the default to the new link text. (However, the |alt= parameter can be changed without affecting the link target.)

### In prose

Please avoid adding these icons within the prose of articles: per Wikipedia's Manual of Style for icons, "Icons should not be used in the article body... This breaks up the continuity of the text, distracting the reader".

In addition, icons used in this way are primarily decorative, e.g. "aesthetics are in the eye of the beholder: one reader's harmless decoration may be another reader's distraction": While the icons provide visual cues in certain circumstances, writing in prose will usually suffice. Instead, provide a link to the services directly.

## Generic

The following symbols can be used to denote interchange:

Symbol Usage

Code: {{rail-interchange|air}}
Use: Airport station

Code: {{rail-interchange|bus}}
Use: Interchange with local bus services

Code: {{rail-interchange|rail}}
Use: Interchange with mainline rail services

Code: {{rail-interchange|metro}} or …|underground}} or …|subway}}
Use: Interchange with rapid transit services

Code: {{rail-interchange|tram}}
Use: Interchange with tram or light rail services

Code: {{rail-interchange|ferry}}
Use: Interchange with a passenger ferry or water bus service

Code: {{rail-interchange|funicular}} or {{rail-interchange|incline}}
Use: Interchange with a funicular

Code: {{rail-interchange|heritage|rail}}
Use: Interchange with a heritage railway line

Code: {{rail-interchange|heritage|tram}}
Use: Interchange with a heritage tram or streetcar line

Code: {{rail-interchange|bicycle}} or {{rail-interchange|bike}}
Use: Bicycle facilities

Code: {{rail-interchange|park}} or {{rail-interchange|parking}}
Use: Parking
Code: {{rail-interchange|wheelchair}}