parent
84d90fabe4
commit
0ff89c31e4
206 changed files with 28 additions and 15123 deletions
17
CONFIGURE.md
17
CONFIGURE.md
|
@ -8,7 +8,7 @@ Many settings are available in `config/settings.yml`. You can customize your ins
|
|||
|
||||
## Populating the database
|
||||
|
||||
Your installation comes with no geographic data loaded. You can either create new data using one of the editors (Potlatch 2, iD, JOSM etc) or by loading an OSM extract.
|
||||
Your installation comes with no geographic data loaded. You can either create new data using one of the editors (iD, JOSM etc) or by loading an OSM extract.
|
||||
|
||||
After installing but before creating any users or data, import an extract with [Osmosis](https://wiki.openstreetmap.org/wiki/Osmosis) and the [``--write-apidb``](https://wiki.openstreetmap.org/wiki/Osmosis/Detailed_Usage#--write-apidb_.28--wd.29) task.
|
||||
|
||||
|
@ -58,11 +58,10 @@ $ bundle exec rails console
|
|||
|
||||
Three of the built-in applications communicate via the API, and therefore need OAuth consumer keys configured. These are:
|
||||
|
||||
* Potlatch 2
|
||||
* iD
|
||||
* The website itself (for the Notes functionality)
|
||||
|
||||
For example, to use the Potlatch 2 editor you need to register it as an OAuth application.
|
||||
For example, to use the iD editor you need to register it as an OAuth application.
|
||||
|
||||
Do the following:
|
||||
* Log into your Rails Port instance - e.g. http://localhost:3000
|
||||
|
@ -70,25 +69,25 @@ Do the following:
|
|||
* Click on "my settings" on the user page
|
||||
* Click on "oauth settings" on the My settings page
|
||||
* Click on 'Register your application'.
|
||||
* Unless you have set up alternatives, use Name: "Local Potlatch" and URL: "http://localhost:3000"
|
||||
* Unless you have set up alternatives, use Name: "Local iD" and URL: "http://localhost:3000"
|
||||
* Check the 'modify the map' box.
|
||||
* Everything else can be left with the default blank values.
|
||||
* Click the "Register" button
|
||||
* On the next page, copy the "consumer key"
|
||||
* Edit config/settings.local.yml in your rails tree
|
||||
* Add the "potlatch2_key" configuration key and the consumer key as the value
|
||||
* Add the "id_key" configuration key and the consumer key as the value
|
||||
* Restart your rails server
|
||||
|
||||
An example excerpt from settings.local.yml:
|
||||
|
||||
```
|
||||
# Default editor
|
||||
default_editor: "potlatch2"
|
||||
# OAuth consumer key for Potlatch 2
|
||||
potlatch2_key: "8lFmZPsagHV4l3rkAHq0hWY5vV3Ctl3oEFY1aXth"
|
||||
default_editor: "id"
|
||||
# OAuth consumer key for iD
|
||||
id_key: "8lFmZPsagHV4l3rkAHq0hWY5vV3Ctl3oEFY1aXth"
|
||||
```
|
||||
|
||||
Follow the same process for registering and configuring iD (`id_key`) and the website/Notes (`oauth_key`), or to save time, simply reuse the same consumer key for each.
|
||||
Follow the same process for registering and configuring the website/Notes (`oauth_key`), or to save time, simply reuse the same consumer key for each.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue