Template:Historical populations/sandbox
 | __EXPECTUNUSEDTEMPLATE__This is the template sandbox page for Template:Historical populations (diff). See also the companion subpage for test cases. |
 | This template is used on approximately 53,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
 | This template uses Lua: |
{{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
<syntaxhighlight lang="wikitext" style="overflow:auto;">
| Year | Pop. | ±% |
|---|---|---|
| date | population | — |
| date | population | — |
| date | population | — |
| date | population | — |
| date | population | — |
| date | population | — |
| date | population | — |
</syntaxhighlight>
Parameters
| 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.
|
| align | Optional. The alignment of the table on the page.
|
| clear | Optional. Use to clear any left or right floating elements nearby.
|
| direction | Optional. How the box is arranged on the page.
|
| 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.
|
| state | Optional. The collapsed state of the table. Set it to <syntaxhighlight lang="text" class="" style="" inline="1">collapsed</syntaxhighlight> to collapse the table by default.
|
| 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="" style="" inline="1">US</syntaxhighlight> (or the obsolescent <syntaxhighlight lang="text" class="" style="" inline="1">USA</syntaxhighlight>).
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.
|
| width | Optional. The width of the table (or of each block of columns). Can be any valid CSS <syntaxhighlight lang="text" class="" style="" inline="1">width</syntaxhighlight> value.
|
| pop_name | Optional. The text in the column header of the population data.
|
| 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 | Optional. Adds an automatically generated graph at the top (with |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 | Optional. Total number of columns of data (default is <syntaxhighlight lang="text" class="" style="" inline="1">1</syntaxhighlight>). This is useful for very long tables, or when |align=none.
|
Examples
United States
| 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:
<syntaxhighlight lang="wikitext" style="overflow:auto;">
| 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: {{subst:Historical populations/USCensusRef}} | ||
</syntaxhighlight>
Smaller areas
| 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:
<syntaxhighlight lang="wikitext" style="overflow:auto;">
| 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 | |
</syntaxhighlight>
Non-regular date ranges
| 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.
<syntaxhighlight lang="wikitext" style="overflow:auto;">
| 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% |
</syntaxhighlight>
Two columns
For a multicolumn non-floating table, use align=none and cols=2
<syntaxhighlight lang="wikitext" style="overflow:auto;">
|
|
</syntaxhighlight>
|
|
Two columns with graph
For a multicolumn non-floating table with a bottom graph, use align=none and cols=2 and graph-pos=bottom
<syntaxhighlight lang="wikitext" style="overflow:auto;">
|
| ||||||||||||||||||||||||||||||||||||
<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> | |||||||||||||||||||||||||||||||||||||
</syntaxhighlight>
|
| ||||||||||||||||||||||||||||||||||||
<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
<syntaxhighlight lang="wikitext" style="overflow:auto;">
| 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% |
</syntaxhighlight>
| 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}}