X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/01423b939fe263b830e979b5b7091a5a9296d5b1..82993cc7d379563c9a95e33c5e5369a957b0c121:/doc/viking.xml?ds=sidebyside diff --git a/doc/viking.xml b/doc/viking.xml index 73d8f7bb..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; @@ -57,12 +63,17 @@ and docbook-xsl in your Build-Depends control field. 2010 Guilhem Bonnefille + + 2012 + Rob Norris + &dhdate; &dhucpackage; - &dhsection; + &dhsource; + &dhversion; &dhpackage; @@ -101,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 @@ -181,8 +189,27 @@ and docbook-xsl in your Build-Depends control field. 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. - Currently, there is a single object class available: VikSlippyMapSource. Such feature allows to declare any map's source working like OpenStreetMap. - The related properties are: + 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 @@ -202,6 +229,26 @@ and docbook-xsl in your Build-Depends control field. + 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") + + + @@ -244,12 +291,23 @@ and docbook-xsl in your Build-Depends control field. 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. - Currently, there is a single object class available: VikWebtoolCenter. Such feature allows to declare any Webtool using a logic based on center coordinates and zoom level value. + 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: - id - this is an integer and should be unique as it used to identify the tool label @@ -257,7 +315,7 @@ and docbook-xsl in your Build-Depends control field. 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. "http://hostname/%d/%d/%d.png") + 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") @@ -295,6 +353,12 @@ and docbook-xsl in your Build-Depends control field. Preferences for &dhpackage;. + + ~/.viking/viking_layer_defaults.ini + + Layer default values for &dhpackage;. + + ~/.viking/cookies.txt @@ -309,16 +373,40 @@ and docbook-xsl in your Build-Depends control field. + 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). + - SEE ALSO + 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 @@ -331,4 +419,4 @@ and docbook-xsl in your Build-Depends control field. - +