Template:Canadian election result/total/sandbox

From Wikipedia, the free encyclopedia
Jump to: navigation, search

|- style="background-color:white" |colspan=3 style="text-align:right;border-top:1px solid darkgray;"| |style="text-align:right;border-top:1px solid darkgray;"|

Template documentation[view] [edit] [history] [purge]

The template {{Canadian election result}} is intended to create tables showing the election or by-election results in one riding. It can be used on the pages of the ridings, of the candidates, or on template pages that are transcluded onto both. It works in conjunction with five other templates: {{Canadian election result/top}}, {{Canadian election result/total}}, {{Canadian election result/gain}}, {{Canadian election result/hold}}, and {{Canadian election result/source}}. This template can duplicate the functions of all of the 53 existing federal and provincial CanElec templates.

/top template[edit]

Begin each table with {{Canadian election result/top}}.

The first thing that needs to be specified is whether this is a federal election, or provincial or territorial.

Use the standard two-letter codes for postal abbreviations or second-level domains of the .ca country-code domain. A table is given at the bottom of this page.

General format[edit]

Basic form

Use {{Canadian election result/top|jurisdiction|election}}. The jurisdiction field should be the two-letter code and the election field should be the year.

For example, {{Canadian election result/top|MB|2011}} gives:

Manitoba general election, 2011
Party Candidate Votes
With riding name

Use {{Canadian election result/top|jurisdiction|election|riding|riding display}}. The riding display field can be omitted when the riding's article name does not contain disambiguation.

For example, {{Canadian election result/top|CA|2008|Barrie (electoral district)|Barrie}} gives:

Canadian federal election, 2008: Barrie
Party Candidate Votes
With extra data columns

Extra columns can be added to provide additional dato. For example, {{Canadian election result/top|CA|2006|Toronto—Danforth|percent=yes|change=yes|expenditures=yes}} gives:

Canadian federal election, 2011: Toronto—Danforth
Party Candidate Votes % ∆% Expenditures

General parameters[edit]

first unnamed parameter; or jurisdiction=
This is a two-letter code. Valid two-letter codes correspond to the standard postal abbreviations or second-level domains of .ca. Note that for Newfoundland and Labrador elections before 2001, the code is NF rather than NL.
second unnamed parameter or election=
This is the four-digit year for a general election, or some other text (for example a full date) for a by-election.
third unnamed parameter or riding=
This is the full title of a Wikipedia article about a riding. For example: Barrie (electoral district)
Note that Canadian federal ridings often use an em dash naming convention (for example: Brome—Missisquoi). Other jurisdictions may have different conventions; for instance, Quebec provincial ridings use an en dash instead, and only if hyphens already occur elsewhere in the name (eg, Drummond–Bois-Francs, but Brome-Missisquoi).
(optional) fourth unnamed parameter or riding_display=
This is the displayed text for the riding name, if different from the above. For example: Barrie

Optional parameters[edit]

by=yes
Use for by-elections. When using this, give the full date of the by-election rather than just the year.
reason=
Explain the reason for the by-election. For example, reason=upon the resignation of Jon Doe.
percent=yes
Use this parameter to add a column with the heading "%".
change=yes
Use this parameter to add a column with the heading "∆%".
expenditures=yes
Use this parameter to add a column with the heading "Expenditures".
elected=yes
Use for multi-member ridings that elect multiple members off of one ballot to add a column with the heading "Elected".
1st=yes|percent=yes|final=yes|percent2=yes
Use these parameters to create columns for multi-round elections.
ballot=A or ballot=B or ballot=C
Use one of these parameters for multi-member ridings that run multiple ballots each with a different slate of candidates during each election. It will only change the links in the heading.
collapsed=
The table is by default collapsible. You can set the initial collapsedness as follows: yes, auto, or no. These correspond to initial states of "collapsed", "autocollapse", or none, as documented at Help:Collapsing. For instance, if an article about a riding has a long list of election results from years past, you may want to have the first one display (for the most recent election) but keep the previous election years collapsed.

Main template[edit]

Use a copy of this template, {{Canadian election result}}, for each row. The basic version of template is {{Canadian election result |jurisdiction |party |candidate |votes}}. The jurisdiction must be the two-letter provincial code or "CA" for federal elections. The party name must match the format of party names in the "input text" column of the master list of parties. The candidate name can be wikilinked if the article exists. The full version of this template is {{Canadian election result |jurisdiction |party |candidate |votes |4th column |5th column |6th column}}. The last three fields are optional, and what should be put in them depends on what headers were used. For multi-member ridings, use elected=yes to add a checkmark in the "Elected" column.

/total template[edit]

Use a copy of this template, {{Canadian election result/total}}, for each total row (for example, Total valid votes, Total rejected ballots, Total turnout). The full version of this template is {{Canadian election result/total |heading |votes column |4th column |5th column |6th column}}. The last three fields are optional.

See Canadian election result/total documentation for instructions on how to find the data and complete the various total rows.

/gain and /hold templates[edit]

These templates can be used to identify gains and holds for the winning party, together with the swing calculated for the result compared to the previous election. The basic version of template is {{Canadian election result/gain |jurisdiction |gaining party |losing party |swing}} and {{Canadian election result/hold |jurisdiction |party |swing}}, with the jurisdiction and party input in the same way as in {{Canadian election result}}. The /gain template may additionally add the party that the seat was taken from in the third parameter.

Swing calculated using the formula ((∆%₁− ∆%₂) ÷ 2 ) (i.e. Change in winner's percentage compared to previous year minus change in second place percentage divided by two)

For example, {{CANelec/gain |AB |Liberal |PC |+11.20}} produces:

Liberal gain from Progressive Conservative Swing +11.20

/source and /note templates[edit]

These templates can be used to add a row to the bottom of the table. For example: {{Canadian election result/source|All data comes from elections Canada.}}. If the line of text contains an equals sign, as many government links do, name the field source=.

Links to multiple source can be added in an expandable “Source(s)}” section by assigning all the links to the parameter hide= (create separate lines by separating each source with <br />).

For example: {{CANelec/source|hide={{cite web |title=Source 1 |url=http://www.elections.ca/source1 |publisher=[[Elections Canada]]}}<br />{{cite web |title=Source 2 |url=http://www.elections.ca/source2 |accessdate=11 August 2017}} }} in a table produces:

Canadian federal election
Party Candidate Votes % ∆%

end template[edit]

Finish election boxes with the {{end}} template.

Example[edit]

Here is an example using the federal riding of Ottawa Centre in the 2011 federal election. The code:

{{Canadian election result/top|CA|2011|Ottawa Centre|percent=yes|change=yes}}
{{CANelec|CA|NDP|[[Paul Dewar]]|33,805|52.11|+12.37}}
{{CANelec|CA|Conservative|Damian Konstantinakos|14,063|21.68|-1.89}}
{{CANelec|CA|Liberal|Scott Bradley|13,049|20.12|-5.90}}
{{CANelec|CA|Green|Jen Hunter|3,262|5.03|-4.89}}
{{CANelec|CA|Marijuana|John Andrew Akpata|326|0.50|-0.09}}
{{CANelec|CA|Independent|Romeo Bellai|210|0.32|–}}
{{CANelec|CA|Communist|Stuart Ryan|109|0.17|–}}
{{CANelec|CA|Marxist-Leninist|Pierre Soublière|44|0.07|-0.08}}
{{Canadian election result/total|Total valid votes/Expense limit|64,868|100.00|–}}
{{Canadian election result/total|Total rejected ballots|267|0.41|0.00}}
{{Canadian election result/total|Turnout|65,135|74.96|+5.85}}
{{Canadian election result/total|Eligible voters|86,898}}
{{CANelec/hold |CA |NDP |+9.14%}}
{{end}}

will produce:

Canadian federal election, 2011: Ottawa Centre
Party Candidate Votes % ∆%
New Democratic Paul Dewar 33,805 52.11 +12.37
Conservative Damian Konstantinakos 14,063 21.68 -1.89
Liberal Scott Bradley 13,049 20.12 -5.90
Green Jen Hunter 3,262 5.03 -4.89
Marijuana John Andrew Akpata 326 0.50 -0.09
Independent Romeo Bellai 210 0.32
Communist Stuart Ryan 109 0.17
Marxist–Leninist Pierre Soublière 44 0.07 -0.08
Total valid votes/Expense limit 64,868 100.00
Total rejected ballots 267 0.41 0.00
Turnout 65,135 74.96 +5.85
Eligible voters 86,898
New Democratic hold Swing +9.14%

TemplateData (main template)[edit]

This template produces one row in a table of Canadian election results

Template parameters

Parameter Description Type Status
Jurisdiction 1

Use two-letter codes. Canada=CA, Ontario=ON, PEI=PE, etc. For cities, use three-letter codes.

Default
Example
empty
Auto value
empty
Line required
Party 2

Short-form name of the candidate's political party

Default
Example
empty
Auto value
empty
Line required
Candidate 3

Name of the candidate. Can be wikilinked.

Default
Example
empty
Auto value
empty
Line optional
Votes 4

Number of votes won by the candidate.

Default
Example
empty
Auto value
empty
Line optional
4th column 5

Adds text to the 4th column. Check the table's headings to see what information belongs in this column.

Default
Example
empty
Auto value
empty
Line optional
5th column 6

Adds text to the 5th column. Check the table's headings to see what information belongs in this column.

Default
Example
empty
Auto value
empty
Line optional
6th column 7

Adds text to the 6th column. Check the table's headings to see what information belongs in this column.

Default
Example
empty
Auto value
empty
Line optional
Elected elected

Used for ridings that elect multiple candidates on one ballot. Write 'yes' to add a checkmark in the last column.

Default
Example
empty
Auto value
empty
Line optional

See also[edit]

Template documentation[view] [edit] [history] [purge]

Calculating Totals[edit]

Ontario general election, 2011: Oak Ridges—Markham
Party Candidate Votes % ∆% Expenditures
Liberal Helena Jaczek 28,878 44.78 -3.43 $  83,066.00
Progressive Conservative Farid Wassef 23,950 37.14 +1.07 146,606.59
New Democratic Joe Whitfeld 8,548 13.26 +5.33 11,142.60
Green Trifon Haitas 1,569 2.43 -4.01 350.00
Libertarian Karl Boelling 1,057 1.64     –   213.07
Independent Ruida Lu 484 0.75     2,766.14
Total valid votes/Expense limit 64,486  100.0   +8.85 $180,834,78
Total rejected ballots 395 0.61 -0.13
Turnout 64,881 42.70 -5.07
Eligible voters 151,959   +21.63
** Preliminary results — Not yet official **
Sources:"Summary of valid votes cast for each candidate – October 6, 2011 General Election" (PDF). Elections Ontario. 2011-11-18. Retrieved 2014-05-23. 
"Statistical Summary" (Microsoft Excel 2013 logo.svg Excel Spreadsheet). Elections Ontario. 2013-10-01. Retrieved 2014-05-23. 
"2011 Candidate Campaign Returns - CR-1". Elections Ontario. 
 Item  Source / Formula
   Candidates List candidates in order used in official list  (e.g. http://wemakevotingeasy.ca/en/electoral-districts/059-oak-ridges-markham.aspx)
List election results in descending order of number of votes  (i.e. Winner first)
Votes From Summary of valid ballots by candidate report
elections.caelections.ab.cawww.elections.gov.nl.caelections.on.ca
% ❷ ÷ ❼ × 100 rounded to 2 decimal places
∆% current ❸ − previous  Note: A ⃝
For & , if Party (or same Independent candidate) didn't run last time, use "&nbsp;"; if unchanged from previous, use "  " (&ndash; &nbsp;)
A ⃝ Occasionally column does not balance due to rounding errors.  Check if:   ( ❹ + numbers in where is blank (i.e. new candidates) previous  that didn't run this time ) ≠ 0
If there are rounding issues (i.e. above totals ±0.01/±0.02) then recalculate each without rounding errors using the formula:   ( ( previous ❷ ÷ previous  ) ( current ❷ ÷ current  ) ) × 100 then rounded to 2 decimals
Expenditures From Candidate Campaign Returns - CR-1, individual candidate Financial Statements, financial summary reports (by party/candidate) (or other similar late stage reports) might be published a year after the election Until expenditure figures are published, avoid including the blank column in tables.
Totals caption Add suffix "/Expense limit" if "|expenditures=yes" in CANelec/top (causing "Expenditures" column to be displayed)
Total Votes = Balance in Statistical Summary
Total % = 100.0    Note it's "{{nowrap|100.0 &nbsp;}}" not "100.00" because .0 vs .00 solves occasional rounding issues & " &nbsp;" aligns decimals
Total ∆% ( current  previous ❼ ) ÷ previous ❼ × 100    +Increase /−Decrease in number of (valid) votes cast
Expense limit Identified in Campaign Returns / Financial Statements and/or separate reports/statements of expense & contribution limits
Rejected Votes number of rejected, unmarked, & cancelled ballots from Statistical Summary
Rejected % ÷ × 100
Rejected ∆% current ⓬ − previous 
Votes Turnout = +    matches Statistical Summary
% Turnout ÷ × 100 matches Statistical Summary but calculate to 2 decimals
∆% Turnout current  previous 
Eligible Votes from Statistical Summary Total number of names Registered + Revision
Eligible % Blank ("&nbsp;")
Eligible ∆% ( current  previous  ) ÷ previous  × 100    +Increase /−Decrease in number of eligible voters
Prelim This note should be included until official results are published/updated in table.
Use the parameter "prelim=yes" in the /source or /note templates or in the /top template to add this preformatted message.