National Park Service map symbols optimized for the web.
Branch: gh-pages
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
places-mobile add Places Mobile versions of all current symbols Feb 29, 2016
renders materials for v2.3.0 May 2, 2017
src v2.5.0 additions and edits Apr 26, 2018
symbol_specification_images command line test Feb 20, 2018
test Render slate icons and fix build Oct 7, 2015
www v2.5.0 additions and edits Apr 26, 2018
.gitignore Prepare for 1.0.0 release Apr 14, 2015
LICENSE.txt Reorg Jul 1, 2015
README.md update readme Apr 26, 2018
index.js Reorg Jul 1, 2015
package.json v2.5.0 additions and edits Apr 26, 2018
render.sh materials for v2.3.0 May 2, 2017

README.md

NPMap Symbol Library

Circle CI

National Park Service map symbols optimized for the web. View the complete set and read more about this project and on the NPS maps website.

New symbols

Add requests for new symbols as an issue. Starting in 2018, newly developed symbols will be added to the src/standalone directory and bundled into periodic releases. Symbol development for NPMap Builder will be temporarily suspended until that application is rewritten to pull symbols from the standalone directory. A more detailed release checklist can be found here.

Versioning

The Symbol Library uses a semantic versioning scheme:

  • 0.0.z: Bugfixes and modifications
  • 0.y.0: Icons added
  • x.0.0: Icons removed, sprite scheme changed, or major features added

Changelog

  • 1.0.0
  • 2.0.0
  • 2.1.0
  • 2.2.2
  • 2.2.3
  • 2.3.0
  • 2.4.0
  • 2.5.0

File structure

This repository was originally forked from Mapbox's Maki project, so the file structure is similar.

src

Source SVG files are in the src subdirectory. Each symbol is designed at three pixel-perfect sizes (max dimensions 14, 22, and 30 pixels square) and in black and white versions to support different use cases. These can be found in the src/standalone directory. In addition, a subset of 94 symbols are designed at 12, 18, and 24 pixels square for use in NPMap Builder.

renders

PNG renders of all of the SVGs are in the renders directory. High-resolution (aka Retina) versions of each icon are present as well, named using the common @2x convention.

render.sh

You can use the SVGs and PNGs in this repository as they are without building anything, however a render script is included to assist designers/developers who want to modify or create new icons. It will render SVGs to PNGs at 100% and 200% resolution, create sprites used by NPMap.js, NPMap Builder, and the Places Editor, and generate corresponding CSS styles for the sprites.

The script requires Node, Bash, Inkscape, and ImageMagick. In addition, each icon must have an appropriate entry in www/npmap-symbol-library.json to be rendered correctly.

After installing the required prerequisites, you can run the script like this:

cd npmap-symbol-library
npm install
bash render.sh