Template:Track gauge/doc: Difference between revisions
wp>CapnZapp let us be complete and comprehensive |
m 1 revision imported |
(No difference)
| |
Latest revision as of 00:19, 7 April 2022
 | This is a documentation subpage for Template:Track gauge. It may contain usage information, categories and other content that is not part of the original template page. |
 | This template uses Lua: |
This template accepts a track gauge and returns that defined track gauge well formatted, plus the converted size value by another unit:
{{Track gauge|1520 mm}}→ 1,520 mm (4 ft 11+27⁄32 in){{Track gauge|4 ft}}→ 4 ft (1,219 mm)
Extra options are available:
{{Track gauge|1520 mm|lk=on}}→ 1,520 mm (4 ft 11+27⁄32 in){{Track gauge|1520 mm|al=on}}→ 1,520 mm (4 ft 11+27⁄32 in) Russian gauge{{Track gauge|1520 mm|allk=on}}→ 1,520 mm (4 ft 11+27⁄32 in) Russian gauge
Input options
The first parameter specifies the gauge:
{{Track gauge|1435 mm}}→ 1,435 mm (4 ft 8+1⁄2 in){{Track gauge|4 ft 8.5 in}}→ 4 ft 8+1⁄2 in (1,435 mm){{Track gauge|4 ft 8 1/2 in}}→ 4 ft 8+1⁄2 in (1,435 mm){{Track gauge|56.5 in}}→ 4 ft 8+1⁄2 in (1,435 mm){{Track gauge|Standard gauge}}→ 1,435 mm (4 ft 8+1⁄2 in)
Rail track gauges can be entered as they are defined: in units mm or ft in. Also common accepted names can be used, see below.
The input value (a length, in metric or imperial units) must be a defined track gauge. Currently 135 gauges are defined by metric units, and 148 by imperial units. Some are defined in both unit systems, such as the standard gauge.
- When an input value is not recognised by the template, the template simply returns the input as it is: {{Track gauge|25in}} → 25in
- The page with this unknown input is also listed in a maintenance category, in the background, that signals interested editors that there is a new rail gauge used in Wikipedia. More on this below.
- Some gauges in metric are defined in metres: 1 m is recognised. However, it is not available for all metric defined gauges. Using
mmis a safer bet.
List of defined track gauges
Track gauges in bold font are definitions. Track gauges in regular font are merely conversions (calculations). Lua error in Module:Track_gauge/autodocument at line 806: too many expensive function calls.
Formatting input
When entering a track gauge (like {{Track gauge|1435mm}}, these are formatting options. Keep in mind that only defined gauges are recognised.
Spacing is free, and fractions can be used in imperial units. Primes (' and ") may be used for [foot, inch]. Any [foot, inch] size can be entered in all-inches (4 ft 8 1/2 in equals 56 1/2 in and 56.5 in).
| Parameter input |
Result | Note |
|---|---|---|
1435 mm |
1,435 mm (4 ft 8+1⁄2 in) | standard gauge |
standard gauge |
1,435 mm (4 ft 8+1⁄2 in) | standard gauge, by name |
4 ft 8.5 in |
4 ft 8+1⁄2 in (1,435 mm) | standard gauge, this way puts imperial units first |
UK sg |
4 ft 8+1⁄2 in (1,435 mm) | standard gauge, this way puts imperial units first |
56.5 in |
4 ft 8+1⁄2 in (1,435 mm) | standard gauge, by all-inches |
56.5" |
4 ft 8+1⁄2 in (1,435 mm) | standard gauge, using primes |
56 1/2 in |
4 ft 8+1⁄2 in (1,435 mm) | standard gauge, using slash for fraction |
1 m |
1,000 mm (3 ft 3+3⁄8 in) | 1 m is recognised, but not many more in m. Better use mm
|
16.5 mm |
16.5 mm (0.65 in) | HO scale model railway |
16.5 in |
16+1⁄2 in (419 mm) | Miniature railway |
7 ft 0.25 in |
7 ft 1⁄4 in (2,140 mm) | Brunel |
2140 mm |
2140 mm | Not recognised (so no converted value). This track gauge, Brunel's, is not defined in mm. |
65 in |
65 in | Input not recognised (so no converted value); output copies the input. This is a good way to enter an uncovered rail gauge on a page: other editors will notice (and can add a new gauge to the template!). |
Parameters
{{Track gauge
|
| lk=on
| first=imp, met
| disp= s, /, 1, br, [], <any literal text>
| al=on
| allk=on
| nowrap=off (default), on, all
| addcat=no
| unitlink=on
}}
| Parameter | What it does | Example (code) | Example (output) | |
|---|---|---|---|---|
| lk=on | Links the defining measure (first measure) "defined size" depends on input |
{{Track gauge|3ft6in|lk=on}}
|
3 ft 6 in (1,067 mm) 1,067 mm (3 ft 6 in) | |
| al=on | Adds the alternate name after the gauge measurement values | {{Track gauge|sg|al=on}}
|
1,435 mm (4 ft 8+1⁄2 in) standard gauge | |
| allk=on | Adds a wikilink to the alternate name where applicable | {{Track gauge|sg|allk=on}}
|
1,435 mm (4 ft 8+1⁄2 in) standard gauge | |
| first=imp first=met |
Puts the requested measure first (metric, imperial) | {{Track gauge|1000mm|first=imp}}
|
3 ft 3+3⁄8 in (1,000 mm) | |
| disp=any text | disp= are processed as described: 1, s, /, br). | {{Track gauge|sg|disp=also defined as being}}
|
1,435 mm also defined as being 4 ft 8+1⁄2 in | |
| disp=s or / | Uses a slash as a separator rather than parentheses | {{Track gauge|sg|disp=s}}
|
1,435 mm / 4 ft 8+1⁄2 in | |
| disp=[] | Uses a square brackets rather than parentheses | {{Track gauge|sg|disp=[]}}
|
1,435 mm [4 ft 8+1⁄2 in] | |
| disp=1 | Only shows the first measure (may be used when repeated on a page or in conjunction with first= to display the output only)
|
{{Track gauge|sg|disp=1}}
|
1,435 mm | |
| disp=br | Forces a line break after the first size (and also before any gauge name) | {{Track gauge|sg|disp=br}}
|
1,435 mm (4 ft 8+1⁄2 in) | |
| nowrap=off (default), on, all | Sets possible line break (line wrap): after between the measurements (off=defalt), not (on, all), or not at all when named gauge is present. (note: until May 2014, default behaviour was no break between the measurements. This has changed.) | {{Track gauge|sg|nowrap=on}}
|
1,435 mm (4 ft 8+1⁄2 in) | |
| addcat=no | Will not add a maintenance category | {{Track gauge|sg|addcat=no}}
|
1,435 mm (4 ft 8+1⁄2 in) | |
| unitlink=on | Adds wikilinks to the measurement unit labels | {{Track gauge|sg|unitlink=on}}
|
1,435 mm (4 ft 8+1⁄2 in) | |
- Names can be universal, being defined worldwide. For example: Iberian gauge, 1,668 mm (5 ft 5+21⁄32 in) Iberian gauge. Other names can be localor culturally restricted, for example the name "Cape gauge" is used in South Africa for 3 ft 6 in (1,067 mm), but not in Japan (in Japan that same track gauge is not named).
- Also, two sizes can lead to one gauge name.
Named gauges
Established gauge names can be entered. The word "gauge" can be omitted. Case-insensitive (A=a). See also the |al=, |allk= parameters (below), to show a gauge name in the outcome.
| Input | Result | Note |
|---|---|---|
| {{Track gauge|Baltimore gauge|al=on}} | 5 ft 4+1⁄2 in (1,638 mm) Baltimore streetcar gauge | |
| {{Track gauge|Baltimore|al=on}} | 5 ft 4+1⁄2 in (1,638 mm) Baltimore streetcar gauge | Omitting " gauge", same effect |
| {{Track gauge|baltimore|al=on}} | 5 ft 4+1⁄2 in (1,638 mm) Baltimore streetcar gauge | Case-insensitive (A=a) |
| {{Track gauge|baltimore|al=on}} | 5 ft 4+1⁄2 in (1,638 mm) Baltimore streetcar gauge | al=on shows the alternative (name) |
| {{Track gauge|baltimore|allk=on}} | 5 ft 4+1⁄2 in (1,638 mm) Baltimore streetcar gauge | allk=on shows the alternative (name), linked |
| {{Track gauge|baltimore|lk=on|al=on}} | 5 ft 4+1⁄2 in (1,638 mm) Baltimore streetcar gauge | lk=on links the size (as always) |
| {{Track gauge|Baltimore streetcar gauge|al=on}} | 5 ft 4+1⁄2 in (1,638 mm) Baltimore streetcar gauge | This one has more names |
| {{Track gauge|Bosnian|al=on}} | 760 mm (2 ft 5+15⁄16 in) Bosnian gauge | |
| {{Track gauge|Brunel|al=on}} | 7 ft (2,134 mm) Brunel gauge | |
| {{Track gauge|Cape|al=on}} | 3 ft 6 in (1,067 mm) Cape gauge | |
| {{Track gauge|Iberian|al=on}} | 1,668 mm (5 ft 5+21⁄32 in) Iberian gauge | |
| {{Track gauge|Indian|al=on}} | 5 ft 6 in (1,676 mm) Indian gauge | |
| {{Track gauge|Victorian|al=on}} | 1,600 mm (5 ft 3 in) Victorian broad gauge | |
| {{Track gauge|Irish|al=on}} | 5 ft 3 in (1,600 mm) Irish gauge | |
| {{Track gauge|metre|al=on}} | 1,000 mm (3 ft 3+3⁄8 in) metre gauge | |
| {{Track gauge|Ohio|al=on}} | 4 ft 10 in (1,473 mm) Ohio gauge | |
| {{Track gauge|Pennsylvania|al=on}} | 5 ft 2+1⁄2 in (1,588 mm) Pennsylvania trolley gauge | |
| {{Track gauge|Pennsylvania trolley|al=on}} | 5 ft 2+1⁄2 in (1,588 mm) Pennsylvania trolley gauge | |
| {{Track gauge|Russian|al=on}} | 1,520 mm (4 ft 11+27⁄32 in) Russian gauge | |
| {{Track gauge|Scotch|al=on}} | 4 ft 6 in (1,372 mm) Scotch gauge | |
| {{Track gauge|standard gauge|al=on}} | 1,435 mm (4 ft 8+1⁄2 in) standard gauge | Also: "sg", "metsg" (metric units first) |
| {{Track gauge|US sg|al=on}} | 4 ft 8+1⁄2 in (1,435 mm) standard gauge | Also: "imp sg", "UK sg", "NA sg" (imperial units first) |
| {{Track gauge|Swedish three foot|al=on}} | 891 mm (2 ft 11+3⁄32 in) Swedish three foot | |
| {{Track gauge|Swedish|al=on}} | 891 mm (2 ft 11+3⁄32 in) Swedish three foot | |
| {{Track gauge|Toronto|al=on}} | 4 ft 10+7⁄8 in (1,495 mm) Toronto gauge |
English variant (ENGVAR)
This template defaults to UK-English. For articles written in US-English, set parameter |engvar to |engvar=en-US. In this situation, the US-English spelling is shown:
{{track gauge|1000mm|allk=on|engvar=en-US}}→ 1,000 mm (3 ft 3+3⁄8 in) meter gauge
As of 2016, the only two gauges impacted are the 1000 mm and 1009 mm gauges. In UK-English these are spelled metre, in US-English these are spelled meter.
Why not use {{Convert}}?
To convert a track gauge, using {{Convert}} comes to mind. For example, standard gauge:
- {{Convert|1435|mm|ftin|abbr=on}} → 1,435 mm (4 ft 8.5 in)
- However, this has some disadvantages. First of all, track gauges are defined by an institute, not just measured. The list of those defined track gauges is limited, and overseeable (today some 270 physical sizes are defined).
- Using {{Track gauge}} allows us to track (follow) all articles with a specific gauge. This way the list can be made more accurate, correct and complete.
- Also, the track definition can be directly linked to the sourcing article: 1,067 mm (3 ft 6 in).
- Further more, the template allows to recognise named gauges such as "Russian gauge".
Tracking category
- {{Track gauge}} detects that an undefined gauge is entered, and signal the page for maintenance. For example, metre gauge is only defined in metric. Entering an imperial size would categorise that article in Category:Articles using Template:Track gauge with unrecognized input (0).
TemplateData
TemplateData for Track gauge
|
The template formats a track gauge size into standard notation and adds the conversion into the imperial/metric (other) size
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
See also
| ||||||||||||||||||||||||||||||||||||||||
.png)
- {{Track gauge/document gauge}}
- {{Track gauge/status}} - talkpage infobox of a track gauge, to be used on the talkpage
- Sources
External links; sources
- Sources
- Light Rail Transit Association (LRTA)
- Morrisson, Allen (2013). "Electric transport in latin america". Latin America is very well covered
- "A world of trams and urban transit". Light Rail Transit Association (LRTA)). UK based, covering most countries
- de:Liste_der_Spurweiten (checking here in Template talk:Track gauge/dewiki list)
- Scaled rail models
- "S-3.1 Trackwork, Proto & Fine Scales". NMRA. 2004.
- "S-3.2 Trackwork Standard Scales (metric)" (PDF). NMRA. 2010.