help/C/recommends.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4    <!ENTITY appname          "Viking">
   5    <!ENTITY gpsbabel         "<program><ulink url='http://gpsbabel.org/'>GPSBabel</ulink></program>">
   6 ]>
   7
   8 <section id="recommeds">
   9 <title>Recommended Programs</title>
  10
  11 <formalpara><title>gpsbabel</title>
  12 <para>&appname; uses &gpsbabel; for several important functions, such as:</para>
  13 </formalpara>
  14 <itemizedlist>
  15 <listitem><para>Importing Files from many formats (including KML)</para></listitem>
  16 <listitem><para>Exporting Files to various formats</para></listitem>
  17 <listitem><para>Transfer Data to/from GPS Devices via serial connections</para></listitem>
  18 </itemizedlist>
  19 <para>Thus these will not be available if the program can not be found.</para>
  20 <para>For <trademark>Unix</trademark> like systems this will search the system path to find the program, as it is typically installed via the System's package manager.</para>
  21 <para>
  22         From &appname; 1.6 onwards &gpsbabel; is not deployed automatically on <trademark>Windows</trademark> systems,
  23         as it is made an optional install component (using the official &gpsbabel; installation program).
  24         If &gpsbabel; is not installed in a typical <trademark>Windows</trademark> location that &appname; can find,
  25         then the &gpsbabel; preference can be set to specify the exact location. See <xref linkend="prefs_external"/>.
  26 </para>
  27 <para>&appname; will need to be restarted to use the new &gpsbabel; location preference.</para>
  28
  29 <formalpara><title>unbuffer</title>
  30 <para>&appname; uses unbuffer command to optimize conversion calls.</para>
  31 </formalpara>
  32 <para>This mainly applies to <trademark>Unix</trademark> like systems when invoking &gpsbabel; commands.</para>
  33
  34 <formalpara><title>gpsd (not available for <trademark>Windows</trademark>)</title>
  35 <para>&appname; can use <ulink url="http://www.catb.org/gpsd/">gpsd</ulink> to get the current location.</para>
  36 </formalpara>
  37
  38 <formalpara><title>togpx</title>
  39 <para>&appname; will use <ulink url="https://github.com/tyrasd/togpx">togpx</ulink> to open GeoJSON files if the program is available on the system.</para>
  40 </formalpara>
  41
  42 <formalpara><title>togeojson</title>
  43 <para>&appname; will use <ulink url="https://github.com/mapbox/togeojson">togeojson</ulink> to export to GeoJSON files if the program is available on the system.</para>
  44 </formalpara>
  45
  46 </section>