File talk:Template map of US states and District of Columbia.svg/Instructions

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search
Notice Leave questions and comments about the new template at File talk:Template map of US states and District of Columbia.svg.
Note. The instructions are in this talk subpage because subpages are not allowed for file pages.
Note. This all started in this long discussion. Which continued here. And then here.
Note. See also: Commons: Map resources.
Note. See old template map, and instructions.

Purpose

[edit]

These SVG maps have user-editable sections (any text editor) to allow creation of more maps on more topics. Just paste in a list of states and values. See examples here:

Feel free to create map templates for other countries too. Cmglee may be able to help with that.

Latest template map

[edit]

File:Template map of US states and District of Columbia.svg - By CMG Lee.

The template map can be used to create US SVG maps by pasting in a list of states with values.

Some maps created with the latest template

[edit]
Note: See Category:English-language SVG choropleth maps of the United States made with templates for maps made with both the old and new templates.

See maps created or updated with the latest template:

Maps created or updated with this template

Instruction summary. New map template

[edit]
Note: Any SVG file created with this template can also be a template.
Note: This only works with the Firefox browser.
  1. Open the main SVG template file (or a subsequent SVG file with the same script generator) in a text editor.
  2. Replace (or amend) parts indicated with relevant data:
    • In the list following the line "const state_space_value...", amend the values, or paste in a new list of states and values. Remove commas from numbers. If a value is unavailable, leave the value blank.
    • Adjust title, description, font sizes, colors, etc, if necessary. All of this is done in the "SVG-specific JavaScript" section at the end.
  3. Delete the !-- on the line with GENERATOR_SCRIPT, and -- on the last line.
  4. Save as an SVG file. Keep the file open as you may need to do additional editing.
  5. Open the SVG file in Firefox to generate the changes.
  6. The changes will be showing in the map. But the map must be saved again (from Firefox) to keep the changes.
  7. Upload the changed SVG file to the Commons.

More instructions

[edit]
Note: See the old instruction page for the old template for some still-relevant info.

These instructions are for a list of states followed by a space, followed by a value. Multiple spaces work. Tabs work.

States can be full names, or USPS 2-letter abbreviations. There can be a mix of them in the list.

Order of states does not matter. States that are missing from the list altogether, or missing data, will show "n/a" on the map.

"DC" or "D.C." in the list works. As does "Washington D.C." or "Washington DC".

Do not use "District of Columbia". Number will be removed from it.

After uploading, don't forget to add the map to its topic category, and also to this category:

Choose parameter values

[edit]

If you are updating an existing map, then there are already parameter values. You can change them if desired. In the user-editable "SVG-specific JavaScript" section at the end you can choose values for the following:

Title and description. Examples are shown below. Title is at the top of the map. It is also on the browser tab. Description is internal and is seen by search engines, etc., and can be longer.

  • const out_title = 'State minimum wages, in dollars. Sept 30, 2024';
  • const out_desc = 'State minimum wages, in dollars. Sept 30, 2024';

How to mark states with no data. Blank, n/a, N/A, etc.:

  • const no_data_value = 'n/a';

Decimal place to show on map. 0, 1, 2, etc.:

  • const decimal_place = 1;

Font sizes:

  • .title { font-size:40px; letter-spacing:0; }
  • .legend { font-size:30px; }
  • .state { font-size:17px; }
  • .value { font-size:17px; }

Colors. Minimum, maximum, n/a:

  • .min { fill:#99ffff; }
  • .max { fill:#ff6600; }
  • .n_a { fill:#eeeeee; }

Possible maps

[edit]
Some of the below pages have maps and graphs. They can be copied to the Commons via Template:PD-map and Template:PD-chart. They are in the public domain (read PD template pages). This option is for people who haven't yet figured out the new template to put state-by-state data in numerical form right on a US map.

America's Health Rankings

US dental care maps and stats:

KFF. "More than 800 up-to-date health indicators at the state level can be mapped, ranked, and downloaded":

US Centers for Disease Control and Prevention

Map workshops of the Graphic Labs

[edit]

You can get help here:

Retrieved from "https://commons.wikimedia.org/w/index.php?title=File_talk:Template_map_of_US_states_and_District_of_Columbia.svg/Instructions&oldid=961141487"