Template:Interactive COVID-19 maps/common/doc

This is a documentation subpage for Template:Interactive COVID-19 maps/common.
It may contain usage information, categories and other content that is not part of the original template page.

This template employs intricate features of template syntax.

You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages.
You can conduct experiments, and should test all major changes, in either , the general template sandbox, or your user space before changing anything here.

This template serves as a meta-template for the construction of interactive maps. While designed for use with COVID-19 related data, it should be sufficiently general for most purposes as long as the data are in the correct format. Editors interested in using or maintaining this meta-template should read the interactive graph tutorial which this template is based off-of.

Usage edit

{{Interactive COVID-19 maps/common
 | id               = {{{id|<!--default value-->}}}
 | data-coloring    = <!-- Wikilink without [[]] pointing to page with CSV data used to fill in countries. See [[Template:Interactive COVID-19 maps/data/Confirmed covid cases-csv]] for an example -->
 | data-dates       = <!-- Same as above, but this data is a by-date, global total, rather than by-country-by-date total. See [[Template:Interactive COVID-19 maps/data/global Confirmed covid cases by date-csv]] for an example -->
 | color-ramp-type  = <!-- The type of color ramp to use. Default is log, see [https://github.com/vega/vega/wiki/Scales] for other types. -->
 | domain-min       = <!-- Scale minimum -->
 | domain-magnitude = <!-- If color-ramp-type is log, the order of magnitude for the maximum. For example, a value of 2 would have a scale maximum of 100, 3 -> 1000, 4 -> 10000, etc --> 
 | legend-title     = <!-- Title to use for the legend -->
 | title            = <!-- Title for the entire graph -->
 | scale            = {{{scale|<!-- default value -->}}}
}}

Examples edit

See Template:Interactive COVID-19 maps for a list of maps which are made using this template.

TemplateData edit

A meta-template for creating interactive data visualizations using maps

Template parameters
This template prefers block formatting of parameters.
Parameter		Description	Type	Status
Title	`title`	Title for the graph	String	suggested
Country fill data	`data-coloring`	Dataset used to set the fill color for countries Example Template:Interactive COVID-19 maps/data/Deaths by country-csv	Page name	required
Minimum value	`domain-min`	no description	Unknown	optional
Maximum order of magnitude	`domain-magnitude`	The order of magnitude for the scale maximum Example 4	Number	required
By-date totals	`data-dates`	Global totals by date Example Template:Interactive COVID-19 maps/data/Cumulative deaths by date-csv	Page name	required
Legend title	`legend-title`	Title for the legend Example COVID-19 deaths	String	suggested
Scaling coefficient	`scale`	A percentage value (as a decimal) to resize the map Default 0.8 Example 1.2 Auto value `{{{scale\|0.8}}}`	Number	suggested
HTML identifier	`id`	Unique string to identify this graph Default covid-map Example covid-map	String	suggested
Width	`width`	Default width Default 625	Number	deprecated
Height	`height`	Default height Default 325 Auto value	Number	deprecated
Padding	`padding`	no description Default 12	Unknown	optional
Color ramp type	`color-ramp-type`	no description Default log	String	optional