साँचा:Show data का स्रोत देखें

{{#if:{{{flag image|}}}|[[File:{{{flag image}}}|150px|right]]}}
This template contains various independently retrievable data items about '''{{#if:{{{1|}}}|[[{{{article|{{{1}}}}}}]]|<code><nowiki>[[{{{article|{{{1}}}}}}]]</nowiki></code>}}''' in the form of parameter values of a variable template of choice, in a standardized fashion. It is a member of a family of templates, those with names starting with "Data" in [[:Category:Data templates]]. The system used is similar to that of [[Wikipedia:WikiProject Flag Template]]. {{#ifexist:Template:Country data {{{1}}}| The corresponding template of that project is [[Template:Country data {{{1}}}]].}}

==Parameters==
{| class="wikitable"
|-
!Parameter name!!Value!!Meaning
|-
| <code>1</code>
| <code>{{{1}}}</code>||last part of template name, used to identify it within the family of templates<ref>It may seem odd, but a template cannot retrieve its own name (PAGENAME only provides this on the template page itself), and even if it could, a string operation would be needed to remove "Data ". Putting the name of the entity in the data template removes the need to supply it as a parameter when the data template is called (in the cases that it would need this name).</ref>
|-
|<code>article</code>||{{#if:{{{article|}}}|<code>{{{article}}}</code>}}||article name; needs to be specified only if it differs from <code>{{{1}}}</code>; in applications, use <code><nowiki>[[{{{article|{{{1}}}}}}]]</nowiki></code> to link to the article (as has been done at the top of this page)
|-
|<code>short name</code>||{{#if:{{{short name|}}}|<code>{{{short name}}}</code>}}||shorter display name to be used in some contexts; an application or application parameter can specify whether this is used; only intended for dispensing with disambiguation in a context where it is not needed 
|-
|<code>type</code>||{{#if:{{{type|}}}|<code>{{{type}}}</code>}}||type of entity, e.g. continent, country, province, municipality
|-
|<code>code</code>||{{#if:{{{code|}}}|<code>{{{code}}}</code>}}||code
|-
|<code>code description</code>||{{#if:{{{code description|}}}|<code>{{{code description}}}</code>}}||code description
|-
|<code>continent</code>||{{#if:{{{continent|}}}|<code>{{#ifexist:Template:Data {{{continent}}}|[[:Template:Data {{{continent}}}|{{{continent}}}]]|[[{{{continent}}}]]}}</code>}}||continent, if ''type'' is lower than "continent"
|-
|<code>country</code>||{{#if:{{{country|}}}|<code>{{data {{{country}}}|linkd}}</code>}}||country, if ''type'' is lower than "country"
|-
|<code>province</code>||{{#if:{{{province|}}}|<code>{{data {{{province}}}|linkd}}</code>}}||province, if ''type'' is lower than "province"
|-
| <code>popbase</code>
| {{#if:{{{popbase|}}}|<code>{{formatnum:{{{popbase}}}}}</code>}}
| population on a given date (stored without commas)
|-
| <code>popbaseyear</code>
| {{#if:{{{popbaseyear|}}}|<code>{{{popbaseyear}}}</code>}}
| year for which the population base figure applies
|-
| <code>popbasemonth</code>
| {{#if:{{{popbasemonth|}}}|<code>{{{popbasemonth}}}</code>}}
| month for which the population base figure applies
|-
| <code>popbaseday</code>
| {{#if:{{{popbaseday|}}}|<code>{{{popbaseday}}}</code>}}
| day for which the population base figure applies
|-
| <code>popinc</code>
| {{#if:{{{popinc|}}}|<code>{{{popinc}}}</code>}}
| population increase per day; used to extrapolate the population figure
|-
| <code>land area</code>
| {{#if:{{{land area|}}}|<code>{{formatnum:{{{land area}}}}}</code>}}
| land area in km<sup>2</sup> (stored without commas)
|-
| <code>total area</code>
| {{#if:{{{total area|}}}|<code>{{formatnum:{{{total area}}}}}</code>}}
| total area in km<sup>2</sup> (stored without commas)
|-
|<code>flag image</code>
| {{#if: {{{flag image|}}}|<code>{{{flag image}}}</code>}}
|name of the flag image (or other illustration, if there is no flag) shown above
|}
Throughout the family of templates, fixed names are used for the parameters. (The parameter names are kept short to reduce counts for the [[Wikipedia:Template_limits#Post-expand_include_size|post expand include size]] and the [[Wikipedia:Template_limits#Template_argument_size|template argument size]] in cases where these are applicable.) However, not necessarily all parameters have been given a value: some parameters may not be applicable, while for some other parameters the value may just have not been specified yet. The table shows all parameters, and for each the value, if specified. 

{{#if: {{{related1|}}} |
===Related templates===
Please see the following related <code>country_data</code> templates:
* [[Template:Data {{{related1}}}]]<span style="position:absolute; left:32em;">{{flag|{{{related1}}}}}</span><!--
-->{{#if: {{{related2|}}} |
* [[Template:Data {{{related2}}}]]<span style="position:absolute; left:32em;">{{flag|{{{related2}}}}}</span> }}<!--
-->{{#if: {{{related3|}}} |
* [[Template:Data {{{related3}}}]]<span style="position:absolute; left:32em;">{{flag|{{{related3}}}}}</span> }}<!--
-->{{#if: {{{related4|}}} |
* [[Template:Data {{{related4}}}]]<span style="position:absolute; left:32em;">{{flag|{{{related4}}}}}</span> }}<!--
-->{{#if: {{{related5|}}} |
* [[Template:Data {{{related5}}}]]<span style="position:absolute; left:32em;">{{flag|{{{related5}}}}}</span> }}<!--
-->}}

==Related data templates==
{{#if:{{{continent|}}}|*{{#ifexist:Template:Data {{{continent}}}|[[Template:Data {{{continent}}}]]|[{{fullurl:Template:Data {{{continent}}}|action=edit&preload=Template:Data/preload}} {{{continent}}}]}}
}}{{#if:{{{country|}}}|*{{#ifexist:Template:Data {{{country}}}|[[Template:Data {{{country}}}]]|[{{fullurl:Template:Data {{{country}}}|action=edit&preload=Template:Data/preload}} {{{country}}}]}}
}}{{#if:{{{province|}}}|*{{#ifexist:Template:Data {{{province}}}]]|[[Template:Data {{{province}}}]]|[{{fullurl:Template:Data {{{province}}}|action=edit&preload=Template:Data/preload}} {{{province}}}]}}
}}

==Derived data==
{{#if:{{{popbase|}}}|{{#if:{{{popinc|}}}|{{#if:{{{popbaseyear|}}}|
As of {{CURRENTMONTHNAME}} {{CURRENTDAY}}, {{CURRENTYEAR}}, the population is approximately {{formatnum:{{#expr:({{{popbase}}}+{{{popinc}}}*{{age in days|{{{popbaseyear}}}|{{{popbasemonth}}}|{{{popbaseday}}}}})round(5-floor(ln{{{popbase}}}/ln10))}}}} (estimated by extrapolation), which is {{#expr:({{{popbase}}}+{{{popinc}}}*{{age in days|{{{popbaseyear}}}|{{{popbasemonth}}}|{{{popbaseday}}}}})/{{worldpop}}*100round(-floor(ln({{{popbase}}}/{{worldpop}})/ln10))}}% of the world's population.}}}}}}

{{#if:{{{total area|}}}|The total area is {{convert|{{{total area}}}|km2}}, which is {{ppm|{{sigdig|({{{total area}}}/{{data world|pst2|land area}})|3}}}} of the land area of the world. {{#if:{{{land area|}}}|The water area is {{#expr:(1-{{{land area}}}/{{{total area}}})*100round1}}% of the total area.}} }}

{{#if:{{{popbase|}}}|{{#if:{{{popinc|}}}|{{#if:{{{popbaseyear|}}}|
{{#if:{{{land area|}}}|The population density is {{convert|{{#expr:({{{popbase}}}{{#if:{{{popinc|}}}|+{{{popinc}}}*{{age in days|{{{popbaseyear}}}|{{{popbasemonth}}}|{{{popbaseday}}}}}}})/{{{land area}}}round1}}|/km2|1}} land area.}}
{{#if:{{{total area|}}}|The population density is {{convert|{{#expr:({{{popbase}}}{{#if:{{{popinc|}}}|+{{{popinc}}}*{{age in days|{{{popbaseyear}}}|{{{popbasemonth}}}|{{{popbaseday}}}}}}})/{{{total area}}}round1}}|/km2|1}} total area.}}

}}}}}}

==Retrieval of data items==
<code><nowiki>{{data</nowiki> {{{1}}}<nowiki>|pst2|land area}}</nowiki></code>, using parameter selection template [[Template:Pst2]], gives the parameter ''land area'', etc.

For retrieval of more data items it is more efficient to prepare a template for that, to be used as follows:

<code><nowiki>{{data</nowiki> {{{1}}}<nowiki>|</nowiki></code>''template name''<code><nowiki>|..|..|..|..}}</nowiki></code>

so that this data template needs to be called only once.<ref>See the first two rows of the first table in [[m:Help:Array#Summary of counts for template limits]].</ref> The default template is [[Template:Show  data]], producing this page.

The four parameters are optional, they are passed on to the prepared template as parameters 2-5.

Special templates:
*[[Template:Linkd]] - link to article
*[[Template:Poptoday]] - used above
*[[Template:Popdens]] - for use on the page [[List of sovereign states and dependent territories by population density]]
*[[Template:Poptoday 1]] - for use on the page [[List of countries by population]]
*[[Template:Popareadens]] - for use on the page [[List of countries by population]]

A parameter being undefined or empty typically means the same, see below. <code><nowiki>{{data ..|pst2|..}}</nowiki></code> gives the empty string and the text "<code><nowiki>{{{..}}}</nowiki></code>", respectively. Therefore an application checking the parameter has to check both. Checking whether a result is equal to e.g. the text "<code>{{{popinc}}}</code>" cannot be done directly with #ifeq in a template which itself has also a parameter with that name, because if that is defined, there would be a comparison with the value instead of the text itself. Instead, it can be checked whether the first character of the result is "<code>{</code>", e.g.: <code><nowiki>{{#ifeq:{{padleft:|1|{{data {{{continent}}}|pst2|popinc}}}}|{|..|..}}</nowiki></code>.

==Creating new data templates==
[[Template:Data/preload]] can be used to create new data templates. On the page of the data template of a province, if there is no data template yet for the country, a link appears to create that, preloading this template. Otherwise the wikitext can be copied to the new data template. For parameters which are not applicable, such as ''country'' for a country, the parameter definition "country=" can be deleted. For parameters to be filled in later the parameter definition like "popinc=" (specifying the empty string as value) can be left in the wikitext to be filled in later. Do not forget parameter 1.

==Efficiency==
In this template system each template contains various properties of a single entity, as opposed to the other common system, where a template contains one property (e.g. population or area) of many entities. Although that other system can be convenient if updates of a property for all these entities become available together, in the case of large-scale use of data on one page that other system can be problematic due to its inefficiency. This is because of the following:
*There are often more entities than properties, and [[wp:template limits|page counts]] (or in the case of <code>#switch</code>, average page counts) are proportional to the number of data items in the data template (if they are stored in a linear way, not in a tree, and not stored as unnamed parameters).
*In the case of large-scale use of data on one page there are usually one or more tables, where an entity  forms a row and a property a column, because there are often more entities than properties, and because this way the sorting feature allows sorting entities based on a property. In this template system this allows producing a row with only one call of the data template, making the count not grow faster than proportional to the average number of data items stored per data template, times the number of entities in the table.

The include part of the data template of an entity does not contain a long list of its sub-entities or their properties, because that would make this method inefficient too.  

{{reflist}}
<includeonly>[[Category:Data templates|{{if||{{{country|}}}|{{{country}}} {{{1}}}|{{if|eq|{{{type}}}|continent| {{{1}}}|{{if|eq|{{{1}}}|world| |{{{1}}}}}}}}}]]</includeonly><noinclude>[[Category:Data retrieval templates]]</noinclude>

Until here the documentation is automatically generated by [[Template:Show data]].

<noinclude>
{{documentation}}
</noinclude>