Powered by
TTSReader
Share this page on
Article provided by Wikipedia


Template documentation["view] [edit] [history] [purge]

This "Lua-based template replaces the older parser-function-based {{"BS-map}} (and deprecated {{"Railway line header}}, {{"BS-header}} and {{"BS-table}}) templates for "Wikipedia:Route diagram templates because diagrams created by {{Routemap}} load faster.

Usage[edit]

{{{title}}}
{{{top}}}
{{{map}}}
{{{footnote}}}
{{routemap
| inline      =
| title       =
| title color =
| title bg    =
| collapsible =
| collapse    =
| navbar      =
| navbar pos  =
| navbar mini =
| legend      =
| legend alt  =
| float       =
| bg          =
| style       =
| top         =
| footnote    =
| text-width  =
| map =

}}

Markup for map parameter[edit]

The markup for composing the diagram in the |map= parameter is different to the {{"BSrow}}-based templates. The major differences are the separators in each row. Subtemplates are not necessary, since a new row in the table is simply created by a "carriage return (newline).

{{Routemap
Add other parameters like |title= here.
|map=
Map markup goes here!
}}

Basic[edit]

Example 1.1
exCONTg
ENDExa
CONTgq\KRZu\CONTfq
BHF
\ABZgl\CONTfq
CONTf
icon ID\icon ID\icon ID

Sidebar text[edit]

icon ID\icon ID\icon ID~~dist./time~~main text~~remark~~right remark

or

icon ID\icon ID\icon ID~~main text
{{Routemap
|title=Example 1.2
|map=
KBHFa~~terminus
WASSERq\WBRÜCKE\WASSERq~~ ~~ ~~ ~~Bridge
LDER\INT\~~1 km~~station~~transfer for HSR
\KBHFe\BUS~~2 km~~terminus~~bus terminal
}}
Example 1.2
terminus
Bridge
1 km
station
transfer for HSR
2 km
terminus
bus terminal

Text cells in icon rows[edit]

*text\d*text\cd*text~~main text
{{Routemap
|title=Example 1.3
|map=
ENDEa~~ ~~ ~~Reversing siding
SPLa
cBS\vSTR\cBS~~Station
d*1\cBS\vSTR\cBS\d*2~~ ~~ ~~Platform numbers
cBS\vSTR\cBS
vCONTfge~~ ~~ ~~''to City''
}}
Example 1.3
Reversing siding
Station
1
2
Platform numbers
to City

The asterisk indicating a text cell can be preceded by one of the BSicons' width prefixes. (Normal BSicons are square.)

Letters c d cd none b s bs w
Width 14 12 34 1 2 4 6 8

Icon overlay, icon link, background color and colspan[edit]

{{Routemap
|title=Example 2.1
|map=
-colspan-1
Icon overlay
uSTRq!~STR2!~BHF!~lHUB\\dSTR!~uSTRq\dSTR!~dNULf
-colspan-2-style=border-bottom:5px solid red;
----
icon link
utBHF!@Superhub
-colspan
----
background color
-colspan-end
utSTR~~ ~~ ~~ ~~ ~~bg=#7af
}}
Example 2.1

Icon overlay


icon link

"

background color

Other formatting options[edit]

Rows[edit]

Example 2.2
bg=#007CC3
1
2
3
color=red,bold=yes
A
C
E
align=l,b=1,fontsize=cmt
B
D
F
colour=orange, align=b, i=y

Aside from bg=, there are several other parameters, separated by commas (,), which can be used to customize the display of a row. Only bg= can be used to change the display of icons; all others only affect text cells.

Row parameters
Parameter name Values Result
bg=, background= or bgcolor= Any "X11 color name, "RGB hex triplet or other valid values of the CSS background property Row background is colored
color= or colour= Any "X11 color name or "RGB hex triplet Text cells in a row are colored
b= or bold= 1, yes, y or true Text cells in a row are emboldened
i=, it= or italic= 1, yes, y or true Text cells in a row are italicized
align= No or invalid value Text in cells is centered horizontally and vertically
l or left Text in cells is aligned to the left
r or right Text in cells is aligned to the right
a, t or top Text in cells is aligned to the top
e, b or bottom Text in cells is aligned to the bottom
la, tl, c4, nw, top-left or topleft Text in cells is aligned to the top-left corner
ra, tr, c1, ne, top-right or topright Text in cells is aligned to the top-right corner
le, bl, c3, sw, bottom-left or bottomleft Text in cells is aligned to the bottom-left corner
re, br, c2, se, bottom-right or bottomright Text in cells is aligned to the bottom-right corner
fontsize= No value Text in cells is 10px high (example)
info or main Text in cells is the same size as the large sidebar text (second column from center)
cmt or comment Text in cells is the same size as the small sidebar text (other columns)
Any valid values of the CSS font-size property Text in cells is a different size (percentages are relative to the large sidebar text)

Individual cells/icons[edit]

icon!_bg=purple\*text__align=l!~*more text__align=r,b=yes
Icon, text box and overlay stack parameters
Parameter name Values Result
bg=, background= or bgcolor= Any "X11 color name, "RGB hex triplet or other valid values of the CSS background property Background is colored
This should not be used with overlays above icons.
color= or colour= Any "X11 color name or "RGB hex triplet All the text of a cell, or the text of an individual text box, is colored
b= or bold= 1, yes, y or true Text is emboldened
i=, it= or italic= 1, yes, y or true Text is italicized
align= No or invalid value Text is aligned per parameters of its parent (default: centered vertically and horizontally)
l or left Text is aligned to… (vertical / horizontal)
"Inherit" indicates that the cell will inherit its parent's value for that axis.
inherit left
r or right inherit right
a, t or top top inherit
e, b or bottom bottom inherit
la, tl, c4, nw, top-left or topleft top left
ra, tr, c1, ne, top-right or topright top right
le, bl, c3, sw, bottom-left or bottomleft bottom left
re, br, c2, se, bottom-right or bottomright bottom right
c, center or centre inherit center
m or middle middle inherit
ma, tc, top-center, top-centre, topcenter or topcentre top center
me, bc, bottom-center, bottom-centre, bottomcenter or bottomcentre bottom center
lm, ml, middle-left or middleleft middle left
rm, mr, middle-right or middleright middle right
cm, mc, middle-center, middle-centre, middlecenter or middlecentre middle center
fontsize= No value Text is 10px high (example)
info or main Text is the same size as the large sidebar text (second column from center)
cmt or comment Text is the same size as the small sidebar text (other columns)
Any valid values of the CSS font-size property Text is a different size (percentages are relative to the large sidebar text)
abbr= Pretty much anything that doesn't mess up the MediaWiki markup Text has dotted underline and a tooltip containing the text after abbr=
This will not have any effect if used on an overlay stack.

Collapsible[edit]

{{Routemap
|title=Example 3.1: Basic collapsible
|text-width=80
|map=
-startCollapsible-collapsed
\KBHFa\~~terminus
hSTRa@g
WASSERq\hKRZW\WASSERq~~ ~~ ~~ ~~bridge
hSTRe@f
-endCollapsible-
LDER\INT\~~ ~~station~~transfer for HSR
\KBHFe\BUS~~ ~~terminus~~bus terminal
}}
Example 3.1: Basic collapsible
terminus
bridge
station
transfer for HSR
terminus
bus terminal
{{Routemap
|title=Example 3.2: Mixed odd and even rows
|tw=70
|map=
-startCollapsible-collapsed
d\KBHFa\d~~terminus
WBRÜCKE~~ ~~ ~~ ~~bridge
-endCollapsible-
BS2+l\BS2+r~~junction
}}
Example 3.2: Mixed odd and even rows
terminus
bridge
junction

Collapsible replacement[edit]

{{Routemap
|title=Example 4.1
|text-width=150
|map=
KBHFa~~terminus
-startCollapsible-collapsed-replace
\LSTR\~~dispensable section
\hSTRa@g\
WASSERq\hKRZW\WASSERq~~ ~~ ~~ ~~bridge
hSTRe@f
-endCollapsible-
LDER\INT\~~ ~~station~~transfer for HSR
\KBHFe\BUS~~ ~~terminus~~bus terminal
}}
Example 4.1
terminus
dispensable section
bridge
station
transfer for HSR
terminus
bus terminal
{{Routemap
|title=Example 4.2: Empty filler
|text-width=150
|map=
-startCollapsible-collapsed-replace
exCONTg~~under construction
leer
exKBHFa~~future terminus
exBHF~~future station
-endCollapsible
KBHFxa~~terminus
KBHFe~~terminus
}}
Example 4.2: Empty filler
under construction
future terminus
future station
terminus
terminus

Dual text sidebar[edit]

For larger and more complicated diagrams, it often helps to have a text sidebar on the left as well as the right.

left-left remark~~left remark~~left main text~~left dist./time! !icon ID~~right dist./time~~right main text~~right remark~~right-right remark

or

left main text! !icon ID~~right main text
{{Routemap
|title=Example 5
|map=
commuter terminus! !uKBHFa\\KBHFa~~regional terminus
River Boris~~ ~~ ~~! !uWBRÜCKE\WASSERq\WBRÜCKE~~ ~~ ~~ ~~bridge
transfer for HSR~~station~~1 km! !uINT\LDER\LSTR
commuter terminus~~2 km! !uKBHFe\\KBHFe~~2 km~~regional terminus
}}
Example 5
commuter terminus
regional terminus
River Boris
bridge
transfer for HSR
station
1 km
commuter terminus
2 km
2 km
regional terminus

Dual text sidebar collapsible[edit]

{{Routemap
|title=Example 6.1: All text cells applied
|style=width:540px
|text-width=65,150,30,30,120,
|map=
-startCollapsible
commuter terminus! !uKBHFa\leer\KBHFa~~regional terminus
River Boris~~ ~~ ~~! !uWBRÜCKE\WASSERq\WBRÜCKE~~ ~~ ~~ ~~bridge
-endCollapsible
transfer for HSR~~station~~1 km! !uINT\LDER\LSTR
commuter terminus~~2 km! !uKBHFe\\KBHFe~~2 km~~regional terminus
}}
Example 6.1: All text cells applied
commuter terminus
regional terminus
River Boris
bridge
transfer for HSR
station
1 km
commuter terminus
2 km
2 km
regional terminus
{{Routemap
|map-title=Example 6.2: Only main text cell applied
|style=width:380px
|text-width=,120,,,120,
|map=
-startCollapsible
commuter terminus! !uKBHFa\\KBHFa~~regional terminus
River Boris! !uWBRÜCKE\WASSERq\WBRÜCKE~~bridge
-endCollapsible
station! !uINT\LDER\LSTR
commuter terminus! !uKBHFe\\KBHFe~~regional terminus
}}
Example 6.2: Only main text cell applied
commuter terminus
regional terminus
River Boris
bridge
station
commuter terminus
regional terminus

Transition from legacy BS row template to Routemap markup[edit]

Conversion policies[edit]

Many contributors of the English Route Diagram Template project during the implementation of Routemap have conflicting opinions about the justification of replacing all maps of legacy BS row templates by the Lua-based Routemap. Opponents deem the map markups of Routemap to be too esoteric for editors unfamiliar with Routemap markup to modify. While proponents support a complete conversion for better performance. There is no consensus reached at the moment so any transition without massively updating the map appearance for reflecting service and/or structural change in reality should only be done with the following considerations:

Technical options[edit]

All "BS row templates have had substitutable counterparts created; hence conversion can be easily done by prepending subst: and appending /safesubst to every BS row template name in the map. For example, change {{BS2|STR|BHF|0|1|2|3|O1=uSTRq}} in the map to {{subst:BS2/safesubst|STR|BHF|0|1|2|3|O1=uSTRq}}, then publish changes; it will produce STR!~uSTRq\BHF~~0~~1~~2~~3. The process can be sped up by using the "replace all" function of advanced edit tool or separate text editor such as "Notepad or "Notepad++, but the search rule for the BS row templates should ideally be a "regular expression, like \{\{(BS\d*(\-2)?)\|{{subst:$1/safesubst|, in order to avoid templates with similar names such as BSto and BSsplit in case they are present in the map.

"Column mode editing" can avoid the trouble of find and replace to add safesubst: on all rows efficiently. This function is common in advanced text editors like "Geany,[1] Notepad++[2] and "Sublime Text[3].

You can also use the "convertbs" function of Module:Routemap.

Function convertbs[edit]

Copy and paste the following code to any edit area of this wiki, maybe the map page you are working on:

{{#invoke:Routemap|convertbs|<nowiki>

</nowiki>}}

Then copy and paste the original BS-map or BS-table map code between the <nowiki> tags (alternatively paste the invoke convertbs header before the original map code and the </nowiki>}} ending after the map code) and show preview. It will generate the safesubst version and show the original versions (for comparison) of the map code. You copy the safesubst code from the preview area back to the edit area, and you should remove everything of #invoke:Routemap|convertbs if the preview of the new code works properly.

On the English Wikipedia, the template {{"subst:"convertbs}} can be used as a shortcut:

{{subst:convertbs|1=

}}

If it doesn't work, it's possible that you haven't copied some of the relevant code, such as table markup for BS-table diagrams, or that you've copied code which actually belongs to something else.

Example
{{#invoke:Routemap|convertbs|<nowiki>
{{BS-map
|title=Demonstration
|map=
{{BS|KBHFa|0 km|A station|Shuttle bus}}
{{BS3|WASSERq|WBRÜCKE|WASSERq||||{{BSsplit|Suburb|Capital}}}}
{{BS|KINTe|10 km|B station|City hub}}
{{BS-colspan}}
----
Not to scale
}}
</nowiki>}}
Result

Safe substitution:

{{Routemap
|title=Demonstration
|map=
{{safesubst:BS/safesubst|KBHFa|0 km|A station|Shuttle bus}}
{{safesubst:BS3/safesubst|WASSERq|WBRÜCKE|WASSERq||||{{BSsplit|Suburb|Capital}}}}
{{safesubst:BS/safesubst|KINTe|10 km|B station|City hub}}
-colspan-2
----
Not to scale
}}

Original:

{{BS-map
|title=Demonstration
|map=
{{BS|KBHFa|0 km|A station|Shuttle bus}}
{{BS3|WASSERq|WBRÜCKE|WASSERq||||{{BSsplit|Suburb|Capital}}}}
{{BS|KINTe|10 km|B station|City hub}}
{{BS-colspan}}
----
Not to scale
}}
Copy safe substitution markup for actual usage
Demonstration
0 km
A station
Shuttle bus
Suburb
Capital
10 km
B station
City hub

Not to scale

Embedding into infobox[edit]

{{Infobox station
| name = {{color box|orange}} Station layout
| image = Placeholder.png
| image_upright = 0.5
| image_caption = Platform level
| opened = {{Start date|1935|05|15|df=y}}
| tracks = 2
| route_map =
{{routemap|inline=1|navbar=asd|navbar pos=2|
KBHFa~~terminus
WASSERq\WBRÜCKE\WASSERq~~ ~~ ~~ ~~Bridge
LDER\INT\~~1 km~~station~~transfer for HSR
\KBHFe\BUS~~2 km~~terminus~~bus terminal
}}
}}
     Station layout
""Placeholder.png
Platform level
Tracks 2
History
Opened 15 May 1935 (1935-05-15)
Route map
terminus
Bridge
1 km
station
transfer for HSR
2 km
terminus
bus terminal

Template data[edit]

This is the "TemplateData documentation for this template used by "VisualEditor and other tools; see the monthly error report for this template.

TemplateData for Routemap

Template for displaying diagram composed of icon images and text labels in uniform style.

Template parameters

This template has custom formatting.

Parameter Description Type Status
Inline state inline

Remove title bar and border for transclusion in infobox

Default
empty
Example
empty
Auto value
empty
String optional
Table title title

Official title of the system. Value «no» will remove the table title row, but this will also disable the table collapsible switch as well

Default
empty
Example
empty
Auto value
empty
String optional
Title font color title colortitle-color

Color of the title's text; automatically black or white to contrast with the title background color. Only use colors that contrast well with the background color

Default
#FFF or #252525; depends
Example
empty
Auto value
empty
String optional
Title background color title bg colortitle-bg

Background color of the title

Default
#27404E
Example
empty
Auto value
empty
String optional
Collapsibility collapsible

Whether the whole infobox is collapsible or not

Default
empty
Example
empty
Auto value
empty
String optional
Collapsing state collapsecollapsed

Collapsing state. Shown by default. Any value will make the table collapse by default

Default
empty
Example
empty
Auto value
empty
String optional
Template name for Navbar navbartnavbar

Type the diagram template page name so the Navbar template will appear and link to the template page

Default
empty
Example
empty
Auto value
empty
String optional
Position of the Navbar navbar pos

Position of the Navbar template. Float to left in the title bar by default; «1» for top-right corner of the map (just under the title bar); «2» for the middle bottom of the map

Default
empty
Example
empty
Auto value
empty
String optional
Small navbar navbar mini

If the navbar is not in default position, then this changes whether the navbar displays as "V · T · E" (default for navbar pos 1; values: «1», «y», «yes», «true») or "This diagram: view · talk · edit" (default for navbar pos 2; values: «0», «n», «no», «false»).

Default
empty
Example
empty
Auto value
empty
String optional
Legend appearance legend

Alias of the legend link. It can be «bus», «canal», «footpath» or «track». «0» or «no» for no legend at all

Default
Template:Railway line legend
Example
empty
Auto value
empty
Page optional
Legend link text legend alt

Different link name in place of «Legend» if desirable

Default
Legend
Example
empty
Auto value
empty
String optional
Floating state float

Floating state of the whole box: «right» by default; optionally «left» or «none»

Default
right
Example
empty
Auto value
empty
String optional
Background color bg

Background color of the whole map area

Default
#F9F9F9
Example
empty
Auto value
empty
String optional
CSS style values style

Additional CSS style definition of the whole infobox

Default
empty
Example
empty
Auto value
empty
String optional
Top note topon top

Space for optional note or infobox above the map

Default
empty
Example
empty
Auto value
empty
String optional
Bottom note footnotebottom

Space for optional note or infobox below the map

Default
empty
Example
empty
Auto value
empty
String optional
Width of map text cell text-widthtw

Extend the width of the map text cell so the collapsible section within the map does not break

Default
empty
Example
empty
Auto value
empty
String optional
Map markups map1

Map data which uses specific markup/separators to load icon image and arrange the text in the uniform style

Default
empty
Example
empty
Auto value
empty
String required
) ) WikipediaAudio is not affiliated with Wikipedia or the WikiMedia Foundation.