Jump to content

Template:Cite UN World Population Prospects/doc

From Wikipedia, the free encyclopedia

Generates a citation for the "World Population Prospects" spreadsheet of the United Nations Department of Economic and Social Affairs, Population Division.

Usage

[edit]
  • {{Cite UN World Population Prospects|YYYY}}
  • {{cite UN WPP|YYYY|rows=first:last|cols=col1, col2, col3, ...}}

Parameters

[edit]

One required positional parameter, and multiple named parameters:

  • |1=, year of the report. Required, no default; legal values: 2019, 2022.

All named parameters are optional. These four are unique to this template; normally, just use the first one or two, and default the rest:

  • |rows=, enter comma-separated spreadsheet row numbers or colon-separated ranges; e.g., 7870:7941.
  • |cols=, enter comma-separated alphabetic spreadsheet column id's or colon ranges; e.g.: X,AE,S,AH,S,AA:AC,T.
  • |short=yes, abbreviates title, author, publisher; drops version and archive linkage; default: includes all fields and uses the long form.
  • |tab=, which tab on the spreadsheet contains the data; default: Estimates. Alias: |sheet=. Ex: if the WP article cites the "Medium variants" tab of the spreadsheet, then include |tab=Medium variants.

The remaining parameters are available if you need to override the defaults provided by the template, but should be left out otherwise. These parameters wrap {{Citation}} parameters of the same name; see Citation#Parameters for more information about these.

As inline citation

[edit]

The template may be used as an inline citation, by placing it between ref tags:

<ref>{{Cite UN World Population Prospects|2022}}</ref>

This creates a footnote marker inline, generating and linking it with the complete citation in the references section in the footer of the article, just as if a complete {{Citation}} template had been used at that point in the body.

If desired, as with any inline citation, the ref tag may be named, to enable re-use inline in other parts of the transcluding demographic article:

Some population data.<ref name="UNWPP-2022">{{Cite UN World Population Prospects|2022}}</ref>
. . .
Some additional data needing a citation.<ref name="UNWPP-2022" />

In cases where subsequent inline citations refer to different rows (country data) or columns (population or other statistics) from the spreadsheet, the {{rp}} template may be used with parameter {{at}} to specify different rows or columns than the first inline citation uses:

Some population data.<ref name="UNWPP-2022">{{Cite UN World Population Prospects|2022}}</ref>
. . .
Some data from country B.<ref name="UNWPP-2022" />{{rp|at=2125:2145; X,AH,S}}

With shortened footnotes

[edit]

This template is designed for easy use with short citations, so you can add the {{cite UN WPP}} citation just once to the References section of the article, and then include multiple {{sfn|UN WPP|2022|loc=...}} short footnote templates in-line in the article, each one with different value for the |loc= param, which will encode the row and column locations. Each inline short citation will link to the unique {{cite UN WPP}} citation in the References section of the article, so the long citation doesn't need to be repeated; it only has to be there once. See Help:Shortened footnotes for an introduction to shortened footnotes.

Note that you can put any text string as the value of |loc=, in particular, it doesn't have to be exactly 'rows' and 'cols'; it could be: |loc=row 7875:7879, col S,X,AB=, or |loc=r. 7875:7879, c. S,X,AB=, or |loc=rows 7875 to 7879, and cols. S,X, and AB=, or whatever makes sense.

If you are using the UN WPP report on a page that uses shortened footnotes, then you can place just one copy of {{cite UN WPP}} in the "References" section (sometimes called "Bibliography", or "Works cited"), and refer to the citation using either standard <ref>...</ref> tags, or using the {{sfn}} template. In this case, use the simplest version of {{cite UN WPP}} with only the required year; leave parameters |rows= and |cols= out. The row and column information will be provided in the {{sfn}} templates using the |loc= parameter of sfn, separated by a comma, so that each sfn reference can point to different rows and columns as necessary. See § Examples below.

For details about usage of {{sfn}} with |loc=, see Template:Sfn § Location in the source text.

Under the hood: Internally, the template automatically creates a simple #CITEREF reference anchor which is equivalent to the output of {{harvid|UN WPP|YYYY}}. So for 2022, it's equivalent to {{harvid|UN WPP|2022}} (i.e., citerefun_wpp2022). This may be used in shortened footnotes to link to the full citation, such as via {{sfn|UN WPP|2022|loc=row 7875:7879, col S,X,AB}}. See Anchored citations.

Examples

[edit]

Example one – short footnotes

Monaco's 2021 population is small, with a low birth rate of 9.5.{{sfn|UN WPP|2022|loc=row 14133, cols M,Z}} Botswana's pop is bigger, and has a 26.1 CBR.{{tlc|sfn|UN WPP|2022|loc=row 7941, cols M,Z}} Belgium's is biggest, but has an NRR of 0.82.{{tlc|sfn|UN WPP|2022|loc=rows 13773, cols M,AB}}

=== References ===
{{Cite UN World Population Prospects|2022}}
{{reflist}}

This results in the following:

Monaco's 2021 population is small, with a low birth rate of 9.5.[1] Botswana's pop is bigger, and has a 26.1 CBR.[2] Belgium's is biggest, but has an NRR of 0.82.[3]

References

United Nations Department of Economic and Social Affairs Population Division (2022). "World Population Prospects 2022 Demographic indicators by region, subregion and country, annually for 1950-2100" (XLS (91MB)). United Nations Population Division. 27 (Online ed.). New York: United Nations Department of Economic and Social Affairs, Population Division. rows, cols. Archived from the original on 2022-08-09.

  1. ^ UN WPP 2022, row 14133, cols M,Z.
  2. ^ UN WPP 2022, row 7941, cols M,Z.
  3. ^ UN WPP 2022, rows 13773, cols M,AB.

End of example one.

See also

[edit]