mirror of
https://github.com/tumic0/GPXSee.git
synced 2025-07-17 12:24:24 +02:00
Documentation update
This commit is contained in:
33
doc.html
33
doc.html
@ -48,7 +48,7 @@
|
||||
<td class="os">Linux:</td>
|
||||
<td class="file">/usr/share/gpxsee/</td>
|
||||
</tr><tr>
|
||||
<td class="os">OS X:</td>
|
||||
<td class="os">Mac:</td>
|
||||
<td class="file">/Applications/GPXSee.app/Contents/Resources/</td>
|
||||
</tr><tr>
|
||||
<td class="os">Android<sup><a href="#androidGlobalConfig">1</a></sup>:</td>
|
||||
@ -67,7 +67,7 @@
|
||||
<td class="os">Linux:</td>
|
||||
<td class="file">~/.local/share/gpxsee/</td>
|
||||
</tr><tr>
|
||||
<td class="os">OS X:</td>
|
||||
<td class="os">Mac:</td>
|
||||
<td class="file">~/Library/Application Support/GPXSee/</td>
|
||||
</tr><tr>
|
||||
<td class="os">Android:</td>
|
||||
@ -423,7 +423,7 @@ $ gpxsee 'geo:323482,4306480;crs=EPSG:32618'
|
||||
<a href="https://doc.qt.io/qt-5/qtpositioning-plugins.html">documentation</a>
|
||||
for more info.</p>
|
||||
|
||||
<h3 id="positioning_winmac">Windows & OS X</h3>
|
||||
<h3 id="positioning_winmac">Windows & Mac</h3>
|
||||
<p>If your device/OS supports the platform positioning API (Core Location
|
||||
/ Windows.Devices.Geolocation) you may try that first. If you have an external
|
||||
USB/serial GPS device connected, you can use the <code>serialnmea</code> plugin.
|
||||
@ -449,6 +449,27 @@ $ gpxsee 'geo:323482,4306480;crs=EPSG:32618'
|
||||
|
||||
<h2 id="issues">Known issues</h2>
|
||||
|
||||
<h3>Code signing</h3>
|
||||
<p>Due to lack of project funding GPXSee uses self-signed certificates for code signing on
|
||||
Windows and Mac. Even though you will see messages from your OS that are designed to scare
|
||||
you as much as possible, in reality this does not pose any security problem (you can check
|
||||
the certificate issuer yourself in the git repository instead of trusting the bureaucratic
|
||||
process of a corporation like Apple or DigiCert).</p>
|
||||
|
||||
<p>If you want a "clean user experience" like with the commercial certificates, you have
|
||||
to:</p>
|
||||
|
||||
<h4>Windows</h4>
|
||||
<p>Import the <a href="https://github.com/tumic0/GPXSee/blob/master/cert/win/gpxsee.cer">
|
||||
certificate</a> into the Local Machine certificate store.</p>
|
||||
|
||||
<h4>Mac</h4>
|
||||
<p>Modify gatekeeper rules using spctl:</p>
|
||||
<pre>
|
||||
sudo spctl --add --type execute --label 'GPXSee' --requirement \
|
||||
'certificate leaf H"F45CCC1FF42FDF031C949BD8DC47412E8D3826D8"'
|
||||
</pre>
|
||||
|
||||
<h3>Android file system</h3>
|
||||
<p>Due to the limited file system access on Android, all map formats that consist of
|
||||
multiple files (eg. OziExplorer maps or World-file georeferenced images) will not load
|
||||
@ -469,10 +490,6 @@ $ gpxsee 'geo:323482,4306480;crs=EPSG:32618'
|
||||
significantly speed up rendering of big data sets. You may enable OpenGL in
|
||||
the preferences, but be prepared that "strange things" may happen...</p>
|
||||
|
||||
<h3>Qt6</h3>
|
||||
<p>Many Linux distributions compile GPXSee using Qt6, but Qt6 has serious rendering issues
|
||||
that affect GPXSee. See the following Qt bugs list for details.</p>
|
||||
|
||||
<h3>Qt bugs</h3>
|
||||
<p>This is the list of the most severe Qt bugs that affect GPXSee (some of them are
|
||||
platform/Qt version specific):</p>
|
||||
@ -541,7 +558,7 @@ $ gpxsee 'geo:323482,4306480;crs=EPSG:32618'
|
||||
<div class="h5l"><a href="#dem_downloads">DEM downloads</a></div>
|
||||
<div class="h5l"><a href="#hillshading">Hillshading</a></div>
|
||||
<div class="h4l"><a href="#positioning">Positioning</a></div>
|
||||
<div class="h5l"><a href="#positioning_winmac">Windows & OS X</a></div>
|
||||
<div class="h5l"><a href="#positioning_winmac">Windows & Mac</a></div>
|
||||
<div class="h5l"><a href="#positioning_linux">Linux</a></div>
|
||||
<div class="h4l"><a href="#issues">Known issues</a></div>
|
||||
</div>
|
||||
|
||||
29
index.html
29
index.html
@ -109,7 +109,7 @@
|
||||
<li>HiDPI/Retina displays and maps support.</li>
|
||||
<li>Real-time GPS position.</li>
|
||||
<li>Available for Windows, macOS, Linux and Android.</li>
|
||||
<li><b>Free software</b> (GPLv3 open-source license).</li>
|
||||
<li>Free software (GPLv3 open-source license).</li>
|
||||
</ul>
|
||||
|
||||
<p>GPXSee is designed as a small (no dependencies except of Qt), fast
|
||||
@ -121,7 +121,7 @@
|
||||
|
||||
<ul id="download">
|
||||
<li><a href="https://sourceforge.net/projects/gpxsee/files/Windows/">Windows installer</a></li>
|
||||
<li><a href="https://sourceforge.net/projects/gpxsee/files/Mac%20OS%20X/">Mac OS X bundle</a></li>
|
||||
<li><a href="https://sourceforge.net/projects/gpxsee/files/Mac%20OS%20X/">Mac application bundle</a></li>
|
||||
<li><a href="https://software.opensuse.org/download.html?project=home%3Atumic%3AGPXSee&package=gpxsee">
|
||||
Linux repos/packages</a></li>
|
||||
<li><a href="https://play.google.com/store/apps/details?id=org.gpxsee.gpxsee">Android app (Google Play)</a>
|
||||
@ -129,32 +129,25 @@
|
||||
</ul>
|
||||
|
||||
<p>Additionally to the source codes, GPXSee is available as a Windows
|
||||
installer and an OS X dmg from the project's Sourceforge page and in
|
||||
installer and a Mac dmg from the project's Sourceforge page and in
|
||||
form of various Linux packages from the project's openSUSE Build Service
|
||||
page. Most Linux distributions (Archlinux, Fedora, Gentoo, openSUSE, ...)
|
||||
as well as BSD distributions (FreeBSD, NetBSD, OpenBSD) also provide
|
||||
GPXSee in their official repositories, however not always in the latest
|
||||
version. On OS X you can also use the MacPorts or Homebrew packaging systems
|
||||
version. On Mac you can also use the MacPorts or Homebrew packaging systems
|
||||
to install GPXSee and on Windows you can use the Windows Package Manager
|
||||
(winget).</p>
|
||||
|
||||
<p>On Android, you can install GPXSee from the Google Play app store.</p>
|
||||
|
||||
<p><i>The official Windows & OS X installers are always signed using
|
||||
<p><b>The official Windows and Mac installers are always signed using
|
||||
<a href="https://github.com/tumic0/GPXSee/tree/master/cert">certificates</a>
|
||||
available at the GitHub project page. As the certificates are non-commercial
|
||||
(self-signed) you have to import the certificate on Windows first if you want
|
||||
your OS automatically check the installer when installing GPXSee. On OS X,
|
||||
Apple does not allow software that does not generate them profit like GPXSee
|
||||
to pass OS X's Gatekeeper (you can't import custom certificates) so <b>on Mac
|
||||
you need to run the application using the "right click menu" when opening it
|
||||
for the first time.</b></i></p>
|
||||
|
||||
<p><i><b>If you have a M1/M2 Mac, it is strongly recommended that you use
|
||||
the Macports package</b> instead of the dmg from Sourceforge (or the Homebrew
|
||||
package which is based on the dmg). The Macports packages provide native
|
||||
ARM64 binaries while the dmg is x86_64-only and requires emulation on
|
||||
M1/M2 Macs.</i></p>
|
||||
available at the GitHub project page. Due to lack of project funding the
|
||||
certificates are non-commercial (self-signed) and you have to import the
|
||||
certificate (on Windows) or modify gatekeeper rules (on Mac) first if you
|
||||
want your OS automatically check/accept the installer. Recent versions of
|
||||
macOS will even not allow you to run the program at all until you fiddle
|
||||
with gatekeeper!</b></p>
|
||||
|
||||
<h2 id="maps">GPXSee maps</h2>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user