/osm-community-index

:speech_balloon: An index of community resources for OpenStreetMap

Primary LanguageJavaScriptISC LicenseISC

npm version Build Status

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

tl;dr

To add your community resource to the index:

  • Add resource .json files under the resources/ folder
    • Each file contains info about what the resource is (slack, forum, mailinglist, facebook, etc.)
    • Each file also contains info about which locations the resource is active. The locations can be country or region codes, points, or custom .geojson files in the features/* folder.
    • You can copy and change an existing file to get started.
  • run npm run test
    • This will check the files for errors and make them pretty.
    • If you don't have Node installed, you can skip this step and we will do it for you.
  • If there are no errors, submit a pull request.

👉 See CONTRIBUTING.md for full details about how to add a community resource to this 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 custom .geojson files

Distributed Files

Several files are published under dist/. These are generated - do not edit them.

  • features.json - A GeoJSON FeatureCollection containing only the custom Features
  • resources.json - A JSON 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
  • img/* - SVG logos for all the resource types

Prerequisites

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

Installing

  • Clone this project, for example: git clone git@github.com: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/).