Template:Infobox Australian place/doc

Purpose
Infobox Australian place is used to add infoboxes to articles on places in Australian states and territories. It is not limited to populated places such as cities, towns and suburbs, but may be used on any place including regions, local government areas, cadastral units, protected areas and even some areas that do not fall into any of the preceding descriptions and for which no other infobox is appropriate. It is the standard infobox used in Australian articles. Australian articles using Infobox settlement should be converted to use this infobox.

The infobox has been extensively customised for Australia and includes automation that results in some parameters being redundant to other parameters. For example, if a population density (in the  field) is not specified, this will be automatically generated based on the   and   fields. It is therefore important to read parameter descriptions thoroughly, to avoid unnecessarily providing redundant or incorrect information.

For infoboxes that require reformatting, general cleanup or addition of missing fields, Template:Infobox Australian place/cleanup may be substed. This will reformat the infobox and remove invalid fields.

To use this template

 * 1) Copy the relevant blank template from the Blank infobox 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.
 * 2) Enter values for the fields as outlined in the table below. Fields left blank will automatically be hidden.
 * 3) Preview.
 * 4) Save the page with an appropriate edit summary.

Examples

 * Examples of this template can be found on the examples page.

Parameters
Both  and   are required parameters. All other parameters used by this template are optional. The following are available:

Type
The infobox type affects the colour of the top bar of the infobox.

IUCN categories for protected areas
Depending on the value of the  parameter, one of the following banners will be displayed below the name. Valid values are Ia, Ib, II, III, IV, V and VI. For more information read the IUCN protected area categories article. If you cannot find the correct code in a reliable source, leave blank.



Calculating "image_upright"
The  parameter, and   and   where applicable, is/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:  ), 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.


 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;
 * &rarr;



Footnotes fields
Any references should be placed within the respective "_footnotes" field and not within the field reserved solely for a numeric value. For example, place the reference used for the area of City X in the parameter and not in the  parameter. Otherwise, an error may result.

Unformatted numbers and expression errors
Certain fields 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.

Dist#, Dir# and Location#
This is the distance and approximate direction from another location. The '#' is replaced with a number between 1 and 5. Therefore, distances for up to five locations can be listed using the range 'dist1' – 'dist5'. Direction from the locations can be specified using 'dir1' – 'dir5' and the locations can be listed as 'location1' – 'location5'. Each dist# must be partnered with an appropriate location#. Dir# is optional.

Where to find information

 * WikiProject Australian places – Useful resources
 * Australian Bureau of Statistics
 * LGA links for each state
 * Bureau of Meteorology

Deprecated fields

 * – articles that include deprecated fields are automatically added. As of 5 April 2016, the tracked parameters are,  ,  ,  ,   and.

Errors

 * – articles that contain general errors are automatically added.
 * – articles missing the  or   fields are automatically added.
 * – Articles missing the  or   fields are automatically added.
 * – Articles that include parameters that are not included in the infobox. This category may include articles with incorrectly spelled, but valid parameters.
 * – Articles that include parameters that are not included in the infobox. This category may include articles with incorrectly spelled, but valid parameters.

Subpages

 * Template:Infobox Australian place
 * Template:Infobox Australian place/Blank
 * Template:Infobox Australian place/Examples
 * Template:Infobox Australian place/doc


 * Template:Infobox Australian place/sandbox
 * Template:Infobox Australian place/sandbox/doc
 * Template:Infobox Australian place/testcases

TemplateData
{	"description": "Display information about a place in Australia in a standard infobox format.", "params": { "type": { "label": "Type", "description": "The type of place, which determines the look of the infobox. Can be empty or one of the following: 'city', 'suburb', 'town', 'lga', 'region', or 'cadastral'.", "type": "string", "required": false, "suggestedvalues": [ "city", "suburb", "town", "lga", "region", "cadastral", "protected", "other" ]		},		"name": { "label": "Name", "description": "The name of the place. If this parameter is left empty, the infobox title will be blank, while if this parameter is not called at all, it defaults to the name of the article.", "type": "string", "required": false },		"city": { "label": "City", "description": "The name of the city the place is located in, which is automatically wikilinked.", "type": "string", "required": false },		"state": { "label": "State Abbreviation", "description": "The abbreviation for the state the place in located in, which can be uppercase or lowercase.", "type": "string", "required": false, "suggestedvalues": [ "sa", "vic", "nsw", "qld", "nt", "wa", "tas", "act", "jbt", "ni", "au" ]		},		"image": { "label": "Image", "description": "A filename for a generic image of the locality.", "type": "string", "required": false },		"image_upright": { "label": "Image Width", "description": "Override the default width of the image, scalable.", "type": "number", "required": false },		"caption": { "label": "Caption", "description": "A caption for the image.", "type": "string", "required": false },		"image_alt": { "label": "Image Alt Text", "description": "Alt text for the image.", "type": "string", "required": false },		"image2": { "label": "Image 2", "description": "A filename for a second image of the locality. Usually used for maps, especially in LGA articles.", "type": "string", "required": false },		"image2_upright": { "label": "Image 2 Width", "description": "Override the default width of the second image, scalable.", "type": "number", "required": false },		"caption2": { "label": "Image 2 Caption", "description": "A caption for the second image.", "type": "string", "required": false },		"image2_alt": { "label": "Image 2 Alt Text", "description": "Alt text for the second image.", "type": "string", "required": false },		"coordinates": { "label": "Coordinates", "description": "Coordinates of the locality. Use °N, °W with 'display=inlines,title'. Please don't be overly precise.", "type": "string", "required": false },		"alternative_location_map": { "label": "Alternative Location Map", "description": "Forces the locator map to use this alternative map instead of the default state map.", "type": "string", "required": false },		"force_national_map": { "label": "Force National Map", "description": "Set to 'yes' or leave this parameter blank to force the locator map to use the Australian map instead of the default state map.", "type": "string", "required": false },		"use_lga_map": { "label": "Force LGA Map", "description": "Set to 'yes' or leave this parameter blank to force the locator map to use the LGA map instead of the default state one.", "type": "string", "required": false },		"relief": { "label": "Relief Map", "description": "Set to 'yes' or leave this parameter blank to make the locator map use a relief map.", "type": "string", "required": false },		"pushpin_map_caption": { "label": "Pushpin Map Caption", "description": "The caption for the locator map's pushpin. Defaults to the place name.", "type": "string", "required": false },		"pushpin_label_position": { "label": "Pushpin Label Position", "description": "Where the caption should appear relative to the locator map's pushpin. Can be one of the following: 'left', 'right', 'top', or 'bottom'.", "type": "string", "default": "right", "required": false },		"map_alt": { "label": "Locator Map Alt Text", "description": "Alt text for the locator map.", "type": "string", "required": false },		"pop": { "label": "Population", "description": "The total population of the place.", "type": "number", "required": false },		"pop_year": { "label": "Population Year", "description": "The year in which the population measurement was taken. may be used.", "type": "number", "required": false },		"pop_footnotes": { "label": "Population Footnotes", "description": "Footnotes for the population figure. Please use references here.", "type": "string", "required": false },		"pop2": { "label": "Population 2", "description": "A second total population measurement.", "type": "number", "required": false },		"pop2_year": { "label": "Population 2 Year", "description": "The year in which the second population measurement was taken. may be used.", "type": "number", "required": false },		"pop2_footnotes": { "label": "Population 2 Footnotes", "description": "Footnotes for the second population figure. Please use references here.", "type": "string", "required": false },		"poprank": { "label": "Population Rank", "description": "Only for cities. The total population rank of the city.", "type": "number", "required": false },		"density": { "label": "Population Density", "description": "The population density of the place.", "type": "number", "required": false },		"density_footnotes": { "label": "Population Density Footnotes", "description": "Footnotes for the population density figure. Please use references here.", "type": "string", "required": false },		"established": { "aliases": [ "est" ],			"label": "Established", "description": "The date the place was established.", "type": "string", "required": false },		"abolished": { "label": "Abolished", "description": "The date the place was abolished.", "type": "string", "required": false },		"gazetted": { "label": "Gazetted", "description": "The date the place was gazetted.", "type": "string", "required": false },		"postcode": { "label": "Postcode", "description": "The postcode of the place.", "type": "number", "required": false },		"elevation": { "label": "Elevation", "description": "Elevation of the place above sea level in metres.", "type": "number", "required": false },		"elevation_footnotes": { "label": "Elevation Footnotes", "description": "Footnotes for the elevation figure.", "type": "string", "required": false },		"area": { "label": "Area", "description": "Area of the place in square kilometres.", "type": "number", "required": false },		"area_footnotes": { "label": "Area Footnotes", "description": "Footnotes for the area figure.", "type": "string", "required": false },		"timezone": { "label": "Time Zone", "description": "The time zone the place is located in.", "type": "string", "required": false },		"utc": { "label": "UTC Time", "description": "The difference between UTC time and the time zone the place resides in, in the format '+' followed by a number.", "type": "string", "required": false },		"timezone-dst": { "label": "Summer Time Zone (DST)", "description": "The summer time zone the place is located in.", "type": "string", "required": false },		"utc-dst": { "label": "Summer UTC Time (DST)", "description": "The difference between UTC time and the time zone the place resides in in the summer, in the format '+' followed by a number.", "type": "string", "required": false },		"mayor": { "label": "Mayor", "description": "LGA only. The name of the mayor of the LGA.", "type": "string", "required": false },		"mayortitle": { "label": "Mayor Title", "description": "LGA only. The title of the mayor of the LGA. Defaults to 'Mayor'.", "type": "string", "required": false },		"dist1": { "label": "Distance 1", "description": "The distance by road in kilometres from location 1 to the place.", "type": "number", "required": false },		"dir1": { "label": "Direction 1", "description": "The compass direction from location 1 to the place. Examples are 'NW', 'E', and 'SSE'.", "type": "string", "required": false },		"location1": { "label": "Location 1", "description": "Another location to compare with this one.", "type": "string", "required": false },		"dist2": { "label": "Distance 2", "description": "The distance by road in kilometres from location 2 to the place.", "type": "number", "required": false },		"dir2": { "label": "Direction 2", "description": "The compass direction from location 2 to the place. Examples are 'NW', 'E', and 'SSE'.", "type": "string", "required": false },		"location2": { "label": "Location 2", "description": "Another location to compare with this one.", "type": "string", "required": false },		"dist3": { "label": "Distance 3", "description": "The distance by road in kilometres from location 3 to the place.", "type": "number", "required": false },		"dir3": { "label": "Direction 3", "description": "The compass direction from location 3 to the place. Examples are 'NW', 'E', and 'SSE'.", "type": "string", "required": false },		"location3": { "label": "Location 3", "description": "Another location to compare with this one.", "type": "string", "required": false },		"dist4": { "label": "Distance 4", "description": "The distance by road in kilometres from location 4 to the place.", "type": "number", "required": false },		"dir4": { "label": "Direction 4", "description": "The compass direction from location 4 to the place. Examples are 'NW', 'E', and 'SSE'.", "type": "string", "required": false },		"location4": { "label": "Location 4", "description": "Another location to compare with this one.", "type": "string", "required": false },		"dist5": { "label": "Distance 5", "description": "The distance by road in kilometres from location 5 to the place.", "type": "number", "required": false },		"dir5": { "label": "Direction 5", "description": "The compass direction from location 5 to the place. Examples are 'NW', 'E', and 'SSE'.", "type": "string", "required": false },		"location5": { "label": "Location 5", "description": "Another location to compare with this one.", "type": "string", "required": false },		"lga": { "label": "Local Government Area (LGA)", "description": "The name of the local government area of the place.", "type": "string", "required": false },		"lga2": { "label": "Local Government Area (LGA) 2", "description": "Another local government area of the place.", "type": "string", "required": false },		"lga3": { "label": "Local Government Area (LGA) 3", "description": "Another local government area of the place.", "type": "string", "required": false },		"lga4": { "label": "Local Government Area (LGA) 4", "description": "Another local government area of the place.", "type": "string", "required": false },		"lga5": { "label": "Local Government Area (LGA) 5", "description": "Another local government area of the place.", "type": "string", "required": false },		"seat": { "label": "Local Government Area (LGA) Seat", "description": "The local government area's seat of government.", "type": "string", "required": false },		"region": { "label": "Region", "description": "The region the LGA is in.", "type": "string", "required": false },		"county": { "label": "County", "description": "The county the place is in.", "type": "string", "required": false },		"parish": { "label": "Parish", "description": "The parish the place is in.", "type": "string", "required": false },		"hundred": { "label": "Hundred", "description": "The hundred the place is in.", "type": "string", "required": false },		"former_hundred": { "label": "Former Hundred", "description": "The former hundred the place is in.", "type": "string", "required": false },		"division": { "label": "Division", "description": "The division the place is in.", "type": "string", "required": false },		"localgov": { "label": "Local Government", "description": "The local government electorate of the place.", "type": "string", "required": false },		"stategov": { "label": "State Government", "description": "The state government electorate of the place.", "type": "string", "required": false },		"stategov2": { "label": "State Government 2", "description": "Another state government electorate of the place.", "type": "string", "required": false },		"stategov3": { "label": "State Government 3", "description": "Another state government electorate of the place.", "type": "string", "required": false },		"stategov4": { "label": "State Government 4", "description": "Another state government electorate of the place.", "type": "string", "required": false },		"stategov5": { "label": "State Government 5", "description": "Another state government electorate of the place.", "type": "string", "required": false },		"fedgov": { "label": "Federal Government", "description": "The federal government electorate of the place.", "type": "string", "required": false },		"fedgov2": { "label": "Federal Government 2", "description": "Another federal government electorate of the place.", "type": "string", "required": false },		"fedgov3": { "label": "Federal Government 3", "description": "Another federal government electorate of the place.", "type": "string", "required": false },		"fedgov4": { "label": "Federal Government 4", "description": "Another federal government electorate of the place.", "type": "string", "required": false },		"logo": { "label": "LGA Logo", "description": "A filename for the logo, if any, of the place's LGA.", "type": "string", "required": false },		"logosize": { "label": "LGA Logo Size", "description": "Override the default width of the LGA logo, which is 175px.", "type": "number", "required": false },		"url": { "label": "LGA URL", "description": "The bare URL for the place's LGA's website.", "type": "string", "required": false },		"maxtemp": { "label": "Maximum Temperature", "description": "The maximum average annual temperature of the place in degrees Celsius.", "type": "number", "required": false },		"maxtemp_footnotes": { "label": "Maximum Temperature Footnotes", "description": "Footnotes for the maximum temperature figure. Please use references here.", "type": "string", "required": false },		"mintemp": { "label": "Minimum Temperature", "description": "The minimum average annual temperature of the place in degrees Celsius.", "type": "number", "required": false },		"mintemp_footnotes": { "label": "Minimum Temperature Footnotes", "description": "Footnotes for the minimum temperature figure. Please use references here.", "type": "string", "required": false },		"rainfall": { "label": "Rainfall", "description": "The average annual rainfall of the place in millimetres.", "type": "number", "required": false },		"rainfall_footnotes": { "label": "Rainfall Footnotes", "description": "Footnotes for the rainfall figure.", "type": "string", "required": false },		"near": { "label": "Central Near Grid", "description": "Replace the default text in the center of the 'Near' grid (the name of the place).", "type": "string", "required": false },		"near-n": { "label": "North Near Grid", "description": "The nearest neighbour of the place to the north.", "type": "string", "required": false },		"near-ne": { "label": "Northeast Near Grid", "description": "The nearest neighbour of the place to the northeast.", "type": "string", "required": false },		"near-e": { "label": "East Near Grid", "description": "The nearest neighbour of the place to the east.", "type": "string", "required": false },		"near-se": { "label": "Southeast Near Grid", "description": "The nearest neighbour of the place to the southeast.", "type": "string", "required": false },		"near-s": { "label": "South Near Grid", "description": "The nearest neighbour of the place to the south.", "type": "string", "required": false },		"near-sw": { "label": "Southwest Near Grid", "description": "The nearest neighbour of the place to the southwest.", "type": "string", "required": false },		"near-w": { "label": "West Near Grid", "description": "The nearest neighbour of the place to the west.", "type": "string", "required": false },		"near-nw": { "label": "Northwest Near Grid", "description": "The nearest neighbour of the place to the northwest.", "type": "string", "required": false }	} }