VIKING(1)
NAME
viking - program to manage GPS data
SYNOPSIS
viking [-d | --debug] [-V | --verbose] [file...]
viking [-h | --help]
viking [-v | --version]
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.
Homepage: http://viking.sf.net
This manual page was written for the Debian(TM) distribution because
the original program does not have a manual page.
viking is a program to manage GPS data
OPTIONS
- file
- Specify file to load at start.
- -d, --debug
- Enable debug output.
- -V, --verbose
- Enable verbose output.
- -?, --help
- Show help options.
- -v, --version
- Show version.
EXTENDING VIKING
Currently, viking 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:
- <objects>
<object class="ClassName"><property name="property_name1">Property value</property>
<property name="property_name2">Property value</property></object>
... - <objects>
- 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. 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: - 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") - 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. 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 related properties are: - id
- this is an integer and should be unique as it used to identify the tool
- label
- the text displayed in the menu entry
- 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")
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 viking.
- ~/.viking/cookies.txt
- File hosting cookies used by viking.
- ~/.viking-maps/
- Map cache of tiles downloaded by viking.
SEE ALSO
viking-remote (1).
AUTHOR
This manual page was written by Ralf Meyer ranfyy@gmail.com for the
Debian(TM) 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 later version published by the
Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License
can be found in /usr/share/common-licenses/GPL.
COPYRIGHT
- Copyright (C) 2007 Ralf Meyer
Copyright (C) 2010 Guilhem Bonnefille