Template:Routemap/doc

This template employs some extremely complicated or esoteric features of template syntax. Please do not attempt to alter it unless you are certain that you understand the setup and are prepared to repair/revert any consequent collateral damage if the results are unexpected. Any experiments should be conducted in a sandbox or your userspace.

Uses Lua: Module:Routemap Module:Color contrast Module:Navbar

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:Wikipedia:Route diagram templates because diagrams created by {{Routemap}} load faster.

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

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!
}}

Example 1.1
exCONTg ENDExa CONTgq\KRZu\CONTfq BHF \ABZlf\CONTfq CONTf

icon ID\icon ID\icon ID

• Icons are separated by the backslash \.
• Each group of icons is centered in its row. The nameless icon (at the start of row 5 in the diagram) can be used as a spacer.
• The ID of each icon can be seen in its tooltip. Move your cursor over the icons to see them.

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\hKRZWae\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

• The third and fourth pairs of tildes can be omitted if there is no content following either of them.
• After the last icon ID, if there is only one set of "tilde-tilde" (~~), the following text will be displayed in the main text cell instead of dist./time.
• Separating text cells requires at least one empty space; otherwise the tildes will be treated as a signature.

*text\d*text\cd*text~~main text

{{Routemap |title=Example 1.3 |map= ENDEa~~ ~~ ~~Reversing siding SPLa cPLT\vSTR\cPLT~~Station d*1\cPLT\vSTR\cPLT\d*2~~ ~~ ~~Platform numbers cPLT\vSTR\cPLT 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.)

{{Routemap |title=Example 2.1 |map= -colspan-1 Icon overlay uSTRq!~STR2!~BHF!~lHUB -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

• Overlay separator "exclamation mark-tilde" (!~) must follow the icon ID which is to be overlaid.
• Overlay is practically unlimited, but legibility should be taken into account.
• When using icon overlay and icon link for the same icon cell, the icon link separator (!@) must follow the last (top) overlaying icon ID.
• The background color parameter (bg=) requires 5 sets of preceding text separators to be recognizable even if there is no text on that row whatsoever.

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.

icon!_bg=purple\*text__align=l!~*more text__align=r,b=yes

• Parameters for all of a stack of multiple overlaid icons and/or text boxes (or a single icon or text box with no overlays) are separated to the left by an exclamation mark and an underscore (!_). This must go after the link (if any).
• Parameters for part of a stack of multiple overlaid items are separated to the left by two underscores (__).
• For the last overlaid item in a stack, the individual item parameters (if any) must go before the stack parameters.
• Most of the parameters are the same as those for rows, but there are a few additional ones. Additionally, the values for align=, bg= and color= can override those of the row parameters.

{{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 hWASSER~~ ~~ ~~ ~~bridge -endCollapsible- BS2+l\BS2+r~~junction }}

Example 3.2: Mixed odd and even rows terminus bridge junction

• Adjust |text-width= (or |tw=) parameter until there is no break.
  • Unit is "px" by default, but other units such as "em" are acceptable.
  • Check the map in different browser and increase text-width if it breaks.
• The icon number of the first row of collapsible section must be equal to or greater than the icon number of the widest non-collapsible row.
  • As in example 3.2, use half-width empty icon  (d) as filler when you are mixing both odd and even rows in the same map.
• Changing "collapsed" to "nil" will change the default state of the collapible section to uncollapsed.

{{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

• Both replacement and replaced rows must be as wide as the widest non-collapsible row in the diagram.
• If you want to hide the replaced row after expanding the collapsible, use icon  (leer) as empty filler as in example 4.2.
• In any case, mind to provide a sufficient text-width. Here, using text-width=120 would break the alignment of the icons.
• Collapsible elements are intentionally disabled in mobile view, so the replaced row will never be visible. Keep this in mind while creating a diagram.

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~~ ~~ ~~! !uhKRZW\WASSERq\hKRZW~~ ~~ ~~ ~~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

• Left text cells require "exclamation mark-space-exclamation mark" (! !) separating them from icon cells.
• If there is no "tilde-tilde" (~~) separator to the left of "exclamation mark-space-exclamation mark", the text to the left of the separator will be displayed in the left main text cell.

{{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~~ ~~ ~~! !uhKRZW\WASSERq\hKRZW~~ ~~ ~~ ~~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! !uhKRZW\WASSERq\hKRZW~~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

• Apply |text-width= to eliminate the break:
  • Only 1 value: right main text+right remark
  • 3 values, separated by commas: right dist./time,right main text+right remark,right-right remark
  • 6 values: Left-left remark,left remark+left main text,left dist./time,right dist./time,right main text+right remark,right-right remark
  • If the amount of values does not equal to 1, 3 or 6, the whole parameter will be ignored.
• If the text width of right-right remark is shorter to some degree, its width definition can be omitted, as in example 6.1.
• If the entire map never uses a specific text cell, that width definition can be omitted, as in example 6.2.
• Define the general table width in {{{style}}} parameter as well if {{{text-width}}} alone is ineffective to prevent the break.
• If the empty icon cell of the collapsible row is being squashed, use empty icon  (leer) to fixate the icon columns.