====== geonav Plugin ======
---- plugin ----
description: Geographic wiki page navigation
author : tom_c
email : tcafferty@glocalfocal.com
type : syntax,action
lastupdate : 2013-11-24
compatible : Binky
depends :
conflicts :
similar :
tags : geo, maps, navigation, experimental
downloadurl: https://github.com/TomCafferty/plugin-geonav/zipball/master
bugtracker : https://github.com/TomCafferty/plugin-geonav/issues
sourcerepo : https://github.com/TomCafferty/plugin-geonav
donationurl:
----
===== Description =====
This plugin provides a way to navigate a section of your wiki based on geography. The designated pages would use a sidebar Google Earth map to drill down to a geographic area. Users can create or edit pages along the way. I see it as being used to document topics at various geographic levels.
===== Installation =====
:!: **External requirements:** This plugin uses
* Google Earth Plugin - this needs to be installed on the user's computer. Accessing the wiki page that uses it should ask the user to install it if it is not already installed. Google Earth can be found at [[http://www.google.com/earth/|Google Earth]]
* A supplied SQLite database in the /db folder
:!: * A modified version of the [[template:starter:|template:starter:]] also included. If you are using a template called starter then either manually install geonav or backup your starter template.
- Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
- Copy the supplied ''startermap'' template to your templates folder.
- Create a sidebar page containing ''
~~NOCACHE~~
===== Configuration and Settings =====
The plugin comes with a modified starter template. If you diff the two templates you can see the minor changes that were made to work better with this plugin. Then you should be able to make similar changes to your desired template. The changes were:
- Key off the :earth in the page name to not use the sidebar if not present. This is the major change.
- Widen the sidebar to enlarge the map.
- Lessen the content width to compensate the wider sidebar
:!: The plugin displays the viewed page content within the dokuwiki__content
div in main.php of the template. If you use a different