View source for Template:Election box candidate AU party/doc

{{Documentation subpage}}
{{High-use}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

<includeonly>{{Navbar|Template:Election box candidate AU party/doc|style=float:right;|text=This content:}}</includeonly>
These election box templates are for displaying a list of candidates and results for Australian elections contested by parties. They produce tables like this:

{{Election box begin
|title=2019 Australian fictional election: [[:Utopia (Australian TV series)|Utopia]]
}}
{{Election box candidate AU party
|candidate = [[:Utopia (Australian TV series)#Characters|Katie Norris]]
|party = Liberal
|votes = 44,001
|percentage = 46.59
|change = −6.02
}}
{{Election box candidate AU party
|candidate = Ashan de Silva
|party = Centre Alliance
|votes = 27,452
|percentage = 29.07
|change = +29.07
}}
{{Election box candidate AU party
|candidate = John Clarke
|party = Labor<nowiki/>
|votes = 14,363
|percentage = 15.21
|change = −3.16
}}
{{Election box candidate AU party
|candidate = Tony Woodford
|party = Aussie battlers
|votes = 5,458
|percentage = 5.78
|change = −2.18
}}
{{Election box formal
|votes = 94,445
|percentage = 95.72
|change = +1.10
}}
{{Election box informal
|votes = 4,228
|percentage = 4.28
|change = −1.10
}}
{{Election box turnout
|votes = 98,673
|percentage = 93.44
|change = −1.18
}}
{{Election box end}}

==Usage==

====Basic====
There are six templates used in the example above:

*{{tl|Election box begin}}
*{{tl|Election box candidate AU party}}
*{{tl|Election box formal}}
*{{tl|Election box informal}}
*{{tl|Election box turnout}}
*{{tl|Election box end}}

The ''begin'' and ''end'' templates start and end a table with appropriate columns and formatting.  The ''candidate'' template is used once for each candidate and contributes a row to the table. If there is a wikipedia page for the candidate, this should be linked. If the party is listed at [[:Template:Australian politics/party colours]], it will use the colour for that party, while [[:Template:Australian politics/name]], will return a linked name for that party. This may be different for state elections, such as "liberal sa" or "labor qld". If they are not listed, there is no colour  and the party unlinked. Where you want to use a name that is different from the linked party, adding <nowiki><nowiki/></nowiki> at the end of the party name will prevent linking or using the party colour, as in the Labor example above.

Using the example above these are :
 <nowiki>
 {{Election box begin |title=2019 Australian fictional election: [[Utopia]]}}
 {{Election box candidate AU party 
   |candidate = [[Katie Norris]]
   |party = Liberal
   |votes = 44,001
   |percentage = 46.59
   |change = −6.02
 }}
 {{Election box candidate AU party
   |candidate = Ashan de Silva
   |party = Centre Alliance
   |votes = 27,452
   |percentage = 29.07
   |change = +29.07
 }}
 {{Election box candidate AU party
   |candidate = John Clarke
   |party = Labor<nowiki/>
   |votes = 14,363
   |percentage = 15.21
   |change = −3.16
 }}
 {{Election box formal
   |votes = 94,445
   |percentage = 95.72
   |change = +1.10
 }}
 {{Election box informal
   |votes = 4,228
   |percentage = 4.28
   |change = −1.10
 }}
 {{Election box turnout
   |votes = 98,673
   |percentage = 93.44
   |change = −1.18
 }}
 {{Election box end}}
</nowiki>

====Preferential Results====
One or both of the following templates are commonly used for the results where a form of preferential voting is used:

* {{tl|Election box 2pp}}: Two-party-preferred result, used where the election comes down to a choice between the two major parties, typically in Australia the Liberal/National Coalition and Labor.
* {{tl|Election box 2cp}}: Two-candidate-preferred result, used where one or both major parties is not in the top two. Where the two-party-preferred figures are also available, this may included and is typically placed before the two-candidate-preferred result.

Adding these to the table above would be

 <nowiki>{{Election box 2pp}}
{{Election box candidate AU party
|candidate = [[Katie Norris]]
|party = Liberal
|votes = 61,566
|percentage = 65.19
|change = −1.36
}}
{{Election box candidate AU party
|candidate = John Clarke
|party = Labor
|votes = 32,879
|percentage = 34.81
|change = +1.36
}}
{{Election box 2cp}}
{{Election box candidate AU party
|candidate = [[Katie Norris]]
|party = Liberal
|votes = 51,698
|percentage = 54.74
|change = −11.81
}}
{{Election box candidate AU party
|candidate = Ashan de Silva
|party = Centre Alliance
|votes = 42,747
|percentage = 45.26
|change = +45.26
}}</nowiki>

Which gives:
{{Election box begin}}
{{Election box 2pp}}
{{Election box candidate AU party
|candidate = [[:Utopia (Australian TV series)#Characters|Katie Norris]]
|party = Liberal
|votes = 61,566
|percentage = 65.19
|change = −1.36
}}
{{Election box candidate AU party
|candidate = John Clarke
|party = Labor
|votes = 32,879
|percentage = 34.81
|change = +1.36
}}
{{Election box 2cp}}
{{Election box candidate AU party
|candidate = [[:Utopia (Australian TV series)#Characters|Katie Norris]]
|party = Liberal
|votes = 51,698
|percentage = 54.74
|change = −11.81
}}
{{Election box candidate AU party
|candidate = Ashan de Silva
|party = Centre Alliance
|votes = 42,747
|percentage = 45.26
|change = +45.26
}}
{{Election box end}}

====Final result====
One of the following templates then concludes the results
* {{tl|Election box new seat win AU party|Election box '''new seat win''' AU party}}
* {{tl|Election box hold AU party}}
* {{tl|Election box gain AU party}}
* {{tl|Election box member change AU party}}

If there is a redistribution which changes the [[Redistribution (Australia)#Notional seat status|notional seat status]], adding <code><nowiki>|notional = yes</nowiki></code> clarifies that the hold or gain is notional

{{Election box begin}}
{{Election box candidate AU party
|candidate = (new seat win)
|party = 
|votes = 
|percentage = 
|change = 
}}
{{Election box new seat win AU party
|winner = Liberal
|swing = N/A
}}
{{Election box end}}

{{Election box begin}}
{{Election box candidate AU party
|candidate = (hold)
|party = 
|votes = 
|percentage = 
|change = 
}}
{{Election box hold AU party
|winner = Centre Alliance
|swing = -2.5
}}
{{Election box hold AU party
|notional = yes
|winner = Centre Alliance
|swing = -2.5
}}
{{Election box end}}

{{Election box begin}}
{{Election box candidate AU party
|candidate = (gain)
|party = 
|votes = 
|percentage = 
|change = 
}}
{{Election box gain AU party
|winner = Labor
|loser = Liberal
|swing = +2.5
}}
{{Election box gain AU party
|notional = yes
|winner = Labor
|loser = Liberal
|swing = -2.5
}}
{{Election box end}}

{{Election box begin}}
{{Election box candidate AU party
|candidate = (member change)
|party = 
|votes = 
|percentage = 
|change = 
}}
{{Election box member change AU party
|old=Australian
|new=Australia
|swing = -6.5
}}
{{Election box end}}

== See also ==
[[Template:Election box/doc]]

<includeonly>{{Sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Election box templates|AU party candidate]]
[[Category:Australia politics and government templates]]
[[id:Templat:Election box candidate AU party]]
}}</includeonly>