साँचा:Election box/doc का स्रोत देखें

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

===Use===
These election box templates are for displaying a list of candidates and results for any election.  They produce tables like this:

{{Election box begin |title=[[United Kingdom general election, 2005|General election 2005]]: Strangford}}
{{Election box candidate with party link
  |party      = Labour Party (UK)
  |candidate  = Tony Blair
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
{{Election box candidate with party link
  |party      = Conservative Party (UK)
  |candidate  = Michael Howard
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
 {{Election box majority
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box turnout
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
{{Election box end}}

===How to use===

====Basic====
There are three basic templates:

*{{tl|Election box begin}}
*{{tl|Election box candidate}}
*{{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.

When using this template '''please''' use the ''election box end'' template rather than simply inserting <nowiki>|}</nowiki> at the end of the election box.  If you do place the <nowiki>|}</nowiki> it will be detected as an error by syntax-checking bots and will then be placed in the [[WP:WS|syntax cleanup project]] queue and will need to be fixed by someone.  Having fixed a few hundred already, it is becoming somewhat repetitive.

For example:
 <nowiki>
 {{Election box begin |title=[[United Kingdom general election, 2005|General election 2005]]: Strangford}}
 {{Election box candidate
   |party      = Labour
   |candidate  = Tony Blair
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box candidate
   |party      = Conservative
   |candidate  = Michael Howard
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box end}}
 </nowiki>

Will create this:
{{Election box begin |title=[[United Kingdom general election, 2005|General election 2005]]: Strangford}}
{{Election box candidate
  |party      = Labour
  |candidate  = Tony Blair
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
{{Election box candidate
  |party      = Conservative
  |candidate  = Michael Howard
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
{{Election box end}}

====Party links====
See [[Template:Election box candidate with party link]] for usage and set-up.

====Majority and turnout====
Two further templates:

* {{tl|Election box majority}}
* {{tl|Election box turnout}}

can be added to record the majority and turnout figures for an election. (In this context, "[[majority]]" refers to the winning margin between the first and second placed candidates.)

For example:
 <nowiki>
 ...
 {{Election box majority
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box turnout
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box end}}
 </nowiki>

Will create this:
{{Election box begin |title=[[United Kingdom general election, 2005|General election 2005]]: Strangford}}
{{Election box candidate with party link
  |party      = Labour Party (UK)
  |candidate  = Tony Blair
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
{{Election box candidate with party link
  |party      = Conservative Party (UK)
  |candidate  = Michael Howard
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
 {{Election box majority
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box turnout
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
{{Election box end}}

====Election outcome====
Finally there are two templates:

* {{tl|Election box hold with party link}}
* {{tl|Election box gain with party link}}

that can be used to summarize the outcome of an election, in terms of whether the incumbent holds the seat or whether it is lost to another party.

For example:
 <nowiki>
 ...
 {{Election box hold with party link
   |winner     = Labour Party (UK)
   |swing      = +10.0
 }}

 or...

 {{Election box gain with party link
   |winner     = Conservative Party (UK)
   |loser      = Labour Party (UK)
   |swing      = +10.0
 }}
 {{Election box end}}
 </nowiki>

Will create this:
{{Election box begin |title=[[United Kingdom general election, 2005|General election 2005]]: Strangford}}
{{Election box candidate with party link
  |party      = Labour Party (UK)
  |candidate  = Tony Blair
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
{{Election box candidate with party link
  |party      = Conservative Party (UK)
  |candidate  = Michael Howard
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
 {{Election box majority
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box turnout
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box hold with party link
   |winner     = Labour Party (UK)
   |swing      = +10.0
 }}
{{Election box end}}

or this...

{{Election box begin |title=[[United Kingdom general election, 2005|General election 2005]]: Strangford}}
{{Election box candidate with party link
  |party      = Labour Party (UK)
  |candidate  = Tony Blair
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
}}
 {{Election box candidate with party link
  |party      = Conservative Party (UK)
  |candidate  = Michael Howard
  |votes      = 9,999
  |percentage = 50.0
  |change     = +10.0
 }}
 {{Election box majority
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box turnout
   |votes      = 9,999
   |percentage = 50.0
   |change     = +10.0
 }}
 {{Election box gain with party link
   |winner     = Conservative Party (UK)
   |loser      = Labour Party (UK)
   |swing      = +10.0
 }}
{{Election box end}}

Notes:
*The ''swing'' parameter represents [[Peter Snow]]'s [[Swingometer]] measure, i.e. the percentage change (or swing) in the vote since the last election.
*When preparing the tables in advance of an election, it may be convenient to include these two templates but commented out (using <code> &lt;!-- and --> </code>) until the outcome is known.
*Potentially there is a need for versions of these templates that do not have the ''party link'' mechanism.  However, it can be argued that any party that has a successful candidate deserves an article about them and the full /meta/color treatment.  The one obvious exception to this is, of course, independent candidates, who won't actually have a party.  If / when there's a need, just create a non ''party link'' version of these templates.

===List of templates===
{{List of Election Box Templates}}

===Blanks by country===
* [[Template:Election box/UK-blanks|United Kingdom]]
* [[Template:Election box/US blanks|United States]]

===Extensions===
*[[Template:Election FPTP begin]] As 1, but includes an additional column for expenditures. [[Bulkley Valley-Stikine|Example]]
*[[Template:Election box begin for list]] As 1, but better suited to list-based multi-member constituencies. [[London (European Parliament constituency)|Example]]
*[[Template:Election box candidate for alliance]] As 3, with an additional "side" party. [[Newbury (UK Parliament constituency)#Elections in the 1980s|Example]]

===See also===
*[[Template:Compact election box]] A more compact box for first-past-the-post elections

<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Election and referendum infobox templates]]

</includeonly>