viking

Langue: en

Autres versions - même langue

Version: 2008\-05\-02 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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: m[blue]http://viking.sf.netm[]

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 © 2007 Ralf Meyer
Copyright © 2010 Guilhem Bonnefille