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 7870:7941, cols X,AE,S,AH,S. Archived from the original on 2022-08-09.
 | This template is a Citation Style 1 specific-source template based on {{ Citation}}. For centralized Citation Style 1 discussions, see Help talk:Citation Style 1. |
Generates a citation for the "World Population Prospects" spreadsheet of the United Nations Department of Economic and Social Affairs, Population Division.
Usage
{{Cite UN World Population Prospects|YYYY}}{{cite UN WPP|YYYY|rows=first:last|cols=col1, col2, col3, ...}}
Parameters
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.
|edition=, default:Online ed.See Citation#Edition, series, volume.|volume=, default: the id in the header of the spreadsheet (in the 2022 version, cell 'E12':POP/DB/WPP/Rev.2022/GEN/F01/Rev.1) See Citation#Edition, series, volume.|version=, series number of the population data; e.g., 2022 = '27'. See Citation#Edition, series, volume.|ref=, you may use this param with {{ harvid}} to set your own ref for {{ sfn}} linkage, as a #CITEREF reference anchor. See Citation#Anchor. For usage examples, see § With shortened footnotes below.|id=, unique id; see Citation#Identifiers.
As inline citation
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
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
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]
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.
- ^ UN WPP 2022, row 14133, cols M,Z.
- ^ UN WPP 2022, row 7941, cols M,Z.
- ^ UN WPP 2022, rows 13773, cols M,AB.
End of example one.
See also
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 7870:7941, cols X,AE,S,AH,S. Archived from the original on 2022-08-09.
| This template is a Citation Style 1 specific-source template based on {{ Citation}}. For centralized Citation Style 1 discussions, see Help talk:Citation Style 1. |
Generates a citation for the "World Population Prospects" spreadsheet of the United Nations Department of Economic and Social Affairs, Population Division.
Usage
{{Cite UN World Population Prospects|YYYY}}{{cite UN WPP|YYYY|rows=first:last|cols=col1, col2, col3, ...}}
Parameters
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.
|edition=, default:Online ed.See Citation#Edition, series, volume.|volume=, default: the id in the header of the spreadsheet (in the 2022 version, cell 'E12':POP/DB/WPP/Rev.2022/GEN/F01/Rev.1) See Citation#Edition, series, volume.|version=, series number of the population data; e.g., 2022 = '27'. See Citation#Edition, series, volume.|ref=, you may use this param with {{ harvid}} to set your own ref for {{ sfn}} linkage, as a #CITEREF reference anchor. See Citation#Anchor. For usage examples, see § With shortened footnotes below.|id=, unique id; see Citation#Identifiers.
As inline citation
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
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
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]
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.
- ^ UN WPP 2022, row 14133, cols M,Z.
- ^ UN WPP 2022, row 7941, cols M,Z.
- ^ UN WPP 2022, rows 13773, cols M,AB.
End of example one.