ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / plugins / osm.mdwn
1 [[!template id=plugin name=osm author="Blars Blarson, Antoine Beaupré"]]
2 [[!tag type/special-purpose todo/geotagging]]
3
4 ## Openstreetmap/Openlayers support for ikiwiki
5
6 This plugin provides simple Openstreetmap/Openlayers support for ikiwiki.
7 It can embed Openstreetmap viewports within a page or link to a bigger map
8 that will have multiple markers, generated with a KML (or CSV, or GeoJSON)
9 datafile of markers based on the different calling pages. Multiple distinct
10 maps on a single wiki are supported.
11
12 You will need the [[!cpan XML::Writer]] perl module to write KML files,
13 which is the default mode of operation. GeoJSON files can also be generated
14 if the [[!cpan JSON]] perl module is installed.
15
16 This provides the [[ikiwiki/directive/waypoint]] and [[ikiwiki/directive/osm]] directives.
17
18 ---
19
20 The plugin was originally written by
21 [[the techno-viking|http://techno-viking.com/posts/ikiwiki-maps/]] and fixed up
22 by [[anarcat]]. 
23
24 See [[the Mtl-mesh
25 wiki|http://mesh.openisp.ca/nodes/anarcat]] for a sample of what this
26 plugin can do
27
28 See also [[plugins/contrib/googlemaps]].
29
30 This plugin would be greatly improved by
31 [[todo/internal_definition_list_support]].