mirror of
https://github.com/praktimarc/kst4contest.git
synced 2026-07-13 16:16:44 +02:00
Improve manual landing pages
This commit is contained in:
Marc Froehlich
@@ -0,0 +1,264 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>{{ manual.title }} | KST4Contest Manual</title>
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="description" content="KST4Contest manual page: {{ manual.title }}">
|
||||
|
||||
<link rel="canonical" href="https://kst4contest.hamradioonline.de/manual/de/installation/">
|
||||
|
||||
<meta property="og:type" content="website">
|
||||
<meta property="og:title" content="{{ manual.title }} | KST4Contest Manual">
|
||||
<meta property="og:description" content="KST4Contest manual page: {{ manual.title }}">
|
||||
<meta property="og:url" content="https://kst4contest.hamradioonline.de/manual/de/installation/">
|
||||
<meta property="og:site_name" content="KST4Contest">
|
||||
|
||||
<meta name="twitter:card" content="summary_large_image">
|
||||
<meta name="twitter:title" content="{{ manual.title }} | KST4Contest Manual">
|
||||
<meta name="twitter:description" content="KST4Contest manual page: {{ manual.title }}">
|
||||
|
||||
<link rel="stylesheet" href="/assets/css/main.css">
|
||||
</head>
|
||||
<body>
|
||||
<header class="site-header">
|
||||
<a class="brand" href="/">KST4Contest</a>
|
||||
<nav>
|
||||
<a href="/features/">Features</a>
|
||||
<a href="/download/">Download</a>
|
||||
<a href="/manual/">Manual</a>
|
||||
<a href="/screenshots/">Screenshots</a>
|
||||
<a href="/news/">News</a>
|
||||
<a href="https://github.com/praktimarc/kst4contest">GitHub</a>
|
||||
<a href="/faq/">FAQ</a>
|
||||
</nav>
|
||||
</header>
|
||||
|
||||
<main>
|
||||
|
||||
<section class="section">
|
||||
<div class="card manual-content">
|
||||
<p><a href="/manual/de/">← Back to manual overview</a></p>
|
||||
<h1>Installation</h1>
|
||||
<h1 id="installation" tabindex="-1"><a class="header-anchor" href="#installation">Installation</a></h1>
|
||||
<blockquote>
|
||||
<p>🇬🇧 <a href="en-Installation">English version</a> | 🇩🇪 Du liest gerade die deutsche Version</p>
|
||||
</blockquote>
|
||||
<h2 id="voraussetzungen" tabindex="-1"><a class="header-anchor" href="#voraussetzungen">Voraussetzungen</a></h2>
|
||||
<p>Es wird eine Mindestauflösung von 1200px mal 720px empfohlen</p>
|
||||
<h3 id="on4kst-account" tabindex="-1"><a class="header-anchor" href="#on4kst-account">ON4KST-Account</a></h3>
|
||||
<p>Um den Chat zu nutzen, ist ein registrierter Account beim ON4KST-Chat-Dienst erforderlich:</p>
|
||||
<ul>
|
||||
<li>Registrierung unter: <a href="http://www.on4kst.info/chat/register.php">http://www.on4kst.info/chat/register.php</a></li>
|
||||
</ul>
|
||||
<h3 id="verhaltensregeln-im-chat" tabindex="-1"><a class="header-anchor" href="#verhaltensregeln-im-chat">Verhaltensregeln im Chat</a></h3>
|
||||
<p>Die offizielle Sprache im ON4KST-Chat ist <strong>Englisch</strong>. Auch bei Kommunikation mit Stationen aus dem eigenen Land bitte Englisch verwenden. Übliche HAM-Abkürzungen (agn, dir, pse, rrr, tnx, 73 …) sind gang und gäbe.</p>
|
||||
<h3 id="pers%C3%B6nliche-nachrichten" tabindex="-1"><a class="header-anchor" href="#pers%C3%B6nliche-nachrichten">Persönliche Nachrichten</a></h3>
|
||||
<p>Um eine Privatnachricht an eine andere Station zu senden, immer folgendes Format verwenden:</p>
|
||||
<pre><code>/CQ RUFZEICHEN Nachrichtentext
|
||||
</code></pre>
|
||||
<p>Beispiel: <code>/CQ DL5ASG pse sked 144.205?</code></p>
|
||||
<p>Bei starkem Chat-Verkehr (5–6 Nachrichten pro Sekunde im Contest) gehen öffentliche Nachrichten, die an ein bestimmtes Rufzeichen gerichtet sind, leicht unter. KST4Contest fängt solche Nachrichten aber auch dann ab, wenn sie fälschlicherweise öffentlich gepostet werden (siehe <a href="Funktionen#catching-personal-messages">Funktionen – PM-Abfang</a>).</p>
|
||||
<hr>
|
||||
<h2 id="download" tabindex="-1"><a class="header-anchor" href="#download">Download</a></h2>
|
||||
<h3 id="windows" tabindex="-1"><a class="header-anchor" href="#windows">Windows</a></h3>
|
||||
<p>Die aktuelle Version kann als ZIP-Datei heruntergeladen werden:</p>
|
||||
<p><strong><a href="https://github.com/praktimarc/kst4contest/releases/latest">https://github.com/praktimarc/kst4contest/releases/latest</a></strong></p>
|
||||
<p>Der Dateiname hat das Format <code>praktiKST-v<Versionsnummer>-windows-x64.zip </code>.</p>
|
||||
<h3 id="linux" tabindex="-1"><a class="header-anchor" href="#linux">Linux</a></h3>
|
||||
<p>Mehrere Paketformate stehen auf der Releases-Seite zur Verfügung:</p>
|
||||
<p><strong><a href="https://github.com/praktimarc/kst4contest/releases/latest">https://github.com/praktimarc/kst4contest/releases/latest</a></strong></p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Format</th>
|
||||
<th>Dateiname</th>
|
||||
<th>Geeignet für</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>AppImage</td>
|
||||
<td><code>KST4Contest-v<Version>-linux-x86_64.AppImage</code></td>
|
||||
<td>Alle Distributionen</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Debian-Paket</td>
|
||||
<td><code>KST4Contest-v<Version>-debian-amd64.deb</code></td>
|
||||
<td>Debian, Ubuntu, Linux Mint, …</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>RPM-Paket</td>
|
||||
<td><code>KST4Contest-v<Version>-fedora-x86_64.rpm</code></td>
|
||||
<td>Fedora, RHEL, openSUSE, …</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Arch-Paket</td>
|
||||
<td><code>KST4Contest-v<Version>-archlinux-x86_64.pkg.tar.zst</code></td>
|
||||
<td>Arch Linux, Manjaro, …</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Flatpak</td>
|
||||
<td><code>de.x08.KST4Contest.flatpakref</code></td>
|
||||
<td>Alle Distributionen mit Flatpak</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<blockquote>
|
||||
<p><strong>Empfehlung für Linux:</strong> Die Flatpak-Installation ist der einfachste Weg, immer aktuell zu bleiben – <code>flatpak update</code> erledigt alle zukünftigen Updates automatisch. Das Repository ist GPG-signiert.</p>
|
||||
</blockquote>
|
||||
<h3 id="macos" tabindex="-1"><a class="header-anchor" href="#macos">macOS</a></h3>
|
||||
<blockquote>
|
||||
<p>⚠️ <strong>Best-Effort-Support:</strong> macOS-Builds werden als zusätzliche Option bereitgestellt, sind aber <strong>nicht umfassend getestet</strong>. Wir bauen und veröffentlichen macOS-Binaries mit jedem Release, können allerdings nicht alle Szenarien unter macOS testen. Bei Problemen freuen wir uns über eine Rückmeldung – wir versuchen unser Bestes, können aber nicht den gleichen Support-Umfang wie für Windows und Linux garantieren.</p>
|
||||
</blockquote>
|
||||
<p>Die aktuelle Version kann als DMG-Disk-Image heruntergeladen werden (für Apple-Silicon- und Intel-Macs verfügbar):</p>
|
||||
<p><strong><a href="https://github.com/praktimarc/kst4contest/releases/latest">https://github.com/praktimarc/kst4contest/releases/latest</a></strong></p>
|
||||
<p>Der Dateiname hat das Format <code>KST4Contest-v<Versionsnummer>-macos-<Architektur>.dmg</code>, wobei <code><Architektur></code> entweder <code>arm64</code> (Apple Silicon) oder <code>x86_64</code> (Intel) ist.</p>
|
||||
<hr>
|
||||
<h2 id="installation-1" tabindex="-1"><a class="header-anchor" href="#installation-1">Installation</a></h2>
|
||||
<h3 id="windows-1" tabindex="-1"><a class="header-anchor" href="#windows-1">Windows</a></h3>
|
||||
<ol>
|
||||
<li>ZIP-Datei herunterladen.</li>
|
||||
<li>ZIP-Datei in einen gewünschten Ordner entpacken.</li>
|
||||
<li><code>praktiKST.exe</code> ausführen.</li>
|
||||
</ol>
|
||||
<p>Die Einstellungen werden unter <code>%USERPROFILE%\.praktikst\preferences.xml</code> gespeichert.</p>
|
||||
<h3 id="linux-1" tabindex="-1"><a class="header-anchor" href="#linux-1">Linux</a></h3>
|
||||
<p>Die Einstellungen werden immer unter <code>~/.praktikst/preferences.xml</code> gespeichert.</p>
|
||||
<h4 id="appimage" tabindex="-1"><a class="header-anchor" href="#appimage">AppImage</a></h4>
|
||||
<ol>
|
||||
<li>AppImage herunterladen.</li>
|
||||
<li>Ausführbar machen: <code>chmod +x KST4Contest-v<Version>-linux-x86_64.AppImage</code></li>
|
||||
<li>Starten.</li>
|
||||
</ol>
|
||||
<h4 id="debian-%2F-ubuntu" tabindex="-1"><a class="header-anchor" href="#debian-%2F-ubuntu">Debian / Ubuntu</a></h4>
|
||||
<pre><code class="language-bash">sudo apt install ./KST4Contest-v<Version>-debian-amd64.deb
|
||||
</code></pre>
|
||||
<p>Oder die <code>.deb</code>-Datei im Dateimanager doppelklicken.</p>
|
||||
<h4 id="fedora-%2F-rhel" tabindex="-1"><a class="header-anchor" href="#fedora-%2F-rhel">Fedora / RHEL</a></h4>
|
||||
<pre><code class="language-bash">sudo dnf install ./KST4Contest-v<Version>-fedora-x86_64.rpm
|
||||
</code></pre>
|
||||
<h4 id="arch-linux" tabindex="-1"><a class="header-anchor" href="#arch-linux">Arch Linux</a></h4>
|
||||
<pre><code class="language-bash">sudo pacman -U KST4Contest-v<Version>-archlinux-x86_64.pkg.tar.zst
|
||||
</code></pre>
|
||||
<h4 id="flatpak" tabindex="-1"><a class="header-anchor" href="#flatpak">Flatpak</a></h4>
|
||||
<p>Die Datei <code>de.x08.KST4Contest.flatpakref</code> aus dem <a href="https://github.com/praktimarc/kst4contest/releases/latest">aktuellen Release</a> herunterladen und öffnen, oder:</p>
|
||||
<pre><code class="language-bash">flatpak install de.x08.KST4Contest.flatpakref
|
||||
</code></pre>
|
||||
<p>Oder den Remote manuell hinzufügen (empfohlen für Nightly/Beta-Zugriff):</p>
|
||||
<pre><code class="language-bash">flatpak remote-add --if-not-exists kst4contest https://praktimarc.github.io/kst4contest/kst4contest.flatpakrepo
|
||||
flatpak install kst4contest de.x08.KST4Contest
|
||||
</code></pre>
|
||||
<h4 id="flatpak-kan%C3%A4le-(nightly-%2F-beta-%2F-stable)" tabindex="-1"><a class="header-anchor" href="#flatpak-kan%C3%A4le-(nightly-%2F-beta-%2F-stable)">Flatpak-Kanäle (nightly / beta / stable)</a></h4>
|
||||
<p>Das Flatpak-Repository enthält drei Kanäle, die alle im selben Remote liegen:</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Kanal</th>
|
||||
<th>Inhalt</th>
|
||||
<th>Wird gebaut bei</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code>stable</code></td>
|
||||
<td>Aktuelle stabile Version</td>
|
||||
<td>Jedem normalen Release-Tag</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>beta</code></td>
|
||||
<td>Vorab-Version</td>
|
||||
<td>Tags mit <code>beta-</code> Präfix</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>nightly</code></td>
|
||||
<td>Entwicklungsstand (main-Branch)</td>
|
||||
<td>Täglich / jedem Push auf main</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>Remote einmalig hinzufügen, dann den gewünschten Kanal installieren:</p>
|
||||
<pre><code class="language-bash">flatpak remote-add --if-not-exists kst4contest https://praktimarc.github.io/kst4contest/kst4contest.flatpakrepo
|
||||
|
||||
# Stable (Standard)
|
||||
flatpak install kst4contest de.x08.KST4Contest
|
||||
|
||||
# Beta
|
||||
flatpak install kst4contest de.x08.KST4Contest//beta
|
||||
|
||||
# Nightly
|
||||
flatpak install kst4contest de.x08.KST4Contest//nightly
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p><strong>Hinweis:</strong> Flatpak erlaubt nur eine installierte Version pro App-ID gleichzeitig. Um den Kanal zu wechseln, zuerst die aktuelle Version deinstallieren:</p>
|
||||
<pre><code class="language-bash">flatpak uninstall de.x08.KST4Contest
|
||||
flatpak install kst4contest de.x08.KST4Contest//nightly
|
||||
</code></pre>
|
||||
</blockquote>
|
||||
<p>Updates erfolgen wie gewohnt mit <code>flatpak update</code>.</p>
|
||||
<p>Die <code>flatpakref</code>-Dateien für Beta und Stable liegen jeweils im entsprechenden <a href="https://github.com/praktimarc/kst4contest/releases">GitHub-Release</a>. Das Nightly-<code>flatpakref</code> (<code>de.x08.KST4Contest.nightly.flatpakref</code>) ist als Artifact im <a href="https://github.com/praktimarc/kst4contest/actions">GitHub Actions</a>-Tab verfügbar (wird 14 Tage aufbewahrt) – der Remote-Weg oben ist für Nightly daher meist einfacher.</p>
|
||||
<h3 id="macos-1" tabindex="-1"><a class="header-anchor" href="#macos-1">macOS</a></h3>
|
||||
<ol>
|
||||
<li>DMG-Datei für die eigene Architektur herunterladen (Apple Silicon oder Intel).</li>
|
||||
<li>DMG-Datei öffnen.</li>
|
||||
<li><code>KST4Contest.app</code> in den <strong>Programme</strong>-Ordner ziehen.</li>
|
||||
<li>Beim ersten Start zeigt macOS ggf. eine Warnung, da die App nicht notarisiert ist. Zum Öffnen:
|
||||
<ul>
|
||||
<li>Rechtsklick (oder Ctrl-Klick) auf <code>KST4Contest.app</code> im Finder → <strong>Öffnen</strong> wählen.</li>
|
||||
<li>Alternativ: <strong>Systemeinstellungen → Datenschutz & Sicherheit</strong> → <strong>Trotzdem öffnen</strong> klicken.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>KST4Contest aus dem Programme-Ordner oder dem Launchpad starten.</li>
|
||||
</ol>
|
||||
<p>Die Einstellungen werden unter <code>~/.praktikst/preferences.xml</code> gespeichert.</p>
|
||||
<hr>
|
||||
<h2 id="update" tabindex="-1"><a class="header-anchor" href="#update">Update</a></h2>
|
||||
<p>KST4Contest enthält einen <strong>automatischen Update-Hinweis-Dienst</strong>: Sobald eine neue Version verfügbar ist, erscheint beim Start ein Fenster mit:</p>
|
||||
<ul>
|
||||
<li>der Information, dass eine neue Version vorliegt,</li>
|
||||
<li>einem Changelog,</li>
|
||||
<li>dem Download-Link zur neuen Version.</li>
|
||||
</ul>
|
||||
<p><img src="update_window.png" alt="Beispiel Update Fenster"></p>
|
||||
<h3 id="update-prozess" tabindex="-1"><a class="header-anchor" href="#update-prozess">Update-Prozess</a></h3>
|
||||
<h4 id="windows-2" tabindex="-1"><a class="header-anchor" href="#windows-2">Windows</a></h4>
|
||||
<p>Derzeit gibt es nur einen Weg zum Aktualisieren:</p>
|
||||
<ol>
|
||||
<li>Den alten Ordner löschen.</li>
|
||||
<li>Das neue ZIP entpacken.</li>
|
||||
</ol>
|
||||
<p>Die Einstellungsdatei (<code>preferences.xml</code>) bleibt erhalten, da sie im Benutzerordner gespeichert ist – nicht im Programmordner.</p>
|
||||
<h4 id="linux-2" tabindex="-1"><a class="header-anchor" href="#linux-2">Linux</a></h4>
|
||||
<ul>
|
||||
<li><strong>AppImage</strong>: Neues AppImage herunterladen, ausführbar machen (<code>chmod +x</code>), altes optional löschen.</li>
|
||||
<li><strong>Debian/Ubuntu</strong>: <code>sudo apt install ./KST4Contest-v<Version>-debian-amd64.deb</code></li>
|
||||
<li><strong>Fedora/RHEL</strong>: <code>sudo dnf upgrade ./KST4Contest-v<Version>-fedora-x86_64.rpm</code></li>
|
||||
<li><strong>Arch Linux</strong>: <code>sudo pacman -U KST4Contest-v<Version>-archlinux-x86_64.pkg.tar.zst</code></li>
|
||||
<li><strong>Flatpak (Repository)</strong>: <code>flatpak update</code> – aktualisiert alle Flatpak-Apps einschließlich KST4Contest.</li>
|
||||
</ul>
|
||||
<h4 id="macos-2" tabindex="-1"><a class="header-anchor" href="#macos-2">macOS</a></h4>
|
||||
<ol>
|
||||
<li>Neue DMG-Datei herunterladen.</li>
|
||||
<li>DMG öffnen.</li>
|
||||
<li>Die neue <code>KST4Contest.app</code> in den <strong>Programme</strong>-Ordner ziehen und die alte Version ersetzen.</li>
|
||||
</ol>
|
||||
<hr>
|
||||
<h2 id="bekannte-probleme-beim-start" tabindex="-1"><a class="header-anchor" href="#bekannte-probleme-beim-start">Bekannte Probleme beim Start</a></h2>
|
||||
<h3 id="norton-360" tabindex="-1"><a class="header-anchor" href="#norton-360">Norton 360</a></h3>
|
||||
<p>Norton 360 stuft <code>praktiKST.exe</code> als gefährlich ein (Fehlalarm). Es muss eine Ausnahme für die Datei eingerichtet werden:</p>
|
||||
<ol>
|
||||
<li>Norton 360 öffnen.</li>
|
||||
<li>Sicherheit → Verlauf → Das entsprechende Ereignis suchen.</li>
|
||||
<li>„Wiederherstellen & Ausnahme hinzufügen" wählen.</li>
|
||||
</ol>
|
||||
<p><em>(Gemeldet von PE0WGA, Franz van Velzen – danke!)</em></p>
|
||||
|
||||
</div>
|
||||
</section>
|
||||
</main>
|
||||
|
||||
<footer class="site-footer">
|
||||
<p>KST4Contest – ON4KST contest workflow for VHF/UHF/SHF operators.</p>
|
||||
</footer>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user