From b1670107d67804f0b5b42fcedd1c9c97fb498dab Mon Sep 17 00:00:00 2001 From: Marcin Rataj Date: Thu, 13 Nov 2014 00:26:18 +0100 Subject: Updated README with short FAQ --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/README.md b/README.md index d0e42ea..35c3b1a 100644 --- a/README.md +++ b/README.md @@ -2,3 +2,36 @@ discourse-openstreetmap ======================= Discourse plugin to support OSM via URL Oneboxing and iframe whitelisting + + +## Installation on top of Docker image + +Add to your `/var/discourse/containers/app.yml`: + +```ruby +hooks: + after_code: + - exec: + cd: $home/plugins + cmd: + - mkdir -p plugins + - git clone https://github.com/lidel/discourse-openstreetmap.git +``` + +Rebuild Discourse: `/var/discourse/launcher rebuild app` + +## FAQ + +### What URLs are oneboxed? + +`http://www.openstreetmap.org/?mlat=[Marker Latitude]&mlon=[Marker Longitude]#map=[Zoom Level]/[Latitude]/[Longitude]&layers=[Layer code]` + +### Why URLs without *Marker* parameters are not being oneboxed? + +The `map` parameter is located inside URL hash. +Root URLs without query parameters are currently [ignored by onebox library](https://github.com/discourse/onebox/blame/master/lib/onebox/matcher.rb#L17). +This is a temporary inconvenience: upstream fix will be introduced soon. + +### I don't like oneboxing: can't I just copy&paste `