Muckturnier: readme

1.3.1 Grundsätzliche Regeln

Die genauen Regeln („Wenz über Muck“, „Muck über Wenz“, mit oder ohne Geier, doppelt nach Einwerfen oder nicht etc.) sind für die Auswertung nicht von Belang, solang Bobbl bis zu einer definierten Punktzahl gespielt werden.

Das Turnier in mehrere Runden mit einer definierten Anzahl Bobbl pro Runde einzuteilen ist üblich, aber nicht zwingend nötig: Es kann auch nur eine Runde (dann also das ganze Turnier) mit entsprechend vielen Bobbln gespielt werden. Prinzipiell wäre auch nur ein einziger, großer Bobbl möglich.

1.3.2 Punktwertung

Die Punktwertung ist unabhängig vom Turniertyp:

• Gespielt wird pro Runde eine definierte Anzahl Bobbl (evtl. auch nur eine große Runde).

• Jeder Bobbl wird bis zu einer definierten Zahl von Punkten gespielt. Gewonnen hat das Paar, das zuerst die nötige Punktezahl erreicht bzw. überschreitet. Das Verliererpaar bekommt den Bobbl.

• Der gewonnene Bobbl wird immer nur mit der für den Bobbl definierten Punktezahl gewertet – auch dann, wenn durch das letzte Spiel eigentlich mehr Punkte erreicht worden wären.

• „Brillen“ (doppelte Bobbl, wenn ein Bobbl zu Null gewonnen wird) werden nicht doppelt, sondern wie ein normaler Bobbl gewertet.

• Die in den verlorenen Bobbln erreichten Punkte bekommt das Verliererteam (resp. jeweils die Spieler) als „geschossene Tore“ (vgl. Begriffsdefinitionen) gutgeschrieben.

Die vom Preisschafkopf/Schafkopfrennen bekannten Auswertungsverfahren „Plus“ und „Plus-Minus“ resp. das bloße Aufschreiben von Punkten eignen sich für das Auswerten eines Muckturniers nicht. Alle berücksichtigen nur die Ergebnisse der gespielten Spiele, nicht aber das Gewinnen von Bobbln. Aber genau darum geht es ja gerade beim Mucken!

Ein ausführlicher Artikel mit Rechenbeispielen zu „Plus“ und „Plus-Minus“ kann auf der Muckturnier-Homepage unter Bobbl und Tore vs. Plus und Plus-Minus nachgelesen werden.

1.3.3 Ranglistenerstellung

Zu den Begrifflichkeiten „Bobbl“, „geschossene Tore“ und „gegnerische geschossene Tore“ siehe auch vgl. Begriffsdefinitionen.

• Die Rangliste wird nach gewonnenen Bobbln aufgestellt (je mehr, desto besser).

• Bei gleich vielen gewonnenen Bobbln entscheiden die „geschossenen Tore“ über die Platzierung (je mehr, desto besser).

• Bei Gleichstand von Bobbln und Toren können weiterhin (optional) auch noch die „gegnerischen geschossenen Tore“ zur Unterscheidung der Platzierung herangezogen werden (je weniger, desto besser).

1.3.4 Auslosung und Turniermodus

Es kann sowohl ein Turnier mit festen Paaren als auch mit einzelnen Spielern ausgewertet werden.

Es kann eine Auslosung eingegeben werden, über die eine automatische Paar- und Tischauswahl (am einfachsten über die Tischnumer) erfolgen kann, und/oder die Auswahl kann aufgrund der bisher eingegebenen Ergebnisse erfolgen, vgl. Automatische Auswahl.

Wenn nach dem Schema „Paar 1 bleibt sitzen, Paar 2 rückt einen Tisch weiter“ gespielt wird, dann kann für das ganze Turnier eine automatische Auswahl erfolgen und die Eingabe der Ergebnisse ist sehr schnell durchführbar.

Sofern die Auslosung vor dem Turnier bekannt ist und auch eingegeben (resp. mittels des Programms erzeugt) wurde, ist die automatische Auswahl bereits ab der 1. Runde möglich, ansonsten ab der 2., wenn die Auslosung über die Eingabe der Ergebnisse der 1. Runde klar ist.

1.4.1 Beschränkungen des Programms an sich

Das Programm enthält keine gewollten Beschränkungen. Im Realeinsatz ist Muckturnier noch nie an irgendwelche Grenzen gestoßen.

Die Punkte pro Bobbl und die Anzahl der Bobbl pro Runde sind auf maximal 9 999 eingestellt (das Bedienelement braucht einen Maximalwert). Ich kann mir nicht vorstellen, dass jemand jemals mehr brauchen könnte, aber auch in dem Fall könnte man den Wert durch das Editieren der Datei shared/DefaultValues.h (die alle hart kodierten Werte enthält) beliebig im Rahmen der Grenzen der Datentypen erhöhen. Natürlich muss Muckturnier danach neu kompiliert werden).

Nur der Vollständigkeit halber: Die verwendeten Datentypen setzen faktisch Grenzen. Allerdings wird man diese mit sehr großer Wahrscheinlichkeit niemals erreichen. Für Punktzahlen, Runden, IDs etc. wird beispielsweise der Datentyp int benutzt, dessen Maximalwert bei 2 147 483 647 liegt.

Folgerichtig gibt es de facto keine relevanten Beschränkungen.

1.4.2 Beschränkungen der zugrundeliegenden Datenbank

Muckturnier benutzt eine SQLite-Datenbank. Die Grenzen von SQLite (bezüglich der maximalen Zeilen pro Tabelle etc.) wird man noch viel unwahrscheinlicher erreichen, als die durch die Datentypen gesetzten.

Abgesehen davon ist mir bis dato nur eine einzige womöglich praxisrelevante Einschränkung bekannt: Eine SQLite-Datenbank mit Schreibzugriff auf einer Windows-Netzwerkfreigabe bzw. einem Samba-/CIFS-Share funktioniert nicht richtig. Das liegt weder am Muckturnier-Programm, noch an SQLite selbst; es liegt an dem Dateisystem-Protokoll, das Windows-Netzwerkfreigaben bzw. Samba-Shares nutzen.
Das Anlegen einer Datenbank bzw. das Öffnen einer Datenbank mit Schreibzugriff auf einem solchen Netzwerklaufwerk ist deswegen nicht möglich.

2.1.1 Oberfläche und Dialoge

Ist noch kein Turnier geöffnet, werden nur die Knöpfe zum Anlegen bzw. Öffnen eines Turniers angezeigt (alternativ kann man das auch über „Datei“ → „Neues Turnier starten“ bzw. „Turnier öffnen“ machen). Sobald ein Turnier geöffnet ist bzw. ein neues angelegt wurde, wird die „Paare“- bzw. „Spieler“-Seite angezeigt. Wenn die nötige Anzahl an Paaren bzw. Spielern angemeldet wurde, wird die „Ergebnisse“-Seite, und nach der Eingabe des ersten Ergebnisses schließlich die „Rangliste“-Seite angezeigt.

Standardmäßig werden die Seiten als Tabs (also hintereinander) angezeigt. Sie können aber auch (durch Ziehen mit der Maus) neben- oder übereinander angezeigt werden, sofern das Fenster groß genug ist. Weiterhin können alle Seiten aus dem Hauptfenster herausgezogen, und dann als eigene Fenster angezeigt werden. Das ist z. B. nützlich, wenn man die Rangliste live über einen Beamer (etwa auf einem virtuellen zweiten Desktop) anzeigen will o. Ä.

2.1.2 Speichern

Mit jeder Dateneingabe oder -änderung wird die Datenbank aktualisiert. Man muss also den jeweils aktuellen Zustand der Datenbank nicht extra speichern.

Jeder Schreibvorgang ist „atomar“, d. h., dass ein Datensatz entweder vollständig oder gar nicht gespeichert wird. Es sollte also auch bei einem Stromausfall (Netzteilstecker wird versehentlich aus dem Notebook gezogen, Akku leer) nicht zu Inkonsistenzen in der Datenbank kommen.

Trotzdem ist natürlich jeder selbst für seine Datensicherung verantwortlich (vgl. auch Backup der Datenbank anlegen und wiederherstellen)!

2.2.1 Grundeinstellungen

Per Voreinstellung zeigt der „Neues Turnier starten“-Dialog nur die „Grundeinstellungen“-Seite. Hier werden Einstellungen festgelegt, die während des Turniers nicht mehr verändert werden können. Namentlich sind das: Der Turniertyp (feste Paare oder einzelne Spieler) und die Punkte pro Bobbl sowie die Bobbl pro Runde.

2.2.2 Erweiterte Optionen

Wenn die Auswahlbox „Erweiterte Optionen“ angehakt ist, wird links eine Liste weiterer Seiten neben der „Grundeinstellungen“-Seite eingeblendet. Hier können Voreinstellungen für Werte und Optionen eingestellt werden, die auch noch während des Turniers verändert werden können.

Wo die Werte verändert werden können, und was die Einstellungen bedeuten, ist jeweils auf der Seite erklärt.

2.2.3 Turnierinformationen

Über „Datei“ → „Turnierinformationen“ wird für das laufende (offene) Turnier die gewählte Konfiguration angezeigt.

2.3.1 Paar- bzw. Spielernummern

Optional ist es möglich, einem Paar bzw. Spieler eine (eindeutige) Nummer zuzuordnen. Hierür kann die optionale Spalte „Nummer“ (über das „Einstellungen“-Menü auf der Anmeldeseite) eingeblendet werden.

Eine Nummer kann über das Kontextmenü oder per Klick auf „…“ in der jeweiligen Zeile zugeordnet (bzw. gelöscht) werden. Es wird immer die erste freie Nummer, also die höchste vorhandene plus 1 vorausgewählt. Es kann auch eine höhere Nummer bzw. eine „Lücke“ neu vergeben werden.

Eine Nummer kann bei allen Suchen (auch bei der Paar- bzw. Spielerauswahl) benutzt werden. Wenn nach einer reinen Zahl gesucht wird, die größer als 0 ist, dann bekommt man entweder exakt einen Treffer (nämlich das Paar bzw. den Spieler mit dieser Nummer) oder keinen (sofern es keine Anmeldung mit dieser Nummer gibt).

2.3.2 Paare bzw. Spieler markieren

Per Voreinstellung wird beim Anlegen einer neuen Datenbank (sofern keine eigene Vorlage definiert wurde) ein vernünftiger Satz an Markierungen erstellt, der sich in der Praxis schon vielfach bewährt hat. Diese Markierungen können beliebig geändert und auch gelöscht werden, und es können beliebig viele eigene Markierungen hinzugefügt werden.

Wird der „Standard“-Satz Markierungen benutzt, dann werden beim Berücksichtigen allein gekommener Spieler bzw. von Voranmeldungen gleich die passenden Markierungen ausgewählt.

Für jede Markierung kann eine Farbe und ein Name vergeben werden. Bei der Sortierung kann zwischen „neuer Block“ und „fortlaufend“ gewählt werden. Ein neuer Block gruppiert alle entsprechend markierten Namen, mit einer „fortlaufenden“ Markierung markierte Namen werden mit in den vorhergehenden Block einsortiert. Die Reihenfolge der Markierungen bestimmt die Reihenfolge der Anzeige.

Über das Kontextmenü der Paar-/Spielerliste können einzelne Paare/Spieler oder die ganze Liste markiert werden, bzw. es können Markierungen entfernt oder auch entsprechend markierte Einträge gelöscht werden.

Abgesehen vom Markieren allein gekommener Spieler oder von Voranmeldungen kann man auch z. B. Paare/Spieler, die das Startgeld noch nicht bezahlt haben markieren, solche, bei denen die Auslosung noch fehlt etc.

2.3.3 Voranmeldungen berücksichtigen

Eine Markierung kann für abwesende Anmeldungen benutzt werden. So markierte Anmeldungen werden ignoriert, und entsprechend nicht beim Zählen der Anmeldungen bzw. der Tische und bei der Entscheidung ob oder ob nicht das Turnier gestartet werden kann berücksichtigt.

Gedacht ist das für Voranmeldungen: Die stehen bereits in der Liste, sind ja aber noch nicht da.

Vor dem Turnierstart können alle als abwesend markierte Anmeldungen (die also doch nicht gekommen sind) über ihre Markierung) auf ein Mal gelöscht werden.

2.3.4 Allein gekommene Spieler berücksichtigen

Bei Feste-Paare-Turnieren können allein gekommene Spieler gesondert behandelt werden. Es muss eine Markierung als „Allein da“ definiert werden. Diese kann bei der Anmeldung auch automatisch gestezt werden, z. B. dann, wenn der Name keinen Schrägstrich enthält.

Allein gekommene Spieler können per Kontextmenü zu einem Paar zusammengeführt werden. Es wird immer angezeigt, wie viele Paare und/oder Spieler noch fehlen, damit das Turnier gestartet werden kann.

2.4.1 Einstellungen

Es müssen zwei Einstellungen vorgenommen werden, bevor man die Seite nutzen kann: Ein Turniername und ein Sicherheitsschlüssel. Beides sind frei wählbare Zeichenketten.

Für den Turniernamen sollte man eine eindeutige Bezeichnung wählen, um Verwechslungen auszuschließen (z. B. „JU Leupoldsgrün 2024“). Der Sicherheitsschlüssel wird automatisch zufällig generiert, und sollte einfach so belassen werden.

Sobald die Einstellungen gespeichert sind, wird ein Backup in eine Textdatei angeboten (UTF-8-kodiert). Ein solches Backup kann auch später noch automatisch oder auch manuell erzeugt werden. Der Grund ist folgender: Wenn man Anmeldungscodes generiert und verschickt hat, und löscht bzw. verändert die Einstellungen oder löscht die Datenbank, dann können die Einstellungen (auch in einer neu angelegten Turnierdatenbank) wiederhergestellt werden. Wenn nicht sowohl der Turniername als auch der Sicherheitsschlüssel exakt identisch sind, schlägt die Prüfung aller damit erzeugten Codes fehl. Den Turniernamen kann man aus einem Code extrahieren, nicht aber den Sicherheitsschlüssel.

Es bietet sich also an, sicherheitshalber ein Backup zu machen, bevor man Codes erzeugt.

2.4.2 Anmeldungscodes generieren

Sobald die Einstellungen festgelegt sind, kann man Anmeldungscodes generieren. Dazu benötigt man vorangemeldete Anmeldungen. Diese können entweder direkt auf der Voranmeldungsseite eingetragen werden, oder auf der Anmeldungsseite registiert und manuell als „Vorangemeldet“ markiert werden (resp. über die Einstellung für die automatische Markierung für neue Anmeldungen). Beim Anmelden über die Voranmeldungsseite wird die Anmeldung an die Anmeldungsseite weitergegeben und die „Vorangemeldet“-Markierung gesetzt. Die Suche nach Duplikaten etc. ist also dieselbe wie bei der Eingabe auf der Anmeldungsseite.

In der Combobox „Voranmeldung“ sind alle Voranmeldungen aufgelistet, und es kann ausgewählt werden, welcher Datensatz angezeigt werden soll. Der QR-Code des Datensatzes enthält die relevanten Anmeldedaten, und kann z. B. in einer Bestätigungs-E-Mail verschickt werden.

Die Daten enthalten u. a. eine Prüfsumme, zu deren Berechnung auch der Sicherheitsschlüssel benutzt wird. Da dieser geheim ist, ist praktisch ausgeschlossen, dass jemand seinen „eigenen“ gültigen Anmeldungscode generiert und behauptet, er wäre vorangemeldet. Die technischen Details über die in den QR-Codes enthaltenen Daten und das benutzte Serialisierungsprotokoll können Interessierte in doc/BookingCodeProtocol.rst nachlesen.

2.4.3 Voranmeldungen anmelden

Hierfür benötigt man entweder einen Hardware-QR-Code-Scanner (die sind tatsächlich relativ günstig), einen Smartphone-Barcode-Scanner, der sich mit dem WLAN-Code-Scanner-Server unterhalten kann oder eine Softwarelösung, mit der man QR-Codes scannen kann, die dann automatisch eingetippt werden (z. B. mit einer Webcam, ZBarCam und xvkbd o. Ä.).

Wichtig: Bei einem Hardware-Scanner auf das richtige Tastaturlayout des Scanners achten! Voreinstellung ist normalerweise US-Amerikanisch. Da wären dann z. B. z, mit y vertauscht, / mit - etc. wenn man das normale deutsche Layout auf seinem Computer benutzt – und es kommt nicht das raus, was in dem Code gespeichert wurde (was dann auch zum Fehlschlagen der Checksummenprüfung führt).

Damit der Scan automatisch direkt verarbeitet wird, muss der Scanner nach der Eingabe des Datensatzes automatisch auf Return „drücken“. Das ist normalerweise die Voreinstellung. I. d. R. kann man das auch einstellen: Die Einstellung heißt „Terminator Symbol“ o. Ä. und muss dann auf CR+LF stehen.

Sind Einstellungen für die Voranmeldung festgelegt, dann wird auf der Anmeldungsseite ein Label angezeigt, das darüber informiert, ob gerade gescannt werden kann, oder nicht. Gescannt werden kann dann, wenn das Eingabefeld für den Paar- bzw. Spielernamen fokussiert ist, also den Cursor enthält, und sonst noch nichts eingegeben wurde.

Eine Eingbe, die potenziell ein Anmeldungscode ist, wird nicht als neue Registierung, sondern eben als Anmeldungscode-Eingabe gewertet. Identifiziert wird so ein Code über den Header des Protokolls. Alles, was mit MTBC („MuckTurnier Booking Code“, in Großbuchstaben) anfängt, wird als Anmeldungscode betrachtet (es ist also im Voranmeldungsmodus nicht möglich, ein Paar bzw. einen Spieler anzumelden, dessen Name mit „MTBC“ in Großbuchstaben beginnt, allerdings ist das ja auch eher selten am Anfang eines Namens zu finden ;-).

Ist alles okay und gibt es die im Code gespeicherte Voranmeldung, dann wird angeboten, sie als „gekommen“ zu markieren. Hierfür wird die Markierung für neue Anmeldungen benutzt, oder – wenn das Berücksichtigen allein gekommener Spieler aktiviert ist und die Bedingung zutrifft – die Markierung für allein gekommene Spieler.

Wenn es keine passende Voranmeldung gibt, dann wird vorgeschlagen, das Paar bzw. den Spieler neu anzumelden.

Sobald ein Anmeldungscode exportiert wird, wird die Prüfsumme beim jeweiligen Paar bzw. Spieler in der Datenbank gespeichert. Über die Prüfsumme kann eine Voranmeldung auch dann identifiziert werden, wenn nach dem Export des Codes der Name geändert wurde. Es ist also nicht nötig nach einer Änderung einer Voranmeldung den Code neu zu verschicken, sofern sie nicht gelöscht und neu angelegt wurde.

Mit Anmeldungscodes geht die Anmeldung sehr schnell. Ein Spieler des Paars bzw. der Spieler zeigt den Code vor (z. B. einfach auf seinem Handy) vor, scannen – „Ja“ – fertig.

2.4.4 WLAN-Code-Scanner-Server

Die WLAN-Code-Scanner-Server-Seite kann über „Extras“ → „WLAN-Code-Scanner nutzen“ eingeblendet werden.

Mit dem WLAN-Code-Scanner-Server ist es möglich, eine passende Smartphone-App anstatt eines Hardware-Barcode-Scanners zum Scannen von Anmeldungscodes zu benutzen. Hierfür muss die App die gescannten Daten per HTTP-Request an einen Server weitergeben können (und natürlich müssen der Rechner, auf dem das Programm läuft, und das Smartphone im selbem Netzwerk sein und sich erreichen können).

Eine sehr zu empfehlende kompatible App ist Binary Eye, ein kostenlos erhältlicher Open-Source-Barcode-Scanner für Android (gibt es auf F-Droid und auch im Google Play Store).

Der Server kann GET- und POST-Anfragen verarbeiten. Bei Verwendung von POST können die Daten entweder mit dem Content-Type application/x-www-form-urlencoded oder als application/json formatiert werden. Der Parameter für den Datensatz heißt per Voreinstellung content, der Name kann aber bei den Netzwerkeinstellungen („Extras“ → „Einstellungen“ → „Netzwerk“) beliebig definiert werden.

Die in der App anzugebende URL hängt davon ab, wie die Daten weitergegeben werden. Beispiel: Der Server läuft unter der IP-Adresse 192.168.0.1 und benutzt Port 8812:

Wenn die App die Daten per GET weitergibt, indem sie sie direkt an die Ziel-URL anhängt (bei Binary Eye wäre das Requesttyp „GET mit an die URL angehängtem Inhalt“), dann müsste man den Parameternamen explizit angeben. Die einzustellende URL wäre in diesem Fall dann http://192.168.0.1:8812/?content=.

Werden via GET mehrere Parameter übergeben (bei Binary Eye „GET mit vollständigem Query-String“) oder POST benutzt, dann reicht normalerweise die Angabe der URL ohne weitere Parameter. Im genannten Beispiel wäre das dann http://192.168.0.1:8812/.

Der WLAN-Code-Scanner-Server nutzt standardmäßig Port 8812 TCP. Laut IANA ist dieser Port frei (Stand: 02/2024) und es wurde auch noch keine „Illegal Activitiy“ darauf verzeichnet. Die Chancen stehen also ganz gut, dass man ihn „einfach so“ nutzen kann. Das benutzte Betriebssystem muss natürlich zulassen, dass ein TCP-Server gestartet wird, und den Traffic des Servers nicht blockieren.

Falls ein anderer Prozess auf dem Rechner den Port 8812 TCP bereits benutzen sollte (oder einem der Port einfach nicht gefällt ;-), kann man die Voreinstellung über den „Einstellungen“-Dialog (Seite „Netzwerk“) beliebig zwischen 1024 und 65535 festlegen.

Empfangene Codes werden an die Anmeldungsseite weitergegeben und genau so behandelt, als würde ein Hardware-Barcode-Scanner zum Einsatz kommen (es muss das „Name(n)“-Eingabefeld fokussiert sein, damit der Code verarbeitet wird).

2.5.1 Fortlaufende Platzvergabe

Ist die Option „Fortlaufend“ gewählt, dann findet streng genommen keine Auslosung statt. Es wird immer der erste freie Platz voreingestellt. Es entstehen keine Lücken, und die Auslosung ist zwangläufig fortlaufend und – die passende Anzahl an Anmeldungen natürlich vorausgesetzt – auch vollständig. Allerdings fehlt natürlich hierbei der Zufall.

2.5.2 Zufällige Platzvergabe

Für die zufällige Vergabe der Plätze gibt es drei Optionen:

2.5.3 Maximale Tischanzahl

Ungeachtet der anderen Optionen kann eine maximale Tischanzahl eingestellt werden. Die einstellbaren Werte für die komplett zufällig Auslosung und das Limit für die zufällige Vergabe richten sich danach. Wenn die Fenster-Vergabe aktiviert ist, dann werden keine Tische oberhalb des Tisch-Limits ausgelost.

Ist die Option aktiviert und alle verfügbaren Plätze wurden vergeben, dann erfolgt nur noch eine sequenzielle (fortlaufende) Platzvegabe und es wird ein Warnhinweis angezeigt.

Außerdem wird, sofern eine maximale Tischanzahl gesetzt ist, bereits auf der Anmeldeseite ein Warnhinweis angezeigt, wenn mehr Anmeldungen als Plätze vorliegen.

2.5.4 Auslosung bereinigen

Wenn durch die zufällige Vergabe von Plätzen Lücken und/oder unvollständige Paare entstanden sind, muss die Auslosung vor dem Beginn des Turniers bereinigt, also vollständig und fortlaufend gemacht, werden.

Das kann automatisch über „Extras“ → „Auslosung bereinigen“ bzw. die Links auf der Anmelde- oder Auslosungs-Übersichts-Seite erfolgen. Die Funktion steht zur Verfügung, wenn die Anzahl der Anmeldungen für den gewählten Turniermodus korrekt ist (durch zwei teilbar für feste Paare, durch vier teilbar für einzelne Spieler), es keine abwesenden oder allein gekommenen Anmeldungen gibt und alle Anmeldungen eine Auslosung haben (also potenziell das Turnier begonnen werden kann).

Dabei wird die Variante berechnet, bei der möglichst wenige Paare/Spieler umgesetzt werden müssen. Immer vorausgesetzt, dass es nötig ist, wird dabei folgendes in folgender Reihenfolge gemacht:

Für Einzelspielerturniere zunächst:

• Unvollständige Paare mit Spielern vervollständigen, die die passende Paarnummer gezogen haben

• Unvollständige Paare mit Spielern vervollständigen, die eine andere Paarnummer gezogen haben

Für Feste-Paare- und Einzelspielerturniere dann:

• Unvollständige Tische mit Paaren der passenden Paarnummer vervollständigen

• Unvollständige Tische mit Paaren, die eine andere Paarnummer hatten, vervollständigen

• Lücken durch unbesetzte Tische schließen

Es werden also möglichst viele Paare/Spieler in ihrer bereits zugelosten Rolle „Paar 1“ bzw. „Paar 2“ belassen (damit sich möglichst wenige beschweren). Das Umsetzen/Auffüllen geht immer vom Ende der Auslosung aus, so dass bei einer quasi-sequenziellen „Verlosungsfenster“-Vergabe nur wenige Paare/Spieler umgesetzt werden müssen, und das die sind, die sich ganz am Ende angemeldet hatten.

Optional kann die Liste der nötigen Änderungen auch ausgedruckt werden. Hierzu wird sie (der Einfachheit halber zunächst) in eine HTML-Datei exportiert und mit dem Standard-Webbrowser geöffnet. Mit diesem kann sie dann gedruckt werden.

2.6.1 Info-Display

Das Info-Display ist ein extra Fenster, das die momentane Uhrzeit, die gerade gespielte Runde bzw. Pause, sowie die verbleibende Zeit und den Start der nächsten Runde anzeigt.

Gedacht ist das Info-Display zur Vollbildanzeige auf einem zweiten Monitor, einem Fernseher, Beamer etc., so dass alle wissen, wie viel Zeit sie noch zum Spielen haben bzw. wann die nächste Runde losgeht. Die Vollbildanzeige kann im Info-Display über den Menüknopf umgeschaltet werden, oder auch über den Knopf auf der Zeitplan-Seite, mit dem man das Info-Display startet.

Die Größe und Position der Texte, die Ränder und alle Farben können mittels des Menü-Knopfs links oben individualisiert werden. Alle Einstellungen können gespeichert werden und werden dann beim nächsten Mal automatisch wieder angewandt. Diese Parameter sind rechnerspezifisch, nicht datenbankspezifisch und werden deswegen nicht in der gerade benutzen Datenbank abgelegt, sondern auf dem gerade benutzen Computer.

2.6.2 Strafpunkte

Ein womöglich interessantes Feature sind die „Strafpunkte“: Gedacht ist das als „Disziplinierungsmaßnahme“, wenn man mit einer Zeitbegrenzung arbeitet. Es passiert immer wieder, dass ein Paar kommt und sich beschwert, dass die Runde nun schon 10 Minuten läuft, aber das gegnerische Paar noch nicht gekommen ist. In diesem Fall könnte man dem „unschuldigen“ Paar Ausgleichs-Punkte gutschreiben, da ja schon Spielzeit verloren gegangen ist. Die Strafpunkte-Anzeige zeigt zu jeder Zeit (gleichmäßig verteilt auf die komplette Spielzeit pro Runde) an, wie viele es gerade wären.

Die Anzeige ist rein informativ. Automatisch passiert nichts. Wenn man das Feature nicht nutzen will, kann man die Anzeige einfach ignorieren.

2.7.1 Rundenauswahl

Zunächst wird die Runde ausgewählt, für die das Ergebnis eingetragen werden soll. Wenn eine Runde offen ist (also noch nicht alle Ergebnisse der entsprechenden Runde eingetragen wurden), dann wird automatisch diese Runde geöffnet (bzw. die erste offene Runde, falls mehrere Runden offen sind).

Alle bisher abgeschlossenen Runden sowie alle offenen Runden können über die Rundenauswahl angezeigt bzw. bearbeitet werden.

2.7.2 Paar- bzw. Spielerauswahl

Der Eingabedialog sieht die Eingabe von Runde, Tischnummer und zwei Paaren bzw. vier Spielern vor. Sollte ohne Tischnummern gespielt werden, kann die Tischauswahl auch ausgeblendet werden (über das Menü des „Einstellungen“-Knopfes). In diesem Fall wird eine Tischnummer automatisch intern gesetzt (für die Datenbank muss immer eine Tischnummer ausgewählt werden, auch dann, wenn sie nicht angezeigt wird) und die automatische Auswahl steht nicht zur Verfügung.

Die Auswahlboxen enthalten als wählbare Optionen alle noch nicht eingegebenen Paare bzw. Spieler und Tischnummern. Es können auch Teile der Namen bzw. des Namens eingeben werden. Damit werden die auswählbaren Optionen auf Übereinstimmungen eingeschränkt (das ist besonders bei vielen Spielern äußerst nützlich).

2.7.3 Punkte und Bobbl eingeben

Unter der Paarauswahl gibt es für jeden Bobbl ein Eingabefeld. Das ausgewählte Paar bekommt den Bobbl (hat ihn also verloren; hier den Radio-Knopf anklicken) und es können die erreichten Punkte („geschossene Tore“) eingegeben werden. Das andere Paar bekommt automatisch die festgelegten Bobbl-Punkte, hier wird das Eingabefeld deaktiviert (außer, wenn der Bobbl abgebrochen wurde).

Ein Rechtsklick auf einen der beiden Radio-Knöpfe bzw. Eingabefelder öffnet einen kleinen Eingabedialog, mittels welchem der Spielstand direkt durch einen Klick ausgewählt werden kann, ohne das Mausrad oder die Tastatur verwenden zu müssen.

Der Spielstand kann entweder mit dem „Ergebnis eintragen“-Knopf gespeichert werden, oder indem man in einem der beiden Eingabefelder im letzten Spiel die Return- bzw. Enter-Taste drückt.

2.7.4 Eingetragene Ergebnisse

Unten werden alle bisher eingetragenen Spielergebnisse angezeigt. Per Kontextmenü (mit der rechten Maustaste oder mit einem Doppelklick einen Spielstand anklicken) kann man einen Spielstand löschen oder korrigieren.

Beim Korrigieren wird der Spielstand auch gelöscht, aber die eingegebenen Daten werden als ausgewählte Werte gesetzt. So kann man z. B. einen falsch eingegebenen Punktestand schnell korrigieren, ohne die anderen Werte erneut eingeben zu müssen und den Tisch bzw. die Paare neu auszuwählen.

2.10.1 Import einer Paar- bzw. Spielerliste

Wenn das Turnier noch nicht begonnen hat (also noch kein Spielstand eingegeben wurde), kann eine Paar- bzw. Spielerliste importiert werden. Der zugehörige Menüpunkt ist „Datei“ → „Import und Export“ → „[Paar|Spieler]liste importieren“. Hierfür kann eine einfache, UTF-8-kodierte Textdatei (wie sie auch von der Exportfunktion erzeugt wird) verwendet werden, die pro Zeile einen Paar- bzw. Spielernamen enthält. Leerzeichen am Anfang oder Ende, mehrere aufeinanderfolgende Leerzeichen sowie leere Zeilen werden automatisch entfernt.

Wird eine Datei geöffnet, die Zeichen außerhalb der ASCII-Kodierung enthält (Umlaute, Akzente, etc.), und mit der falschen Kodierung gespeichert wurde (z. B. Windows-1252, ISO 8859-1, ISO 8859-15 etc.), dann wird der Import abgebrochen.
Jeder vernünftige Editor (unter Linux was auch immer man nehmen will, unter Windows z. B. notepad++) kann eine solche Datei mit der „falschen“ Kodierung öffnen, und mit der „richtigen“ speichern, so dass sie trotzdem importiert werden kann.

Es wird eine Vorschau des zu importierenden Datensatzes angezeigt. Gibt es (wenn bereits Paare/Spieler angemeldet sind oder auch innerhalb der Importdatei) Duplikate und/oder Namen, die zu Verwechslungen führen könnten, werden diese extra angezeigt und können vom Export ausgeschlossen bzw. mit einem Präfix ergänzt werden (um sie nach dem Import leicht finden und evtl. umbenennen zu können).

In keinem Fall werden bestehende Anmeldungen überschrieben oder gelöscht.

2.10.2 Export der Paar- bzw. Spielerliste

Sobald mindestens ein Paar bzw. Spieler angemeldet wurde, kann eine Liste der Paare bzw. Spieler exportiert werden (um z. B. eine Liste zum Abhaken aus einer bereits mit Voranmeldungen gefüllten Datenbank erstellen zu können).

Der zugehörige Menüpunkt ist „Datei“ → „Import und Export“ → „[Paar|Spieler]liste exportieren“. Es kann auch eine per Markierungen ausgezeichnete Untermenge der Anmeldungsliste exportiert oder vom Export ausgeschlossen werden.

Die Liste wird als einfache Textdatei exportiert und ist UTF-8-kodiert. Man kann dieses Format mit einem beliebigen Texteditor oder Textverarbeitungsprogramm öffnen und weiterverarbeiten.

2.10.3 Export von Turnierdaten nach Abschluss des Turniers

Sind alle Runden abgeschlossen (das Turnier also potenziell beendet), können via „Datei“ → „Import und Export“ → „Turnierdaten exportieren“ (alle) Daten des Turniers in ein von Muckturnier und der Datenbank unabhängiges Format exportiert werden.

Man kann auswählen, welche Datensätze exportiert werden, und wie diese formatiert sein sollen (sollen z. B. Überschriften angezeigt werden, die Ergebnisse als einfache Zahl oder mit dem Bobbl-Symbol ausgegeben werden etc.).

Die Daten können als HTML oder CSV exportiert werden. Als Zeichensatz kommt jeweils UTF-8 zum Einsatz.

2.11.1 Technische Aspekte

Es werden für die Netzwerkkommunikation zwei Server benutzt. Einmal der „Discover“-Server, mit dessen Hilfe Clients einen Muckturnier-Server im Netzwerk automatisch finden können, und der eigentliche Muckturnier-Server, der sich um das Verteilen von Änderungen und auch den Ranglistenvergleich kümmert.

Der Muckturnier-Server nutzt standardmäßig Port 8810 TCP, der Discover-Server Port 8811 UDP. Diese beiden Ports sind laut IANA nicht vergeben (Stand: 09/2019) und es wurde auch noch keine „Illegal Activitiy“ darauf verzeichnet. Die Chancen stehen also ganz gut, dass man sie „einfach so“ nutzen kann.

Falls ein anderer Prozess auf dem Rechner die Ports 8810 TCP und/oder 8811 UDP bereits benutzen sollte (oder einem die Ports einfach nicht gefallen ;-), können sie über den „Einstellungen“-Dialog (Seite „Netzwerk“) beliebig zwischen 1024 und 65535 eingestellt werden. Es können auch beide Server den selben Port nutzen, weil der eine TCP und der andere UDP verwendet, und es wegen des unterschiedlichen Protokolls auch dann keine Kollisionen gibt (wenngleich man das eigentlich nur dann macht, wenn der selbe Dienst über zwei Protokolle erreichbar ist. In diesem Fall sind es zwei verschiedene Dienste; technisch möglich ist es aber jedenfalls).

Wenn ein Programm unter Windows z. B. einen TCP-Server startet, dann wird i. d. R. eine Sicherheitswarnung der „Firewall“ angezeigt. Natürlich darf die Netzwerkkommunikation des Muckturnier-Programms nicht geblockt werden. Der oder die verwendeten Ports dürfen natürlich ebenfalls nicht blockiert werden, weder auf der Server-, noch auf der Client-Seite.

In den meisten Fällen wird wohl ein klassisches IPv4-Klasse-C-Netzwerk zum Einsatz kommen (mit Adressen wie 192.168.0.10, 192.168.0.11 etc.), IPv6-Adressen können aber genauso benutzt werden.

Technisch gesehen ist das Muckturnier-Serverprotokoll so aufgebaut, dass die zu übermittelnden Daten erst in ein JSON-Objekt verpackt, dann in einen String konvertiert, und schließlich in einem QDataStream per TCP/IP übertragen werden. Auf der anderen Seite wird dann wieder aus dem Stream der String geholt, in ein JSON-Objekt geparst und man kann auf die Daten zugreifen. Netterweise kümmern das zugrundeliegende Protokoll TCP und der QDataStream bereits auf der Übertragungsebene darum, dass alle Pakete vollständig und in der richtigen Reihenfolge übertragen werden.

Es gibt keine Authentifizierung und auch keine Absicherung der Kommunikation; man sollte darauf achten, ein geschlossenes Netzwerk aufzubauen, das nur aus vertrauenswürdigen Teilnehmern besteht.
Einen irgendwie gearteten Angriff mittels manipulierter Anfragen kann ich mir zwar beim besten Willen nicht vorstellen – schlimmstensfalls sollte eine (manipulierte) Anfrage vom Server abgelehnt und/oder die Verbindung zum Client aufgrund nicht mehr synchroner Prüfsummen beendet werden. Aber man weiß ja nie ;-)

2.11.2 Muckturnier-Server

Sobald auf einem der beteiligten Rechner eine beschreibbare Datenbank geöffnet ist, kann dort per „Netzwerk“ → „Als Server einrichten“ ein Muckturnier-Server gestartet werden, an dem sich dann beliebig viele andere Rechner als Clients anmelden können (per „Netzwerk“ → „Mit Server verbinden“).

Über das Netzwerk werden Änderungen an der Anmeldungsliste verteilt, und es ist ein Ranglistenvergleich möglich. Es wird jeweils TCP als Protokoll benutzt. Der Port kann frei gewählt werden (von 1024 bis 65535, voreingestellt ist 8810), darf aber natürlich noch von keinem anderen Programm belegt sein.

Wird auf einem Rechner die Netzwerk-Client-Seite geöffnet, wird automatisch versucht, einen Muckturnier-Server im Netzwerk zu finden. Dieser Vorgang kann (wenn der Server z. B. noch nicht gestartet war) mittels „Server suchen“ wiederholt werden. Wird der Server nicht gefunden, kann die IP-Adresse und der Port (die sog. „Socket-Adresse“) des Servers auch manuell eingegeben werden.

Damit sich ein Client verbinden kann, muss er ebenfalls eine beschreibbare Datenbank geöffnet haben. Damit eine Verbindung hergestellt werden kann, müssen die Turniereinstellungen identisch sein, ansonsten wird die Verbindung abgelehnt.

Wenn noch keine Ergebnisse eingegeben wurden, dann werden evtl. lokal eingegebene Namen gelöscht, und die komplette Anmeldungsliste des Servers übernonmmen. Gibt es bereits Ergebnisse, dann wird die lokale Anmeldungsliste mit der des Servers abgeglichen und Änderungen können übernommen (alternativ auch manuell korrigiert) werden. In jedem Fall werden lokale Markierungen verworfen und durch die auf dem Server ersetzt.

2.11.3 Discover-Server

Der Discover-Server wird beim Start des Muckturnier-Servers automatisch mitgestartet, mit der in den Einstellungen festgelegten Portnummer. Die Voreinstellung ist Port 8811, es wird UDP als Protokoll benutzt.

Der Betrieb des Servers ist nicht zwingend nötig. Er bringt aber den Komfort, dass die Socket-Adresse des Servers nicht manuell eingegeben werden muss: Wenn ein Client sich mit einem Server verbinden will, dann wird zunächst automatisch per UDP-Broadcast nach einem Server gesucht. Wenn der Server so eine Anfrage erhält, dann antwortet er mit seiner IP-Adresse und Portnummer, und die kann dann automatisch zum Verbinden benutzt werden.

Sollte das Starten fehlschlagen oder der genutzte Port (bzw. UDP-Kommunikation darüber) blockiert sein, funktioniert der Muckturnier-Server unabhängig davon trotzdem; die Clients müssen lediglich vor dem Verbinden die IP-Adresse und den Port des Servers manuell eingeben.

2.11.4 Anmeldungsnetzwerk

Alle Änderungen an der Paar- bzw. Spielerliste, die an einem der Rechner im Netzwerk vorgenommen werden (egal ob Server-Rechner oder Client-Rechner), werden an alle Beteiligten verteilt und angewandt. Namentlich das Anmelden neuer Paare/Spieler, das Löschen oder Umbenennen vorhandener und das Markieren bzw. Enfernen von Markierungen. Änderungen an verfügbaren Markierungen werden ebenso verteilt.

Alle Rechner, die sich an einem Muckturnier-Server angemeldet haben, haben immer den selben Datenbestand bezüglich Markierungen und der Anmeldungsliste.

2.11.5 Vergleich der eingegebenen Ergebnisse

Im Netzwerkbetrieb muss die Anmeldung explizit beendet werden, bevor Ergebnisse eingegeben werden können. Das kann der Server und auch jeder Client über „Netzwerk“ → „Anmeldung beenden“ (bzw. über den zugehörigen Link auf der Ergebnisse-Seite) machen.

Die eingegebenen Ergebnisse werden nicht synchronisiert. Der Sinn dahinter ist das Finden von Eingabefehlern: Wenn man die Ergebnisse unabhängig voneinander an mindestens zwei Rechnern eingibt, dann treten bei Tippfehlern, Zahlendrehern etc. Unterschiede auf. Würde man die Eingabe auf zwei Rechner aufteilen, hätten gleich zwei Benutzer die „Chance“, unbemerkte Falscheingaben zu machen.

Alle eingegebenen Ergebnisse werden fortlaufend verglichen. Am Server mit allen Clients und an jedem Client mit dem Server. Der Status (identisch – nicht identisch) wird neben den bisherigen Ergbnissen angezeigt. Die Anzeige wird bei jeder client- und serverseitigen Eingabe aktualisiert. Gibt es Unterschiede, dann können diese mittels des dann angezeigten Links in einem extra Dialog angezeigt und (durch den Abgleich mit dem jeweiligen Spielstandzettel) korrigiert werden.

2.11.6 Unterschiede zum Ein-Rechner-Betrieb

Prinzipiell sollten die Netzwerkfunktion im Rahmen des Möglichen transparent funktionieren, d. h. dass z. B. durch eine Änderung eines anderen Netzwerkteilnehmers ein anderer nicht beeinträchtigt wird. Beispielsweise werden – wenn möglich – der Zustand einer Spielstandeingabe oder der Änderung eines Names nach dem Verarbeiten und Anwenden der Netzwerkänderung wiederhergestellt, und zwar so schnell, dass es der jeweilige Benutzer gar nicht merken dürfte.

Ein relevanter Unterschied ist aber, dass die Anmeldung explizit beendet werden muss („Netzwerk“ → „Anmeldung beenden“, vgl. auch Vergleich der eingegebenen Ergebnisse). Das ist deswegen nötig, damit nicht an einem Rechner bereits Ergebnisse eingegeben werden (ab dann muss die Anzahl der Anmeldungen konstant bleiben), und an einem anderen ohne Ergebnisse noch ein Paar/Spieler gelöscht werden kann.

Im Ein-Rechner-Betrieb können Ergebnisse eingegeben werden, sobald eine korrekte Anzahl von Paaren (durch zwei teilbar) oder Spielern (durch vier teilbar) angemeldet ist. Wurde das erste Ergebnis eingegeben, dann können Namen noch verändert werden, aber es können keine Paare/Spieler mehr angemeldet oder gelöscht werden.

Ist die Anmeldung beendet, können auch dann Paare/Spieler nicht mehr angemeldet oder gelöscht werden, wenn der letzte eingegebene Spielstand gelöscht wurde. Sollten nach dem Beenden der Anmeldung noch Änderungen an der Anmeldungsliste abgesehen vom Editieren eines Namens oder der Änderung einer Markierung nötig sein (also Hinzufügen oder Löschen), dann bitte den Server schließen und neu starten und alle Clients neu anmelden. Danach sind – vorausgesetzt es sind noch keine Ergebnisse eingegeben oder alle eingegebenen Ergebnisse sind gelöscht worden – wieder alle Änderungen an der Anmeldungsliste möglich.

2.12.1 Stoppuhr

Über „Extras“ → „Stoppuhr“ kann ein Countdown-Timer angezeigt werden. Diese Funktion ist sinnvoll, wenn mit einer Zeitbegrenzung gespielt wird (vgl. auch Abgebrochene Bobbl). Im Netzwerkbetrieb kann eine Client-Stoppuhr mit der des Servers synchronisiert werden, so dass alle dieselbe (Rest-)Zeit sehen.

2.12.2 Die Turnierdatenbank zurücksetzen

Über „Extras“ → „Datenbank zurücksetzen“ können alle eingegebenen Daten (Spieler und Ergebnisse) gelöscht werden. Das ist an sich nur für Testanwendungen, Debugging und Entwicklung gedacht.

Sollen auch die Einstellungen geändert werden (Punkte pro Bobbl, Bobbl pro Runde oder Turniermodus), dann kann einfach die bestehende Datenbank mit einer neuen überschrieben werden.

2.12.3 Backup der Datenbank anlegen und wiederherstellen

Per „Extras“ → „Backup der Datenbank anlegen“ kann ein Backup des aktuellen Datenbank-Stands erzeugt werden. Es wird eine Datei mit dem selben Namen wie die geöffnete Datenbank angelegt, der zusätzlich den Zeitpunkt der Erstellung des Backups enthält.

Das Format für den Dateinamen ist „Datenbank_Jahr-Monat-Tag_Stunde-Minute-Sekunde“ (somit werden alle Backups automatisch nach dem Erstellungszeitpunkt sortiert), also beispielsweise Muckturnier_2018-07-25_14-48-14.mtdb für die Datenbank Muckturnier.mtdb.

Der über „Extras“ → „Backup wiederherstellen“ erreichbare Dialog listet alle verfügbaren Backups auf. Wenn ein Backup wiederhergestellt wird, wird die Datenbank damit überschrieben und neu geöffnet.

Das Ganze geht natürlich auch „zu Fuß“ (wenn auch nicht so bequem): Es werden nur Dateien kopiert bzw. umbenannt. Um ein Backup manuell zu erzeugen, kann man auch die Turnierdatenbank schließen, eine Kopie davon machen und sie dann wieder öffnen. Analog funktioniert das Wiederherstellen eines Backups.

3.4.1 Auslosung bei der Anmeldung nutzen

Die Auslosung direkt bei der Anmeldung verursacht – je nach dem, wie die Parameter gewählt werden – deutlich weniger Arbeit und Durcheinander als die klassische Zettelauslosung. Weiterhin kann bereits in der 1. Runde die Paar- bzw. Spielerauswahl über die Tischnummer erfolgen, so dass sich das Heraussuchen der Paare bzw. Spieler erübrigt. Man bekommt damit mehr Überblick und hat weniger Arbeit.

3.4.2 Paare finden

Unabhängig vom Turniermodus ist zumindest die Eingabe der 1. Runde aufwändig, weil man die Paare auf jeden Fall heraussuchen muss (es sei denn, man nutzt die Auslosung direkt bei der Anmeldung, s. o.). Das Heraussuchen eines Paares aus der ganzen Liste ist mitunter langwierig, weil oft die Namen nicht in der „richtigen“ (also angemeldeten) Reihenfolge auf den Spielstandzetteln stehen und/oder unvollständig und/oder kaum lesbar sind.

Am besten benutzt man zum Auffinden des jeweiligen Paares die Suchfunktion in der Auswahlbox: Bereits das Eingeben der Anfangsbuchstaben der Nach- oder Vornamen schränkt die Auswahl sehr ein, bei jeweils zwei Buchstaben bleiben meistens nur doch zwei oder drei Möglichkeiten übrig. Es können auch Teile mitten aus einem Namen sein. Irgend ein Brocken bringt schon was :-)

Beispiel: Für das Paar „Meier Bernd / Müller Karl“ reicht es höchstwahrscheinlich aus, nach „me mü“ zu suchen. Groß- und Kleinschreibung müssen nicht „richtig“ eingegeben werden. Umlaute und Akzente können auch weggelassen oder ersetzt werden, so dass z. B. auch die Suche nach „me mu“ oder „me mue“ zum gewünschten Ergebnis führt. „André“ findet man auch bei der Suche nach „andre“. Die Reihenfolge der Suchbegriffe ist ebenfalls egal: „mü me“ funktioniert genauso wie „me mü“.

Weiterhin kann man optional noch, mit dem Ohr-und-Schall-Symbol, die phonetische Suche aktivieren, bei der nicht nach der eingegebenen Zeichenfolge, sondern nach deren Klang gesucht wird. Diese ist noch deutlich toleranter als die Standardsuche: Den Namen „Raithel“ findet man damit z. B. auch durch die Eingabe von „reidl“. Allerdings steigen durch die systembedingte Unschärfe auch die falsch-positiven (also angezeigte aber nicht gewollte/passende) Treffer an. Ob oder ob nicht die phonetische Such sinnvoll anzuwenden ist, muss man im Einzelfall einfach ausprobieren.

3.4.3 Punkte eingeben

Die Punkte kann man schnell (und ohne Tippfehler) über den Punkte-Dialog eingeben, wo man den jeweiligen Punktewert per Klick auswählen kann. Hierzu einfach den Bobbl oder das Eingabefeld mit der rechten Maustaste anklicken.

4.1.1 Kompilieren

Als Buildsystem kommt CMake (ab Version 3.8) zum Einsatz.

Sind alle Abhängigkeiten installiert, dann ist das Übersetzen des Programms aus den Quelltexten ziemlich einfach. Beispielsweise muss man im Quellcode-Ordner nur folgende Befehle ausführen:

mkdir build
cd build
cmake ..
make

Sofern die Python-Docutils gefunden werden, wird diese Dokumentation von reStructuredText via rst2html5.py in eine HTML-Datei konvertiert. Ist das nicht gewünscht oder möglich, dann kann das mittels des Schalters DOCUMENTATION ausgesetzt werden (cmake -DDOCUMENTATION=OFF ..).

Für andere Buildsysteme (z. B. Ninja, das verwende ich persönlich) oder Compiler (z. B. Clang) verweise ich an dieser Stelle auf die Dokumentation von CMake.

4.1.2 Installieren

Installieren kann man nach dem erfolgten Build mit

make install

Wird die CMAKE_INSTALL_PREFIX-Variable nicht gesetzt, wird in den /usr-Verzeichnisbaum installiert (die ausführbare Datei nach /usr/bin, Resourcen-Dateien nach /usr/share/muckturnier etc.).

Sind die xdg-utils installiert, dann werden die „Freedesktop Shared MIME Info“-Datei muckturnier.xml sowie die „Desktop Entry Specification“ Muckturnier.desktop in der xdg-Datenbank angemeldet, damit ein Startmenüeintrag für Muckturnier erstellt und die Dateierweiterung „.mtdb“ mit dem Muckturnier-Programm verknüpft wird.