Konfiguration

Konfiguration

Globale Plugin-Einstellungen

Die globalen Plugin-Einstellungen werden über Extras → Optionen → PétTurnMngr → Plugin Konfiguration bearbeitet. Gespeichert wird primär in der LibreOffice-Benutzerkonfiguration (also im LO-Benutzerprofil, nicht mehr in einer eigenen Textdatei). Nur wenn die LibreOffice-Konfiguration ausnahmsweise nicht verfügbar ist, weicht PTM auf eine Legacy-Datei PetanqueTurnierManager.properties im Home-Verzeichnis des Benutzers aus. Beim ersten Start nach einem Update wird ein bereits vorhandener Altbestand aus dieser Datei einmalig automatisch in die LibreOffice-Konfiguration übernommen; die Datei selbst muss nicht manuell gepflegt werden.

Die Optionsseite bietet folgende Einstellungen (in der Reihenfolge, in der sie im Dialog erscheinen):

Option	Typ	Standard	Beschreibung
Autosave nach jeder Aktion	Boolean	Aus	Speichert das Dokument automatisch nach jeder PTM-Aktion (z. B. neue Spielrunde erzeugen, Rangliste aktualisieren)
Backup vor wichtigen Generierungen	Boolean	Aus	Legt vor wichtigen Generierungsschritten automatisch eine Sicherungskopie des Dokuments an
Beim Start auf neue Version prüfen und Dialog anzeigen	Boolean	An	Prüft nach dem Öffnen von LibreOffice einmal pro Sitzung im Hintergrund auf eine neue PTM-Version und zeigt bei Verfügbarkeit automatisch den Update-Dialog an (Optionen: direkt aktualisieren oder „nicht mehr für diese Version" anzeigen)
ProzessBox automatisch anzeigen	Boolean	An	Öffnet das Protokoll-/Fortschrittsfenster (ProcessBox) automatisch bei länger laufenden PTM-Aktionen
ProzessBox nach Erfolg automatisch schließen	Boolean	An	Schließt die ProcessBox nach erfolgreichem Abschluss einer Aktion automatisch wieder. Wirkt nur, solange „ProzessBox automatisch anzeigen" ebenfalls aktiv ist
Performance-/Zeitmessungen loggen	Boolean	Aus	Protokolliert Zeitmessungen einzelner interner Abläufe (z. B. Generierungsschritte) im Logfile – nützlich zur Performance-Diagnose, erzeugt aber deutlich mehr Log-Ausgabe
Log-Level	Auswahl	leer (= info)	Protokollierungstiefe der Anwendung: leer, error, warn, info, debug oder trace. Eine leere Auswahl entspricht info

Entfernte Dev-Option „Neue Version immer aktiv"

Die frühere Checkbox „Neue-Version-Prüfung immer aktiv (Entwicklungsmodus)" wurde aus der Optionsseite entfernt, da sie ausschließlich für die PTM-Entwicklung gedacht war und im normalen Betrieb nicht benötigt wird. Die zugrunde liegende Funktion besteht im Code weiterhin, ist aber nicht mehr über die Options-UI erreichbar. Wer sie dennoch benötigt (z. B. um den Update-Dialog testweise auch ohne tatsächlich neues Release anzuzeigen), kann LibreOffice mit folgender JVM-System-Property starten:

-Dde.petanqueturniermanager.newVersionCheck=true

---

Ebenen der Konfiguration

PTM unterscheidet drei Arten von Einstellungen:

Ebene	Speicherort	Gilt für	Typische Beispiele
Globale Plugin-Einstellungen	LibreOffice-Benutzerkonfiguration (Legacy-Fallback: PetanqueTurnierManager.properties im Home-Verzeichnis)	Alle PTM-Dokumente dieses Benutzers	Backup, Autosave, Log-Level
Turnier-Konfiguration	Konfigurationsblatt im aktuellen Calc-Dokument	Nur das geöffnete Turnier	Formation, Rundenzahl, Spielbahnspalte, Farben
Dokumenteigenschaften	LibreOffice UserDefinedProperties	Internes Speichern von Statuswerten	Aktives Turniersystem, aktuelle Runde, aktuelle Spieltage

Die Turnier-Konfiguration wird beim Anlegen eines Turniers automatisch erstellt. Änderungen im Konfigurationsblatt gelten für spätere Generatorläufe; bereits erzeugte Spielrunden oder Spielpläne werden dadurch nicht automatisch neu aufgebaut.

Konfigurationsmenü

Das Konfigurationsmenü ist über PétTurnMngr → Konfiguration erreichbar:

Menüpunkt	Beschreibung
Turnier	Turnierspezifische Optionen (je nach Turniersystem)
Kopf-/Fußzeilen	Kopf- und Fußzeilentexte konfigurieren
Farben	Hintergrundfarben der Tabellen anpassen
Turnier Startseite	Logo, Turniername und Live-Teilnehmerzahl der Turnier-Startseite konfigurieren
Update Dokument Plugin-Version	Versionsstempel im Dokument aktualisieren

Bedienung

1. Ein PTM-Turnier öffnen oder neu anlegen.
2. PétTurnMngr → Konfiguration → Turnier öffnen.
3. Gewünschte Werte ändern. Auswahlfelder sollten nur mit den angebotenen Werten belegt werden.
4. Konfigurationsblatt verlassen und die betroffene Aktion erneut ausführen, z. B. Meldeliste aktualisieren, neue Spielrunde erzeugen oder Rangliste neu berechnen.
5. Bei Layoutänderungen wie Farben oder Kopf-/Fußzeilen kann es nötig sein, das jeweilige Sheet neu zu erzeugen oder zu aktualisieren.

Statuswerte wie „aktuelle Runde" oder „aktive Kaskadenrunde" sollten nur manuell geändert werden, wenn ein beschädigtes Dokument repariert wird.

---

Allgemeine Optionen (alle Turniersysteme)

Diese Optionen werden von den meisten implementierten Turniersystemen geerbt. Einzelne Systeme können zusätzliche Optionen haben oder einzelne Optionen nicht nutzen.

Farben

Option	Beschreibung
Meldeliste Hintergrund Gerade	Hintergrundfarbe der geraden Datenzeilen in der Meldeliste
Meldeliste Hintergrund Ungerade	Hintergrundfarbe der ungeraden Datenzeilen in der Meldeliste
Meldeliste Header	Hintergrundfarbe der Kopfzeile in der Meldeliste
Rangliste Hintergrund Gerade	Hintergrundfarbe der geraden Zeilen in der Rangliste
Rangliste Hintergrund Ungerade	Hintergrundfarbe der ungeraden Zeilen in der Rangliste
Rangliste Header	Hintergrundfarbe der Kopfzeile in der Rangliste
Spielrunde Hintergrund Gerade	Hintergrundfarbe der geraden Zeilen in der Spielrunde
Spielrunde Hintergrund Ungerade	Hintergrundfarbe der ungeraden Zeilen in der Spielrunde
Spielrunde Header	Hintergrundfarbe der Kopfzeile in der Spielrunde
Tab-Farbe Meldeliste	Farbe des Tabellenreiters der Meldeliste
Tab-Farbe Teilnehmer	Farbe des Tabellenreiters der Teilnehmerliste
Tab-Farbe Spielrunde	Farbe der Spielrunden-/Spielplan-Tabellen
Tab-Farbe Rangliste	Farbe der Ranglisten-Tabellen
Tab-Farbe Direktvergleich	Farbe der Direktvergleichs-Tabelle

Kopf- und Fußzeilen

Option	Typ	Beschreibung
Kopfzeile Links	Text	Linker Kopfzeilentext für systembezogene Ausdrucke
Kopfzeile Mitte	Text	Mittlerer Kopfzeilentext für systembezogene Ausdrucke
Kopfzeile Rechts	Text	Rechter Kopfzeilentext für systembezogene Ausdrucke
Fußzeile links	Text	Linker Fußzeilentext auf allgemeinen Blättern
Fußzeile mitte	Text	Mittlerer Fußzeilentext auf allgemeinen Blättern

Meldelisten und Teilnehmerlisten

Option	Typ	Beschreibung
Meldeliste Formation	Auswahl	Teamgröße: TETE, DOUBLETTE oder TRIPLETTE
Meldeliste Teamname	J/N	Teamnamen in der Meldeliste anzeigen
Meldeliste Vereinsname	J/N	Vereins-/Clubspalten in der Meldeliste anzeigen
Check-in-Liste Sortierung	Auswahl	Sortierung nach Nummer, Name oder Teamname
Teilnehmerliste Sortierung	Auswahl	Sortierung nach Nummer, Name oder Teamname
Anz. Teilnehmer in Spalte	Integer	Maximale Anzahl Teilnehmer pro Spalte in Teilnehmer-/Check-in-Listen

Export-Optionen

Diese Optionen steuern, welche Inhalte beim Export über PétTurnMngr → Export → „Export in Verzeichnis" bzw. „FTP/SFTP hochladen" zusätzlich mit übernommen werden (je nach Turniersystem sind nicht alle Optionen verfügbar):

Option	Typ	Standard	Beschreibung
Spielrunden exportieren	Boolean	Nein	Nimmt zusätzlich die Spielrunden-/Paarungs-Sheets in den Export auf (relevant bei Systemen, deren Export standardmäßig nur die Rangliste enthält, z. B. Schweizer, Formule X, Poule, Supermêlée)
Teilnehmerliste exportieren	Boolean	Nein	Nimmt die Teilnehmerliste zusätzlich in den Export auf
Abschluss-Sheet exportieren	Boolean	Nein	Hängt ein frei gestaltbares, eigenes Tabellenblatt (inkl. Bildern/Formen) als letzten Abschnitt an den Export an – z. B. für Dank an Sponsoren oder ein Abschlussfoto
Name des Abschluss-Sheets	Text	(leer)	Name des Tabellenblatts, das als Abschluss-Sheet exportiert werden soll

Weitere Optionen

Option	Typ	Beschreibung
Zeige Arbeitsspalten	Boolean	Interne Hilfsspalten einblenden (für Debugging)
Editierbare Felder hervorheben	Boolean	Eingabefelder farblich markieren

Turnierspezifische Optionen

Die vollständigen Einstelltabellen stehen auf den jeweiligen Systemseiten:

System	Dokumentation
Supermêlée	Supermelee
Liga	Liga
Jeder gegen Jeden	Jeder-gegen-Jeden
Schweizer System	Schweizer-System
K.-O.-System	KO-System
Maastrichter System	Maastrichter-System
Poule-A/B	Poule-AB
Kaskaden-K.O.	Kaskaden-KO
Formule X	Formule-X
Trip-Tête	Trip-Tete

---

Extra-Menü

Das Menü ist über PétTurnMngr → Extra erreichbar:

Menüpunkt	Beschreibung
Release-Infos	Versionsinformationen und Änderungsprotokoll anzeigen
Plugin herunterladen	Neue Version vom GitHub herunterladen
Neueste Version direkt installieren	Plugin direkt aktualisieren (ohne Browser)
Logfile anzeigen	Logdatei in einem Textfenster anzeigen
Protokoll-Fenster anzeigen	Prozessausgabe-Fenster (ProcessBox) öffnen
Projektseite im Browser öffnen	GitHub-Projektseite öffnen
Fehler melden	GitHub-Issue-Seite öffnen

Die globalen Plugin-Einstellungen werden nicht über dieses Menü, sondern über die LibreOffice-Optionsseite Extras → Optionen → PétTurnMngr → Plugin Konfiguration bearbeitet (siehe Globale Plugin-Einstellungen oben bzw. Optionsseiten unten).

---

Export, KI und Siegergeld

Weitere Menüpunkte direkt unter PétTurnMngr:

Menüpunkt	Beschreibung
Export → Export in Verzeichnis	Aktives Turniersystem als HTML/PDF in ein Verzeichnis exportieren
Export → FTP/SFTP hochladen	Export zusätzlich per FTP/SFTP hochladen – Zielserver siehe FTP-Server
KI → Neues Turnier mit KI erstellen	Turnier per KI-Assistent anlegen – siehe KI-Assistent
KI → Für Gemini Notebook exportieren	Turnierdaten für NotebookLM/Gemini exportieren – siehe KI-Assistent
Siegergeld berechnen	Siegergeld-Verteilung berechnen – ausführlich siehe Siegergeld

Optionsseiten (Extras → Optionen → PétTurnMngr)

Zusätzlich zu den Plugin-Menüs gibt es LibreOffice-Optionsseiten unter Extras → Optionen → PétTurnMngr:

Optionsseite	Beschreibung
Plugin Konfiguration	Globale Plugin-Einstellungen (Autosave, Backup, Update-Prüfung, ProcessBox, Performance-Logging, Log-Level) – siehe Globale Plugin-Einstellungen oben
Webserver-Regie	Aktiviert die Webserver-Regie und legt deren festen Port fest – ausführlich siehe Webserver-Regie
Composite Views	Zusammengesetzte Web-Ansichten (mehrere Panels pro Seite) konfigurieren – ausführlich siehe Composite-Views
FTP-Server	FTP/SFTP-Zielserver für den Export konfigurieren – ausführlich siehe FTP-Server
Tab-Farben	Farben der Tabellenreiter konfigurieren (dieselben Farben wie in den Konfigurationsblatt-Optionen der einzelnen Turniersysteme, hier zentral für alle Reiter einstellbar)
KI-Assistent	Anbieter, API-Key und Modell für den KI-Assistenten konfigurieren – ausführlich siehe KI-Assistent

---

Verarbeitung abbrechen

Über PétTurnMngr → Verarbeitung abbrechen kann eine laufende Operation unterbrochen werden. Dieser Menüpunkt ist nur während einer aktiven Operation verfügbar.