X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/85540d7a77abfd69f9f0754e2bdccc33b55ecf1e..82993cc7d379563c9a95e33c5e5369a957b0c121:/doc/viking.xml diff --git a/doc/viking.xml b/doc/viking.xml index ece4972d..d3bdd5cb 100644 --- a/doc/viking.xml +++ b/doc/viking.xml @@ -30,7 +30,10 @@ and docbook-xsl in your Build-Depends control field. Ralf"> Meyer"> - 2008-05-02"> + 2013-04-08"> + + + 1"> @@ -44,7 +47,10 @@ and docbook-xsl in your Build-Depends control field. GPL"> ]> - + +&dhsource; &dhversion; + +
&dhemail; @@ -53,12 +59,21 @@ and docbook-xsl in your Build-Depends control field. 2007 &dhusername; + + 2010 + Guilhem Bonnefille + + + 2012 + Rob Norris + &dhdate; &dhucpackage; - &dhsection; + &dhsource; + &dhversion; &dhpackage; @@ -97,22 +112,19 @@ and docbook-xsl in your Build-Depends control field. DESCRIPTION - Viking is a free/open source program to manage GPS data. You can - import and plot tracks and waypoints, show Google maps and/or - Terraserver maps under it, add coordinate lines, make new tracks - and waypoints, hide different things, etc. It is written in C - with the GTK+ 2 toolkit, available for Linux, other POSIX - operating systems, and Windows, and is licensed under the GNU GPL. + Viking is a program to manage GPS data. - Homepage: http://viking.sf.net + You can import and plot tracks, routes and waypoints, show OpenStreetMap (OSM) maps and/or + Terraserver maps under it, add coordinate lines, make new tracks, routes and waypoints, hide different things, etc. + It is written in C with the GTK+ 2 toolkit, available for Linux, other POSIX operating systems and Windows. - - This manual page was written for the &debian; distribution - because the original program does not have a manual page. + + Homepage: http://viking.sf.net + + + Viking is licensed under the GNU GPL. - - &dhpackage; is a program to manage GPS data @@ -157,14 +169,244 @@ and docbook-xsl in your Build-Depends control field. - SEE ALSO + Extending Viking + + Currently, &dhpackage; has some extention points based on configuration files. The file format is heavily inspired by the GtkBuilder file format: you specify the class of the GObject to build and set its properties. Technically, it is a XML file containing a "objects" root element. Inside this element, you set a collection of "object". + Here is an example: + + + Property value + Property value + + ... + +]]> + + + You can find more examples in the documentation part of the distribution. + + Map Source + It is possible to add new map's sources. The file is ~/.viking/maps.xml. + An example of the file in the distribution doc/examples/maps.xml. + The VikSlippyMapSource allows to declare any map's source working like OpenStreetMap. It supports the following properties: + + + id + this is an integer and should be unique as it used to identify the map source + + + label + the text displayed in the map's source selection dialog + + + hostname + the server's hostname (eg. "tile.openstreetmap.org") + + + url + the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for X, Y and Z (zoom level) (eg. "/%d/%d/%d.png") + + + + The VikTmsMapSource allows to declare any TMS service. It supports the following properties: + + + id + this is an integer and should be unique as it used to identify the map source + + + label + the text displayed in the map's source selection dialog + + + hostname + the server's hostname (eg. "tile.openstreetmap.org") + + + url + the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for X, Y and Z (zoom level) (eg. "/%d/%d/%d.png") + + + + The VikWmscMapSource allows to declare any WMS or WMS-C service. It supports the following properties: + + + id + this is an integer and should be unique as it used to identify the map source + + + label + the text displayed in the map's source selection dialog + + + hostname + the server's hostname (eg. "tile.openstreetmap.org") + + + url + the parametrized address of the tile, in the spirit of C printf format, with 4 "%s" fields for bounding box coordinates (eg. "/coord=%s,%s,%s,%s") + + + + + + + Go-to search engines + It is possible to add new new search engines for the "Go-To" feature. The file is ~/.viking/goto_tools.xml. + An example of the file in the distribution doc/examples/goto_tools.xml. + Currently, there is a single object class available: VikGotoXmlTool. Such feature allows to declare any search engine using a XML format as result. + The related properties are: + + + label + the text displayed in the Go-To dialog + + + url-format + the parametrized address of the query, in the spirit of C printf format, with a single "%s" field (replaced by the query string) + + + lat-path + XML path of the latitude (eg. /root/parent/elem) + + + lat-attr (optional) + name of the attribute (of previous element) containing the latitude + + + lon-path + XML path of the longitude (eg. /root/parent/elem) + + + lon-attr (optional) + name of the attribute (of previous element) containing the longiude + + + + As a facility (or readability) it is possible to set both path and attribute name in a single property, like an XPath expression. To do so, simply set both info in lat-path (or lon-path) in the following format: /root/parent/elem@attribute. + + + + External tools + It is possible to add new external tools. The file is ~/.viking/external_tools.xml. + An example of the file in the distribution doc/examples/external_tools.xml. + The VikWebtoolCenter allows to declare any Webtool using a logic based on center coordinates and zoom level value. + The related properties are: + + + label + the text displayed in the menu entry + + + url + the parametrized URL to open, in the spirit of C printf format, with 2 "%s" and a "%d" fields for X, Y and Z (zoom level) (eg. "http://hostname/?lat=%s&lon=%s&zoom=%d") + + + + The VikWebtoolBounds allows to declare any Webtool using a logic based on bounds coordinates. + The related properties are: + + + + + label + the text displayed in the menu entry + + + url + the parametrized address of the tile, in the spirit of C printf format, with 4 "%s" fields for left, right, bottom and top (eg. "http://hostname:8111/load_and_zoom?left=%s&right=%s&bottom=%s&top=%s") + + + + + + + + FILES + + + + ~/.viking/maps.xml + + File containing definition of map sources. + See previous section for details. + + + + ~/.viking/goto_tools.xml + + File containing definition of "Go-to" services. + See previous section for details. + + + + ~/.viking/external_tools.xml + + File containing definition of external tools. + See previous section for details. + + + + ~/.viking/viking.prefs + + Preferences for &dhpackage;. + + + + ~/.viking/viking_layer_defaults.ini + + Layer default values for &dhpackage;. + + + + ~/.viking/cookies.txt + + File hosting cookies used by &dhpackage;. + + + + ~/.viking-maps/ + + Map cache of tiles downloaded by &dhpackage;. + + + + + Extension files (maps.xml, + goto_tools.xml, + external_tools.xml) + are also searched in /etc/viking and + /usr/share/viking directories (or related in your system). + + + + ENVIRONMENT + + + + XDG_DATA_HOME + + Optional directory to look for extension files + (maps.xml, goto_tools.xml, + external_tools.xml). + + + + XDG_DATA_DIRS + + Path used to change the directories scanned for extension files + (maps.xml, goto_tools.xml, + external_tools.xml). + + + - viking-remote (1). AUTHOR - This manual page was written by &dhusername; &dhemail; for + This manual page was originally written by &dhusername; &dhemail; for the &debian; system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License, Version 2 any @@ -177,4 +419,4 @@ and docbook-xsl in your Build-Depends control field. - +