kst4contest/github_docs/de-Makros-und-Variablen.md

Makros und Variablen

🇬🇧 English version | 🇩🇪 Du liest gerade die deutsche Version

KST4Contest bietet ein flexibles System aus Text-Snippets, Shortcuts und eingebauten Variablen, die den Chat-Workflow im Contest erheblich beschleunigen.

---

Überblick

Typ	Aufruf	Zweck
Shortcuts	Button in der Toolbar	Schneller Text-Insert ins Sendfeld
Snippets	Rechtsklick / Ctrl+1..0	Text-Bausteine, optionaler PM-Versand
Variablen	In allen Text-Feldern verwendbar	Dynamische Werte (QRG, Locator, AP-Daten)

---

Shortcuts (Schnellzugriff-Schaltflächen)

Konfigurierbar in den Preferences → Shortcut Settings.

• Jeder konfigurierte Text erzeugt einen Button in der Benutzeroberfläche.
• Ein Klick fügt den Text in das Sendfeld ein.
• Alle Variablen können in Shortcuts verwendet werden und werden beim Einfügen sofort aufgelöst.
• Auch längere Texte möglich.

Tipp: Häufig verwendete Abkürzungen wie „pse", „rrr", „tnx", „73" als Shortcuts anlegen.

---

Snippets (Text-Bausteine)

Konfigurierbar in den Preferences → Snippet Settings.

Aufruf

• Rechtsklick auf ein Rufzeichen in der Benutzerliste
• Rechtsklick in der CQ-Nachrichtentabelle
• Rechtsklick in der PM-Nachrichtentabelle
• Tastaturkürzel: Ctrl+1 bis Ctrl+0 für die ersten 10 Snippets

Verhalten mit ausgewähltem Rufzeichen

Wenn in der Benutzerliste ein Rufzeichen ausgewählt ist, wird der Snippet als Privatnachricht adressiert:

/CQ RUFZEICHEN <Snippet-Text>

Anschließend kann mit Enter direkt gesendet werden – auch wenn das Sendfeld nicht den Fokus hat.

Hardware-Makro-Tastatur

(Idee von IU3OAR, Gianluca Costantino)

Die Tastenkombinationen Ctrl+1 bis Ctrl+0 können auf einer programmierbaren Makro-Tastatur belegt werden. Ein weiterer Tastendruck (auf eine „Enter"-Taste) sendet den Text sofort. Im Contest-Betrieb spart das erheblich Zeit.

Vordefinierte Standard-Snippets

Beim ersten Start werden einige Snippets vorbelegt, z. B.:

• Hi OM, try sked?
• I am calling cq ur dir, pse lsn to me at MYQRG
• pse ur qrg?
• rrr, I move to your qrg nw, pse ant dir me

Diese können in den Preferences angepasst oder gelöscht werden.

---

Variablen

Variablen werden in geschriebenen Texten (Snippets, Shortcuts, Beacon, Sendfeld) durch ihre aktuellen Werte ersetzt. Einfach den Variablennamen großgeschrieben in den Text einfügen.

MYQRG

Wird durch die aktuelle Transceiverfrequenz ersetzt.

• Quelle: TRX-Sync via UDP vom Logprogramm (wenn aktiviert)
• Fallback: Manuell eingetragener Wert im MYQRG-Textfeld rechts neben dem Sendbutton
• Format: 144.388.03

Beispiel: calling cq at MYQRG → calling cq at 144.388.03

MYQRGSHORT

Wie MYQRG, aber nur die ersten 7 Zeichen.

• Format: 144.388

Beispiel: qrg: MYQRGSHORT → qrg: 144.388

MYLOCATOR

Wird durch den eigenen Maidenhead-Locator (6-stellig) ersetzt.

• Format: JO51IJ

Beispiel: my loc: MYLOCATOR → my loc: JO51IJ

MYLOCATORSHORT

Wie MYLOCATOR, aber nur die ersten 4 Zeichen.

• Format: JO51

Beispiel: loc: MYLOCATORSHORT → loc: JO51

QRZNAME

Wird durch den Namen der aktuell ausgewählten Station aus dem Chat-Namenfeld ersetzt.

Beispiel: Hi QRZNAME, sked? → Hi Gianluca, sked?

FIRSTAP

Wird durch Daten des ersten reflektierbaren Flugzeugs zur ausgewählten Station ersetzt (sofern vorhanden).

• Bedingung: AirScout ist aktiv und ein Flugzeug ist verfügbar.
• Format-Beispiel: a very big AP in 1 min

Beispiel: AP info: FIRSTAP → AP info: a very big AP in 1 min

SECONDAP

Wie FIRSTAP, aber für das zweite verfügbare Flugzeug.

• Format-Beispiel: Next big AP in 9 min

Beispiel: also: SECONDAP → also: Next big AP in 9 min

MYQTF (geplant für v1.3)

Wird durch die aktuelle Antennenrichtung in Worten ersetzt (z. B. north, north east, east, …).

• Quelle: Winkelwert im MYQTF-Eingabefeld (rechts neben dem MYQRG-Feld)

---

Variablen im Beacon

Variablen im Beacon

Ein öffentlicher Beacon besitzt keine ausgewählte Gegenstation. Deshalb können hier ausschließlich Variablen verwendet werden, die nur von der eigenen Station und ihrer aktuellen Konfiguration abhängen:

Variable	Wert im Beacon
MYQRG	aktuelle QRG der ersten Chat-Kategorie
MYQRGSHORT	auf sieben Zeichen gekürzte QRG der ersten Kategorie
SECONDQRG	aktuelle QRG der zweiten Chat-Kategorie
MYLOCATOR	eigener vollständiger Locator
MYLOCATORSHORT	eigener vierstelliger Locator
MYCALL	eigenes Rufzeichen
MYQTF	aktuelle Antennenrichtung

QRZNAME, FIRSTAP und SECONDAP benötigen eine ausgewählte Station. In einem öffentlichen Beacon werden sie daher nicht aufgelöst.

Eine zweckmäßige Konfiguration ist beispielsweise:

calling cq at MYQRG, loc MYLOCATOR, GL all!

Die globalen Variablen werden bei jedem Timer-Lauf neu ausgewertet. Dadurch kann eine vom Logprogramm aktualisierte QRG bereits in der nächsten Beacon-Nachricht erscheinen.

Der vollständig aufgelöste Nachrichtentext darf höchstens 120 Zeichen enthalten. Weitere Angaben zum gemeinsamen Intervall und zum Verhalten beider Chat-Kategorien stehen unter Konfiguration – Beacon Settings.

---

Beispiel-Workflow mit Makros im Contest

1. Station in der Benutzerliste auswählen → Rufzeichen ist nun vorausgewählt.
2. Ctrl+1 drücken → Snippet „Hi OM, try sked?" wird als PM adressiert.
3. Enter drücken → Nachricht wird gesendet.
4. Station antwortet mit Frequenz → QRG-Spalte wird automatisch befüllt.
5. Ctrl+2 → Snippet „I am calling cq ur dir, pse lsn to me at 144.388" (MYQRG aufgelöst).
6. Enter → Gesendet.

Ohne manuelle Tipparbeit, ohne Fehler, ohne Unterbrechung des CQ-Rufens.