Template:Infobox Australian road/doc
This is a documentation subpage for Template:Infobox Australian road. It may contain usage information, categories and other content that is not part of the original template page. |
This template uses Lua: |
This template employs intricate features of template syntax.
You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. You can conduct experiments, and should test all major changes, in either this template's sandbox, the general template sandbox, or your user space before changing anything here. |
Usage
[edit]{{Infobox Australian road}} is the standard infobox used in Australian articles. Australian articles using {{Infobox road}} should be converted to use this infobox as it contains additional functionality, including that of {{Infobox street}} and {{Infobox road junction}}. Code exists for implementation of {{Infobox road small}} functionality if that is deemed to be necessary. See this discussion for more information.
To use this template
[edit]- Copy the relevant blank template from the Blank infobox template page into the beginning of your document, remembering to put the code at the very top of the article and the first word of the article on the very next line. For road junctions, use the reduced parameter set at Template:Infobox Australian road/Blank#Road junctions.
- Enter values for the parameters as outlined in the table below. Fields left blank will automatically be hidden.
- Preview.
- Save the page with an appropriate edit summary.
Examples
[edit]- Examples of this template can found on the examples page.
Parameters
[edit]All parameters used by this template are optional, except for |type=
. Some parameters require others to be completed in order to display data correctly. The following are available:
Basic setup parameters: | ||
---|---|---|
|
Source/notes | Values |
|
Required parameter. Sets up the template for a specific type of road or road junction. | "highway", "road", "rural road", "street", "expressway", "freeway", "motorway", "parkway", "track" or "junction" |
|
If the road is wholly contained within an urban area, set |urban=yes .
|
"yes" or empty |
|
Status of the road for use in limited circumstances. Only use when the road is under construction, proposed or has been closed. | Under construction: "uc" or "under construction" Proposed: "proposed" Closed: "closed" |
|
Primary name used for road | plain text, do not wikilink |
|
Alternative name(s) for road | plain text, do not wikilink. When there is more than one name, separate them with a solidus ( / ). If there are more than two names, use a bulleted list (which will display as a plain list). |
|
Use the 2 or 3 digit state code corresponding to the location used for direction_a and end_a . It will automatically be converted to the full state name and wikilinked. If the road passes through more than one state, use state2 for the "other end" of the road.
|
"qld", "nsw", "act", "vic", "tas", "sa", "wa", "nt" or "jbt". |
|
If the road passes through only one state, this parameter will not be used. When it is used, use the 2 or 3 digit state code corresponding to the location used for direction_b and end_b . It will automatically be converted to the full state name and wikilinked.
|
Image and map parameters: | ||||
---|---|---|---|---|
|
Source/notes | Values | ||
|
|
{{AUshield}} with |size= set (for shields),or image filename without "File:" (for other images) | ||
|
Promotional logos can also be used here (subject to copyright considerations), see Majura Parkway as an example of this. | image filename without "File:" | ||
|
This is an optional field. If not specified, the image width will default to |upright=0.81 , which is approximately 180px if the default thumbnail size has not been changed at Special:Preferences) The size should not be set to a value that would result in an image width greater than 270px. See help below for guidance on determining the value to be used.
|
number | ||
|
Alt text for the logo image | wikitext (can contain links) | ||
|
image filename without "File:" | |||
|
This is an optional field. If not specified, the image width will default to |upright=1.23 , which is approximately 270px if the default thumbnail size has not been changed at Special:Preferences) The size should not be set to a value that would result in an image width greater than 300px. See help below for guidance on determining the value to be used.
|
number | ||
|
a caption for the image | wikitext (can contain links) | ||
|
Alt text for the image | |||
|
a map showing the location of the road. See this example. See here for a list of map images. If an image is not available, the locator map function may be used to provide the reader with an indication of the road's general location. | image filename without "File:" | ||
|
A mapframe map showing the location of the road will display by default if both location is not set, and the page's Wikidata item has a coordinate location (P625) statement. The road itself may be highlighted on the map, depending on whether an appropriate OSM relation both exists and is tagged with the relevant Wikipedia page / Wikidata item (see mw:Help:Extension:Kartographer/OSM for further details). To turn off the mapframe map, set |mapframe=no
|
"no" or leave blank | ||
| ||||
|
a caption for the location map | wikitext (can contain links) | ||
|
Alt text for the location map | |||
|
set to nomap to suppress any automatically generated location map
|
nomap, auto, or blank | ||
|
Forces the locator map to use an alternative, rather than the state map, regardless of the contents of state .
|
Name of the alternative map | ||
|
Forces the locator map to use the Australian, rather than the state map, regardless of the contents of state .
|
"yes" or leave blank, plain text, do not link | ||
|
Forces the locator map to use the lga map. For this to work, both state and lga must be set, with only one value in each.
| |||
|
forces the locator map to use the relief version of the map. For an example of the relief map used in an infobox, see Top End. | |||
|
For coordinates, use {{coord}} with display=inline. Please do not be overly precise. |
Example: {{Coord|32|45|41.3|S | ||
|
For coordinates, use {{coord}} with display=inline. Please do not be overly precise. |
Example: {{Coord|32|45|41.3|S | ||
|
position of the map label for end_a relative to the pushpin
|
left, right, top, bottom default: left | ||
|
position of the map label for end_b relative to the pushpin
|
left, right, top, bottom default: left | ||
|
a caption for the locator map | optional, wikitext (can contain links) | ||
|
Alt text for the locator map | wikitext (can contain links) |
General information parameters: | ||
---|---|---|
|
Source/notes | Values |
|
length of the road in km | unformatted numeric value, will be formatted if length >= 1000. |
|
Number of decimal places for round the converted length value. Normally not needed – only use if the default precision is not appropriate | single integer numeric value |
|
reference for the length of the road | properly formatted reference, preferably use {{cite web}}, {{cite news}} or other citation template |
|
date or year that the road was opened | plain text |
|
date or year that the road was closed | |
|
Date the road was gazetted | date |
|
Reference for the road's gazettal | properly formatted reference, preferably use {{cite web}}, {{cite news}} or other citation template |
|
Name of the company or authority that built the road | wikitext (can contain links) |
|
Name of the authority that maintains the road | |
|
brief, significant notes about the road's history that should be expanded upon in the prose, and not be a replacement for it. | |
|
route allocation | route shield, wikitext (can contain links) |
|
Information about former route designation, etc. | |
|
Information about upcoming route designation, etc. | |
|
a list of the tourist routes that follow the road | |
|
The name of the locality that the ring road encircles. If this parameter is defined, it will override tloop . When this parameter is used, direction_a and direction_b should not be used.
|
wikitext (can contain links) |
|
The name of the locality that the tourist rad encircles. If ring is defined, it will override this parameter. When this parameter is used, direction_a and direction_b should not be used.
|
Junction information parameters: (only use with type=junction )
| ||
---|---|---|
|
Source/notes | Values |
|
Type of road junction. See Category:Road junction types for examples. | wikitext (can contain links) |
|
height of the road junction in metres | unformatted numeric value, will be formatted if length >= 1000. |
|
single integer numeric value | |
|
reference for the height of the road junction | properly formatted reference, preferably use {{cite web}}, {{cite news}} or other citation template |
|
number of bridge spans at the road junction | number |
|
List of roads at the road junction. Use a bulleted list (which will display as a plain list). | wikitext (can contain links) |
Junction list parameters: | ||
---|---|---|
|
Source/notes | Values |
|
direction of one end of the road. For split roads (see further down), instead use direction_a1 , direction_a2 and direction_a3
|
plain text, "North", "South", "East", "West" or, when the direction is not one of these, use an abbreviated version, "NE", "SSW" etc. See Cardinal direction for advice. |
|
direction of the other end of the road. For split roads (see further down), instead use direction_b1 , direction_b2 and direction_b3
| |
|
location of the end of the road. For split roads, instead use end_a1 , end_a2 and end_a3
|
route shield, wikitext (can contain links) |
|
location of the other end of the road. For split roads, instead use end_b1 , end_b2 and end_b3
| |
|
If the road is split into named sections, set this to a non-null value. When set, it enables parameters listed further down this list used for the individual sections. up to 3 sections may be specified | "yes" or leave blank, plain text, do not link |
|
list of major exits/interchanges. For split roads, instead use exits1 , exits2 and exits3
Note: Do not include a note linking to the full list further down the article. Per the Manual of Style for Infoboxes, this is not the purpose of the infobox – the table of contents provides that function. |
route shield, wikitext (can contain links) |
|
For split roads with named sections, use section1 , section2 and section3 to specify the names for each of up to 3 sections.
|
wikitext (can contain links) |
Location parameters: | ||
---|---|---|
|
Source/notes | Values |
|
region(s) through which the road passes | route shield, wikitext (can contain links) |
|
List of LGA(s) through which the road passes. For multiple LGAs, use a bulleted list (which will display as a plain list). | wikitext (can contain links) |
|
List of suburbs and other settlements through which the road passes. For multiple locations, use a bulleted list (which will display as a plain list). | |
|
Place where the road is located. This should be as detailed as is necessary. For road junctions, this will typically be a suburb. | wikitext (can contain links) |
Highway system parameters: | ||
---|---|---|
|
Source/notes | Values |
|
causes "Highway system" links to be shown at the bottom of the infobox. Is turned on by default when type = "highway", "expressway", "freeway", "motorway", or "parkway", and is usually not used for the other road types. | "yes" or "no" or leave blank (for default behaviour), plain text, do not link |
|
causes an additional "Highway system" link to be shown for the specified state or territory, in addition to the links automatically determined from the state and state2 parameters. Will have no effect unless the highway links are already shown, either by default or with |show_links=yes
|
"qld", "nsw", "act", "vic", "tas", "sa", "wa", or "nt". |
Restrictions parameters: | ||
---|---|---|
|
Source/notes | Values |
|
brief, significant notes about any restrictions on the road, such as regular seasonal closures or permit requirements needed for access. Content here should be expanded upon in the prose, and not be a replacement for it. | wikitext (can contain links) |
|
If permits are required, include number. Leave blank if not required. Only visible when type=track | plain text |
|
Brief description of fuel availability on the road, only visible when |type=track
|
wikitext (can contain links) |
|
Brief description of facilities on the road, only visible when |type=track
|
TemplateData
[edit]TemplateData documentation used by VisualEditor and other tools
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
See a monthly parameter usage report for Template:Infobox Australian road in articles based on its TemplateData.
TemplateData for Infobox Australian road An infobox template for Australian road articles.
|
Notes
[edit]Type
[edit]The infobox type affects the colour of the top bar of the infobox.
Colour[a] | |type=
|
---|---|
Snow Flurry (greenish) | highway |
Light Yellow | road, rural road |
Antique White | street |
Lavender | expressway, freeway, motorway, parkway |
Cape Honey (yellowish) | track |
Ghost White | junction |
Mauve | Undefined |
|status= , |uc_former=
| |
Grandis | under construction, uc, proposed |
Dark Grey | closed |
Calculating "image_upright"
[edit]The |image_upright=
parameter, and |image2_upright=
and |logo_upright=
where applicable, are provided so as to facilitate the use of scalable images in this infobox, in accordance with the instructions at WP:IMAGESIZE, which advises against the use of "px" (for example: thumb|300px
), as this forces a fixed image width.
Scalable images respect the user's base preference, which may have been selected for that user's particular devices. Module:InfoboxImage, which is used in this infobox, accommodates the use of scaling. However, setting the appropriate scale is slightly more complex than setting a raw "px" value. This guide provides a quick conversion table to make the process of setting a scale easier. It is based on a default thumbnail setting of 220px.
170px
→upright=0.75
180px
→upright=0.8
190px
→upright=0.85
200px
→upright=0.9
210px
→upright=0.95
220px
→upright=1
230px
→upright=1.05
240px
→upright=1.1
250px
→upright=1.15
260px
→upright=1.2
270px
→upright=1.23
280px
→upright=1.25
290px
→upright=1.3
300px
→upright=1.35
"Ref" fields
[edit]Any references should be placed within the respective "_ref" parameter's field and not within the field reserved solely for a numeric value. For example, place the reference used for the length of the road in the {{{length_ref}}} and not in the {{{length}}} parameter. Otherwise, an error may result.
Unformatted numbers and expression errors
[edit]Certain parameters require numeric values to be entered in an unformatted/raw fashion—i.e. 1000.0 NOT 1,000.0. If an expression error is present, simply remove any commas or spaces from the number.
Tracking categories
[edit]- Articles that include deprecated parameters are automatically added to Category:Pages using infobox Australian road with deprecated parameters (2).
- Articles that use unknown parameters (e.g. typos) are automatically added to Category:Pages using infobox Australian road with unknown parameters (1).
- Category:Pages using infobox Australian road with coordinates for only one end point (49)
- Category:Pages using infobox Australian road with an implicitly suppressed location map (14)
- Category:Infobox Australian road articles with an infobox mapframe map (369)
Subpages
[edit]Microformat
[edit]The HTML markup produced by this template includes an hCard microformat, which makes the place-name and location parsable by computers, either acting automatically to catalogue articles across Wikipedia, or via a browser tool operated by a person, to (for example) add the subject to an address book. Within the hCard is a Geo microformat, which additionally makes the coordinates (latitude & longitude) parsable, so that they can be, say, looked up on a map, or downloaded to a GPS unit. For more information about the use of microformats on Wikipedia, please see the microformat project.
Sub-templates
[edit]If the place or venue has "established", "founded", "opened" or similar dates, use {{start date}} for the earliest of those dates unless the date is before 1583 CE.
If it has a URL, use {{URL}}.
Please do not remove instances of these sub-templates.
Classes
[edit]hCard uses HTML classes including:
- adr
- agent
- category
- county-name
- extended-address
- fn
- label
- locality
- nickname
- note
- org
- region
- street-address
- uid
- url
- vcard
Geo is produced by calling {{coord}}, and uses HTML classes:
- geo
- latitude
- longitude
Please do not rename or remove these classes nor collapse nested elements which use them.
Precision
[edit]When giving coordinates, please use an appropriate level of precision. Do not use {{coord}}'s |name=
parameter.