X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/1fc3f034191d3eec78b4d5da343e282092a221be..5014a091ba14a6ecf05cfc5f5ae67331b506b348:/doc/plugins/osm.mdwn diff --git a/doc/plugins/osm.mdwn b/doc/plugins/osm.mdwn index 040d175ca..cfeab5957 100644 --- a/doc/plugins/osm.mdwn +++ b/doc/plugins/osm.mdwn @@ -1,10 +1,10 @@ [[!template id=plugin name=osm author="Blars Blarson, Antoine Beaupré"]] [[!tag type/special-purpose todo/geotagging]] -## Openstreetmap/Openlayers support for ikiwiki +## OpenStreetMap/OpenLayers support for ikiwiki -This plugin provides simple Openstreetmap/Openlayers support for ikiwiki. -It can embed Openstreetmap viewports within a page or link to a bigger map +This plugin provides simple OpenStreetMap/OpenLayers support for ikiwiki. +It can embed OpenStreetMap viewports within a page or link to a bigger map that will have multiple markers, generated with a KML (or CSV, or GeoJSON) datafile of markers based on the different calling pages. Multiple distinct maps on a single wiki are supported. @@ -15,14 +15,29 @@ if the [[!cpan JSON]] perl module is installed. This provides the [[ikiwiki/directive/waypoint]] and [[ikiwiki/directive/osm]] directives. +### Examples + +A [[basic set of examples|http://cbaines.net/osm-examples]] is available +([[repository|http://git.cbaines.net/?p=ikiwiki/osm-examples.git;a=summary]]). +Note that none of these will work without patching the plugin. With the +following patches, most of the examples will work (while each patch is +seperate, the branch includes all previous patches in the list, so the +cbaines/osm-icon-fixes branch includes all patches). + + - [[bugs/osm plugin error TypeError: mapProjection is null]] + - [[todo/osm plugin GeoJSON popup patch]] + - [[todo/osm plugin icon patch]] + +Even with these patches, the CSV examples do not work, and there are cosmetic +issues with a few of the other examples. + --- The plugin was originally written by [[the techno-viking|http://techno-viking.com/posts/ikiwiki-maps/]] and fixed up by [[anarcat]]. -See [[the Mtl-mesh -wiki|http://mesh.openisp.ca/nodes/anarcat]] for a sample of what this +See [[the Reseaulibre.ca wiki|http://reseaulibre.ca/]] for a sample of what this plugin can do See also [[plugins/contrib/googlemaps]].