Template:Historical populations

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

{{Historical populations}} is used as an information box on pages showing each census year with a population and a percent gain/loss comparison. It is intended to combine the functionalities of two existing templates, Template:US Census population and Template:Histpop, the former of which is specialized for the United States, and the latter of which lacks many features of the former.

Usage

This template takes a series of parameters in the form |date |population. This template does not require any more than that. This template will take between 0 and 50 entries; any more will be ignored.

Full syntax

{{Historical populations
|title        = 
|align        =
|clear        =
|direction    =
|percentages  = 
|state        = 
|type         = 
|shading      = 
|width        = 
|subbox       =
|pop_name     =
|year_name    =
|percent_name =
|footnote     = 
|source       = 
|graph-pos    =
|graph-width  =
|graph-height =
|percol       =
|cols         =
|perrow       =
|rows         =
|date |population
|date |population
|date |population
|date |population
|date |population
|date |population
|date |population
}}

Parameters

Template parameters for Template:Historical populations

Parameter	Description
daten	Ideally, a four-digit year, but can be anything. Usually a multiple of 10, but does not have to be.
populationn	The population of row n. Must be a plain number with no formatting (commas, etc.).
title	Optional. The title of the table. <syntaxhighlight lang="text" class="" id="" style="" inline="1">Historical population</syntaxhighlight> (Default)
align	Optional. The alignment of the table on the page. <syntaxhighlight lang="text" class="" id="" style="" inline="1">right</syntaxhighlight> (Default) <syntaxhighlight lang="text" class="" id="" style="" inline="1">left</syntaxhighlight> <syntaxhighlight lang="text" class="" id="" style="" inline="1">center</syntaxhighlight> <syntaxhighlight lang="text" class="" id="" style="" inline="1">none</syntaxhighlight>
clear	Optional. Use to clear any left or right floating elements nearby. <syntaxhighlight lang="text" class="" id="" style="" inline="1">right</syntaxhighlight> (Default if align = right) <syntaxhighlight lang="text" class="" id="" style="" inline="1">left</syntaxhighlight> (Default if align = left) <syntaxhighlight lang="text" class="" id="" style="" inline="1">none</syntaxhighlight> (Default if align = none) <syntaxhighlight lang="text" class="" id="" style="" inline="1">both</syntaxhighlight>
direction	Optional. How the box is arranged on the page. <syntaxhighlight lang="text" class="" id="" style="" inline="1">vertical</syntaxhighlight> (Default) <syntaxhighlight lang="text" class="" id="" style="" inline="1">horizontal</syntaxhighlight>
percentages	Optional. Whether to include an automatically generated column of percent differences. This works best with linear lists (1900, 1910, 1920, etc.). Alternately, you can specify "pagr" to display annual growth rates (per annum growth rate) using the formula from Population growth. <syntaxhighlight lang="text" class="" id="" style="" inline="1">on</syntaxhighlight> (Default) <syntaxhighlight lang="text" class="" id="" style="" inline="1">pagr</syntaxhighlight> <syntaxhighlight lang="text" class="" id="" style="" inline="1">off</syntaxhighlight>
state	Optional. The collapsed state of the table. Set it to <syntaxhighlight lang="text" class="" id="" style="" inline="1">collapsed</syntaxhighlight> to collapse the table by default. <syntaxhighlight lang="text" class="" id="" style="" inline="1">none</syntaxhighlight> (Default) <syntaxhighlight lang="text" class="" id="" style="" inline="1">collapsed</syntaxhighlight>
type	Optional. This is designed to add functionality specific to different regions or types of information. Currently the only value that does anything is <syntaxhighlight lang="text" class="" id="" style="" inline="1">US</syntaxhighlight> (or the obsolescent <syntaxhighlight lang="text" class="" id="" style="" inline="1">USA</syntaxhighlight>). <syntaxhighlight lang="text" class="" id="" style="" inline="1">none</syntaxhighlight> (Default) <syntaxhighlight lang="text" class="" id="" style="" inline="1">US</syntaxhighlight> Will link each year to the relevant United States census entry. Years that do not have entries will be left alone. Please think of more ideas for this feature.
shading	Optional. Whether to mark off every five entries with a line, to facilitate reading. This works best with large, linear lists (such as the US Census, which has been taken every 10 years for over 200 years), but should probably be turned off for small or irregular lists (e.g., less than 10 entries), where it could be confusing. <syntaxhighlight lang="text" class="" id="" style="" inline="1">on</syntaxhighlight> (Default) <syntaxhighlight lang="text" class="" id="" style="" inline="1">off</syntaxhighlight>
width	Optional. The width of the table (or of each block of columns). Can be any valid CSS <syntaxhighlight lang="text" class="" id="" style="" inline="1">width</syntaxhighlight> value. <syntaxhighlight lang="text" class="" id="" style="" inline="1">15em</syntaxhighlight> (Default)
pop_name	Optional. The text in the column header of the population data. <syntaxhighlight lang="text" class="" id="" style="" inline="1">{{abbr|Pop.|Population}}</syntaxhighlight> (Default, displays as Pop.)
footnote	Optional. Free-form footnote. Can be used as a variant to, or in addition to, the source parameter.
source	Optional. Displayed as a footnote under the table with the text "Source:" inserted automatically. Every table should indicate the source of the data.
graph-pos	graph-pos=top) or bottom (with |graph-pos=bottom)
graph-width	Optional. Overrides the default width of the graph. Should not be necessary in most cases.
graph-height	Optional. Overrides the default height of the graph. Should not be necessary in most cases.
cols	align=none.

Examples

United States

Historical population

Year	Pop.	±%
1890	1,046,964	—
1900	1,293,697	+23.6%
1910	1,549,008	+19.7%
1920	1,823,779	+17.7%
1930	1,950,961	+7.0%
1940	1,931,334	−1.0%
1950	2,071,605	+7.3%
1960	2,002,512	−3.3%
1970	1,948,609	−2.7%
1980	1,688,210	−13.4%
1990	1,585,577	−6.1%
2000	1,517,550	−4.3%
2006 (est.)	1,448,394	−4.6%
Source: "American FactFinder". United States Census Bureau.

The following code will yield the table on the right:

{{Historical populations
|type = US
|source = {{subst:Historical populations/USCensusRef}}
|1890 |1046964
|1900 |1293697
|1910 |1549008
|1920 |1823779
|1930 |1950961
|1940 |1931334
|1950 |2071605
|1960 |2002512
|1970 |1948609
|1980 |1688210
|1990 |1585577
|2000 |1517550
|2006 (est.)
      |1448394
}}

Smaller areas

Historical population

Year	Pop.
1845	749
1951	6,717
1960	6,984
1970	31,752
1980	34,758
1990	35,888
2000	39,317
Note: Sandefjord and Sandar were merged in 1970. Source: SSB

The following code will yield the table on the right:

{{Historical populations
|width = 10em
|shading = off
|percentages = off
|1845 |749
|1951 |6717
|1960 |6984
|1970 |31752
|1980 |34758
|1990 |35888
|2000 |39317
|footnote=Note: Sandefjord and [[Sandar, Norway|Sandar]] were merged in 1970.
|source = [http://www.ssb.no SSB]
}}

Non-regular date ranges

Population census

Year	Pop.	±% p.a.
1903	219,928	—
1960	1,138,611	+2.93%
1970	1,330,788	+1.57%
1975	1,479,116	+2.14%
1980	1,630,485	+1.97%
1990	1,601,234	−0.18%
1995	1,654,761	+0.66%
2000	1,581,082	−0.91%
2007	1,660,714	+0.70%
2010	1,652,171	−0.17%

For non-regular date ranges, use percentages=pagr to show annual growth rate percentages.

{{Historical populations
| title= Population census
| percentages = pagr
| 1903 |219928
| 1960 |1138611
| 1970 |1330788
| 1975 |1479116
| 1980 |1630485
| 1990 |1601234
| 1995 |1654761
| 2000 |1581082
| 2007 |1660714
| 2010 |1652171
}}

Two columns

For a multicolumn non-floating table, use align=none and cols=2

{{Historical populations
| title= Population census
| percentages = pagr
| align = none
| cols = 2
| 1903 |219928
| 1960 |1138611
| 1970 |1330788
| 1975 |1479116
| 1980 |1630485
| 1990 |1601234
| 1995 |1654761
| 2000 |1581082
| 2007 |1660714
| 2010 |1652171
}}

Population census

Year Pop. ±% p.a. 1903 219,928 —     1960 1,138,611 +2.93% 1970 1,330,788 +1.57% 1975 1,479,116 +2.14% 1980 1,630,485 +1.97%

Year Pop. ±% p.a. 1990 1,601,234 −0.18% 1995 1,654,761 +0.66% 2000 1,581,082 −0.91% 2007 1,660,714 +0.70% 2010 1,652,171 −0.17%

Two columns with graph

For a multicolumn non-floating table with a bottom graph, use align=none and cols=2 and graph-pos=bottom

{{Historical populations
| title= Population census
| percentages = pagr
| align = none
| cols = 2
| graph-pos = bottom
| 1903 |219928
| 1960 |1138611
| 1970 |1330788
| 1975 |1479116
| 1980 |1630485
| 1990 |1601234
| 1995 |1654761
| 2000 |1581082
| 2007 |1660714
| 2010 |1652171
}}

Population census

Year Pop. ±% p.a. 1903 219,928 —     1960 1,138,611 +2.93% 1970 1,330,788 +1.57% 1975 1,479,116 +2.14% 1980 1,630,485 +1.97%

Year Pop. ±% p.a. 1990 1,601,234 −0.18% 1995 1,654,761 +0.66% 2000 1,581,082 −0.91% 2007 1,660,714 +0.70% 2010 1,652,171 −0.17%

<graph>{"legends":[],"scales":[{"type":"linear","name":"x","zero":false,"domain":{"data":"chart","field":"x"},"range":"width","nice":true},{"clamp":true,"type":"linear","name":"y","domain":{"data":"chart","field":"y"},"domainMin":0,"zero":false,"range":"height","nice":true},{"domain":{"data":"chart","field":"series"},"type":"ordinal","name":"color","range":"category10"}],"version":2,"marks":[{"type":"line","properties":{"hover":{"stroke":{"value":"red"}},"update":{"stroke":{"scale":"color","field":"series"}},"enter":{"y":{"scale":"y","field":"y"},"x":{"scale":"x","field":"x"},"stroke":{"scale":"color","field":"series"},"strokeWidth":{"value":2.5}}},"from":{"data":"chart"}}],"height":170,"axes":[{"type":"x","title":"Year","scale":"x","format":"d","properties":{"title":{"fill":{"value":"#54595d"}},"grid":{"stroke":{"value":"#54595d"}},"ticks":{"stroke":{"value":"#54595d"}},"axis":{"strokeWidth":{"value":2},"stroke":{"value":"#54595d"}},"labels":{"align":{"value":"right"},"angle":{"value":-45},"fill":{"value":"#54595d"}}},"grid":false},{"type":"y","title":"Population","scale":"y","format":",d","properties":{"title":{"fill":{"value":"#54595d"}},"grid":{"stroke":{"value":"#54595d"}},"ticks":{"stroke":{"value":"#54595d"}},"axis":{"strokeWidth":{"value":2},"stroke":{"value":"#54595d"}},"labels":{"fill":{"value":"#54595d"}}},"grid":true}],"data":[{"format":{"parse":{"y":"integer","x":"integer"},"type":"json"},"name":"chart","values":[{"y":219928,"series":"y","x":1903},{"y":1138611,"series":"y","x":1960},{"y":1330788,"series":"y","x":1970},{"y":1479116,"series":"y","x":1975},{"y":1630485,"series":"y","x":1980},{"y":1601234,"series":"y","x":1990},{"y":1654761,"series":"y","x":1995},{"y":1581082,"series":"y","x":2000},{"y":1660714,"series":"y","x":2007},{"y":1652171,"series":"y","x":2010}]}],"width":340}</graph>

Horizontal direction

For a horizontally arranged table, use direction=horizontal

{{Historical populations
| title= Population census
| align = none
| direction = horizontal
| 1903 |219928
| 1960 |1138611
| 1970 |1330788
| 1975 |1479116
| 1980 |1630485
| 1990 |1601234
| 1995 |1654761
| 2000 |1581082
| 2007 |1660714
| 2010 |1652171
}}

Population census
Year	1903	1960	1970	1975	1980	1990	1995	2000	2007	2010
Pop.	219,928	1,138,611	1,330,788	1,479,116	1,630,485	1,601,234	1,654,761	1,581,082	1,660,714	1,652,171
±%	—	+417.7%	+16.9%	+11.1%	+10.2%	−1.8%	+3.3%	−4.5%	+5.0%	−0.5%

See also

• {{Demography}} – for horizontal tables
• {{US Census population}}

The above documentation is transcluded from Template:Historical populations/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.