Sophie

Sophie

distrib > Mageia > 7 > armv7hl > media > core-release > by-pkgid > d8544620e4ac7bee48ddb48c85d55709 > files > 116

ikiwiki-3.20190228-1.mga7.noarch.rpm

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>osm</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />

<link rel="stylesheet" href="../../style.css" type="text/css" />

<link rel="stylesheet" href="../../local.css" type="text/css" />










</head>
<body>

<div class="page">

<div class="pageheader">
<div class="header">
<span>
<span class="parentlinks">

<a href="../../index.html">ikiwiki</a>/ 

<a href="../../ikiwiki.html">ikiwiki</a>/ 

<a href="../directive.html">directive</a>/ 

</span>
<span class="title">
osm

</span>
</span>



</div>









</div>





<div id="pagebody">

<div id="content" role="main">
<p>The <code>osm</code> directive is supplied by the <a href="http://ikiwiki.info/plugins/osm/">osm</a> plugin.</p>

<p>This directive inserts an OpenStreetMap map onto a page.
It is typically combined with the <a href="./waypoint.html">waypoint</a> directive
to add points to the map.</p>

<h2>examples</h2>

<pre><code>[[!osm ]]
[[!waypoint  lat="45°30N" lon="73°40W" name="My city" tag="city"]]
</code></pre>

<p>The osm directive will display the actual map, while the waypoint
directive adds waypoints to the map.</p>

<p>The above can also be shortened as:</p>

<pre><code>[[!waypoint  lat="45°30N" lon="73°40W" name="My city" tag="city" embed]]
</code></pre>

<p>The tag is also taken from the tags elsewhere in the page, so the
above is equivalent to:</p>

<pre><code>[[!waypoint  lat="45°30N" lon="73°40W" name="My city" embed]]
[[!tag  city]]
</code></pre>

<p>The icon is also taken from the tag if attached to the tag page as
icon.png (default, modifiable)..</p>

<h2>map display</h2>

<ul>
<li><code>map</code> - map to display, defaults to "map"</li>
<li><code>zoom</code> - the level to zoom to on the OSM map</li>
<li><code>loc</code> - lattitude and longitude of the map center</li>
<li><code>lat</code> - lattitude</li>
<li><code>lon</code> - longitude</li>
<li><code>editable</code> - add edit controls in a separate layer</li>
<li><code>right</code> - float the map right</li>
<li><code>left</code> - float the map left (default)</li>
<li><code>width</code> - width of the map</li>
<li><code>height</code> - height of the map</li>
</ul>

<h2>waypoints</h2>

<p>Waypoints can be added to any page. By default the waypoint takes the
name of the page, which allows you to easily tag pages and make them
appear on the central map.</p>

<p>Waypoints, by default, show up as a image (the <code>icon</code> parameter) link
to the main map (or the <code>map</code> parameter provided). That markup can be
hidden with the <code>hidden</code> parameter.</p>

<ul>
<li><code>name</code> - the name of this point, defaults to the page name <img src="../../smileys/idea.png" alt="(!)" /> must
be unique, otherwise later incantation will overwrite previous
ones.</li>
<li><code>map</code> - the map to add the point to (defaults to "map")</li>
<li><code>desc</code> - description to embed in the map</li>
<li><code>loc</code> - lattitude and longitude</li>
<li><code>lat</code> - lattitude</li>
<li><code>lon</code> - longitude</li>
<li><code>tag</code> - the type of points, maps to an icon in the osm_types array</li>
<li><code>hidden</code> - do not display the link to the map (will not affect <code>embed</code>)</li>
<li><code>icon</code> - URL to the icon to show in the link to the map and within
the map</li>
<li><code>embed</code> - embed the map display alongside the point, in which case
the regular arguments to the map display can be used</li>
</ul>

<h2>Links</h2>

<p>If two pages with waypoints have a link between them, that link will
magically show up on the map. Now how awesome is that?</p>

</div>







</div>

<div id="footer" class="pagefooter" role="contentinfo">

<div id="pageinfo">






<div id="backlinks">
Links:

<a href="../../plugins/osm.html">plugins/osm</a>

<a href="./waypoint.html">waypoint</a>


</div>






<div class="pagedate">
Last edited <span class="date">Tue Feb 26 23:01:54 2019</span>
<!-- Created <span class="date">Tue Feb 26 23:01:54 2019</span> -->
</div>

</div>


<!-- from ikiwiki -->
</div>

</div>

</body>
</html>