https://github.com/osmlab/learnoverpass

LearnOverpass is the definitive, one stop learning resource for the Overpass API.
https://github.com/osmlab/learnoverpass

Last synced: about 1 month ago
JSON representation

LearnOverpass is the definitive, one stop learning resource for the Overpass API.

• Host: GitHub
• URL: https://github.com/osmlab/learnoverpass
• Owner: osmlab
• Created: 2015-06-02T16:48:36.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2023-03-17T23:30:50.000Z (over 1 year ago)
• Last Synced: 2024-08-01T12:32:01.709Z (4 months ago)
• Language: JavaScript
• Homepage: https://osmlab.github.io/learnoverpass/en/
• Size: 1.53 MB
• Stars: 69
• Watchers: 32
• Forks: 24
• Open Issues: 27
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-starred - osmlab/learnoverpass - LearnOverpass is the definitive, one stop learning resource for the Overpass API. (others)

README

        
# LearnOverpass

This project aims to create a complete, one stop, learning resource for the overpass API.

It features a beginner-friendly, easy-to navigate documentation, as well as an interactive suite of tutorials to teach different aspects of the API.

## Contribution Guide

We accept contributions/edits to the site! Feel free to do a pull request if you see an error in the docs/outdated material.

Translation to various languages is also an aspect we need contribution towards to.

A detailed contribution guide can be seen [here](CONTRIB.md)

## Development Guide

The project is/will be built using (mainly) the following dependencies/frameworks:

- [Hugo](http://gohugo.io) - static site generator written in Go

- [Gulp](http://gulpjs.com) - task manager for preprocessing/asset pipeline

- [ReactFlux](https://www.npmjs.com/package/react-flux) - main framework for the tutorial engine

- Ace Editor/Code Mirror - for the online code editor

- [Stylus](https://learnboost.github.io/stylus/) - CSS meta language

### Setup

#### TL;DR

1. Install [NodeJS](https://nodejs.org/en/), [npm](https://www.npmjs.com/)

2. Install gulp: `npm install -g gulp`

3. Run `npm install`

4. Run `gulp`

5. Open http://localhost:1313/

#### Detailed Setup Instructions

If this is the first time you're working with the node ecosystem, install [node](https://nodejs.org) first. This will add a binary named `npm` in your path.

Then, run `npm install` on the root directory of this project, as well as `npm install -g gulp`.

The theme/layout code can be found under the `themes/src` directory. Gulp is a task manager that compiles these files to `themes/overpass_doc` which is the flat html/css files used by the site.

`gulp build` needs to be run to compile the src theme. The default `gulp` task, apart from building the layout and running hugo, includes a file watcher that automatically detects changes in the src and compiles it for you, you which is ideal if you are developing the theme/layout.

__Note on i18n:__

Hugo does not natively support i18n/localization, and certain things have been worked around with to make it work. The site uses content sections to order the content by language (en/data, de/data etc.), and uses taxonomies to categorize the different content.

### Deploy Script

The project is deployed through the github pages service. The flat hugo files are pushed to the gh-pages branch.

A `deploy.sh` script is included in the repo to push changes to gh-pages automatically.

## License

The website's source is released under the MIT License.

The documentation and courses is released under GNU FDL.

## Special Thanks to:

This project is made possible through Google's Summer of Code (GSOC) 2015 Program.

The mentor for this project is none other than Martin Raifer (@tyr_asd), responsible for the excellent [Overpass Turbo](http://overpass-turbo.eu).

Weekly writeups on the project were posted on Arian's [blog](http://arianv.com/series/gsoc-2015/). Arian (@secretmapper) is the GSOC student for this project.