Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MapStory/mapstory
MapStory is the free atlas of change that everyone can edit
https://github.com/MapStory/mapstory
hacktoberfest
Last synced: about 1 month ago
JSON representation
MapStory is the free atlas of change that everyone can edit
- Host: GitHub
- URL: https://github.com/MapStory/mapstory
- Owner: MapStory
- License: gpl-3.0
- Created: 2014-07-21T22:34:57.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-03-01T06:11:28.000Z (almost 2 years ago)
- Last Synced: 2024-06-21T11:25:39.145Z (6 months ago)
- Topics: hacktoberfest
- Language: Python
- Homepage: http://mapstory.org
- Size: 33.9 MB
- Stars: 51
- Watchers: 16
- Forks: 41
- Open Issues: 168
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-starred - MapStory/mapstory - MapStory is the free atlas of change that everyone can edit (hacktoberfest)
README
MapStory
================
[](https://coveralls.io/github/MapStory/mapstory?branch=master) [](https://travis-ci.org/MapStory/mapstory) [](https://saucelabs.com/beta/builds/a90681af072a474083478115f31567b0)
[](https://saucelabs.com/beta/builds/a90681af072a474083478115f31567b0)
MapStory.org is the free atlas of change that everyone can edit. We are a community, not a company, working to organize humanity’s shared knowledge about how the world evolves geographically over time, and to make this knowledge easily accessible as an open educational resource.
The MapStory community’s work breaks down into 3 big tasks. We call them the “3 Cs”. First, once you’ve created a profile, you can _collect_ spatio-temporal data and import it. We call each dataset imported into MapStory.org a “StoryLayer”. Second you can _compose_ MapStories that provide nuanced understanding of historical change by combining StoryLayers and other narrative elements, like images, text, or video. Finally, you can _curate_ the accuracy and quality of content presented in MapStory.org by adding ratings, checking metadata, making comments and committing version edits to the actual StoryLayers themselves, much like you might edit a Wikipedia page.
## Getting Started
### Prerequisites
This guide assumes you are using a UNIX based operating system such as Linux or OSX and have the below installed.
```
git
docker
docker-compose
gmake
```
### Setup a Development Environment
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. Start by forking the mapstory repository to your own Github account, and then cloning that repository to your local development environment.
```
git clone https://www.github.com//mapstory
```
Add the following to your `/etc/hosts` file
```
127.0.0.1 docker
::1 docker
```
Run the following commands in the checked out git repo to start up the docker containers.
```
git submodule update --init --recursive
make pull
make up
```
Your local site should now be available at `http://docker/`.
Additional information about using the docker build is available at our [Docker README](https://github.com/MapStory/mapstory/blob/master/docker/README.md).
## Built With
* [Python 2.7](https://www.python.org/) - The primary backend development language.
* [Django 1.8.7](https://www.djangoproject.com/) - The back end web development framework.
* [AngularJS 1.6](https://angularjs.org/) - The front end web development framework.
## Contributing
Please read [How to Contribute](https://github.com/MapStory/mapstory/wiki/How-to-Contribute) for details on our code of conduct, and the process for submitting pull requests to us.
## Styleguides & Best Practices
Please review our [Contributor Guides](https://github.com/MapStory/mapstory/wiki#contributor-guides) for best practices and style guides before contributing to the project.