Skip to content

mapcolabora/osm-community-index

 
 

Repository files navigation

npm version Build Status Greenkeeper badge

osm-community-index

💬 An index of community resources for OpenStreetMap.

What is it?

This project is a list of resources for users of OpenStreetMap.

"Resources" can be links to forums, meetups, Slack groups, IRC channels, mailing lists, and so on. Anything that mappers, especially beginners, might find interesting or helpful.

About the index

Source files

The source files for this index are stored in two kinds of files:

  • Under resources/ there are .json files to describe the community resources
  • Under features/ there are .geojson files to describe the areas where the communities are active

👉 See CONTRIBUTING.md for info about how to add your community resource to this index.

Distributed Files

Several files are published under dist/

  • features.json - An object containing all the features
  • resources.json - An object containing all the resources
  • combined.geojson - A GeoJSON file containing a FeatureCollection of all Features, each with available resources included in a resources property.
  • index.js - a commonjs module which exports the features and resources objects
tl;dr
  • (required) Add a resource .json file under resources/ folder
    • This contains info about what the resource is (slack, forum, mailinglist, facebook, etc.)
    • You can just copy and change an existing one
    • Each resource needs an includeLocations property to define where it is active.
  • (optional) Add a feature .geojson file under features/ folder
    • This is a boundary around where the resource is active
    • You can use geojson.io or other tools to create these.
  • npm run test
    • This will build and check for errors and make the files pretty

Prerequisites

  • Node.js version 8 or newer
  • git for your platform

Installing

  • Clone this project, for example: git clone [email protected]:osmlab/osm-community-index.git
  • cd into the project folder,
  • Run npm install to install libraries

Building

  • Just npm run test
    • This will check the files for errors and make them pretty.

License

osm-community-index is available under the ISC License. See the LICENSE.md file for more details.

This project also bundles some icons from FontAwesome. The icons are licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

About

💬 An index of community resources for OpenStreetMap

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%