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

{{Documentation subpage}}
<!-- 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 = Nick Xenophon Team
|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 party style]], it will use the colour for that party, while [[:Template:Australian politics/name]], will return a linked name for that party. This may be differnt for state elections, such as "liberal sa" or "labor qld". If they are not listed, the box is white and the party unliknked. 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 = Nick Xenophon Team
   |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 = Nick Xenophon Team
|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 = Nick Xenophon Team
|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}}

{{Election box begin}}
{{Election box candidate AU party
|candidate = (included to format the table)
|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 = (included to format the table)
|party = 
|votes = 
|percentage = 
|change = 
}}
{{Election box hold AU party|
|winner = Nick Xenophon Team
|swing = -2.5
}}
{{Election box end}}

{{Election box begin}}
{{Election box candidate AU party
|candidate = (included to format the table)
|party = 
|votes = 
|percentage = 
|change = 
}}
{{Election box gain AU party|
|winner = Labor
|loser = Liberal
|swing = +2.5
}}
{{Election box end}}

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

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[id:Templat:Election box candidate AU party]]</includeonly>