Documentation site for MapRoulette.org
If you would like to contribute to this documentation, thank you!
- If you want to fix a typo, update something that's out-of-date, or add a page or section on a new topic, please feel free to open a PR. Though if you want to add a new page or make large changes to existing content, you should probably open an issue first to gather feedback on your proposed changes.
- If you'd like to help translate existing documentation into other languages, have a look at our guide on how to contribute translations.
- If you have a video or article we should link to, feel free to open an issue and we will look at the best way to include it.
This site is built using Jekyll.
To build the website and preview it locally, you'll need to:
- Install a recent Ruby version (tested on Ruby 3.4.1)
- Run
gem install bundler
to install Bundler (a dependency manager for Ruby) - Run
bundle install
to install Jekyll and a few other dependencies (listed in the Gemfile) - Run
bundle exec jekyll serve
to build and start the website. - Go to http://localhost:4000 in your browser to view the site.
After this, if you add or make edits to markdown files, HTML templates, etc, Jekyll will rebuild the site automatically, and you'll see the changes once you refresh the page in your browser. If you make changes to _config.yaml
or any code in the _plugins
directory, you'll need to restart Jekyll for the changes to take effect.