Editing Module:United Nations Security Council election results/doc

== Usage ==
This module produces a table of results of elections of non-permanent members of the United Nations Security Council.

The numbered arguments contain the votes for the individual countries. Each numbered argument should be a colon-separated list, the last element of which is a comma-separated list of vote counts in the rounds of voting. The remaining elements are the name and arguments of a template to be called to display the country. Usually, this will just be the three-letter country code, so a typical argument would be <code>ITA:65,108,128</code>, which displays the country as {{demo inline|<nowiki>{{ITA}}</nowiki>}}. Some South American countries use a special state variant of their flag at the United Nations; the more general form of the argument allows for such variants; e.g. <code>flag:Peru:state:99,101</code> displays the country as {{demo inline|<nowiki>{{flag|Peru|state}}</nowiki>}}.

The named arguments are as follows:

{| class="wikitable"
! Parameter
! Description
! Status
|-
| <code>valid</code>
| counts of valid ballots
| '''required'''
|-
| <code>invalid</code>
| counts of invalid ballots
| optional
|-
| <code>abstentions</code>
| counts of abstentions
| '''required'''
|-
| <code>group</code>
| regional group(s)
| '''required'''
|-
| <code>ref</code>
| content for reference tag
| optional
|-
| <code>ref_name</code>
| name for reference tag
| optional
|-
| <code>day</code>
| election day for title
| optional
|-
| <code>round</code>
| first voting round
| optional
|}

The counts are specified as comma-separated lists. The counts of valid ballots and abstentions are required; they are used to calculate the number of members present and voting (valid ballots minus abstentions) and the required two-thirds majority (two thirds of those present and voting, rounded up). The counts of invalid ballots may also be specified; they are only displayed if they are not all zero. 

The named arguments with counts must specify a count for each round. The numbered arguments may specify fewer counts; the remaining counts are taken to be zero. (This is useful when a country withdraws during the election.) Zero counts for countries (whether specified or not) are displayed as dashes; zero counts in named arguments are displayed as zeros. Country vote counts greater or equal to the required majority are displayed in bold.

If at least one of <code>ref</code> and <code>ref_name</code> is specified, a reference tag is inserted after the table's title. Any number of such reference tags can be produced using <code>ref2</code> and/or <code>ref_name2</code> etc. (with <code>ref1</code> and <code>ref_name1</code> being aliases for <code>ref</code> and <code>ref_name</code>, respectively). The optional <code>day</code> parameter can be used to specify which of several election days the table refers to; for instance, <code>day=two</code> results in " – day two" being appended to the title. The optional <code>round</code> specifies the number of the first round; the default is 1.

== Example ==

{{demo|<nowiki>{{#invoke:United Nations Security Council election results|table
|ETH:185
|KAZ:113,138
|THA:77,55
|valid=192,193
|invalid=1,0
|abstentions=2,0
|group=African and Asia-Pacific Groups
|ref_name=ga
|ref={{UN document|docid=A/70/PV.106|body=A|session=70|type=V|meeting=106|meetingtime=10 a.m.|page=2|date=28 June 2016|accessdate=4 August 2024}}
}}</nowiki>}}

<includeonly>{{Sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Wikipedia modules]]
}}</includeonly>