README

Gibt die Datei einer Schachturnierverwaltung im Frontend aus. Das Inhaltselement liest die Datei bei jedem Seitenaufruf und stellt daraus die gewünschten Listen zusammen — von den Turnierdaten über Rangliste und Kreuztabelle bis zu den Wettkämpfen eines Mannschaftsturniers. Eine Datenbank für die Turnierdaten braucht es nicht: Die Turnierdatei liegt in der Dateiverwaltung, und mehr ist nicht zu pflegen.

Erstes unterstütztes Format ist SWT aus dem Programm Swiss-Chess. Weitere Formate lassen sich ergänzen, ohne dass Listen oder Templates angefasst werden müssen.

Läuft unter Contao 4.13 und Contao 5, mit PHP ab 8.1.

Installation

Über den Contao Manager nach schachbulle/contao-chesstournamentviewer-bundle suchen, oder auf der Kommandozeile:

composer require schachbulle/contao-chesstournamentviewer-bundle

Benutzung

Es gibt drei Inhaltselemente in der Gruppe Schach-Elemente:

Element	Zweck
Schachturnier-Betrachter – Turnierausgabe	Gibt eine Liste aus einer Turnierdatei aus
Schachturnier-Betrachter – Umschlag Anfang	Öffnet einen Umschlag; die folgenden Ausgaben erscheinen als Reiter
Schachturnier-Betrachter – Umschlag Ende	Schließt den Umschlag

Ein Element gibt genau eine Liste aus. Wer Teilnehmer, Rangliste und Kreuztabelle nebeneinander zeigen will, legt drei Turnierausgaben an und klammert sie mit den beiden Umschlag-Elementen ein — so, wie Contao es mit Akkordeon und Slider hält. Im Backend rückt Contao die eingeschlossenen Elemente ein, sodass zu sehen ist, was zusammengehört.

Eine Turnierausgabe anlegen

Die Maske baut sich in drei Schritten auf. Das ist Absicht: Was ausgegeben werden kann, steht in der Turnierdatei, und die kennt das Element erst, wenn sie gewählt und gespeichert ist.

Turnierdatei wählen. Mehr steht nicht in der Maske — alles Weitere hinge am Inhalt der Datei und wäre zu diesem Zeitpunkt geraten. Angeboten werden nur Dateien mit einer Endung, die ein registriertes Format kennt.
Speichern. Jetzt kommt Auszugebende Liste hinzu, ein Auswahlfeld mit dem, was diese Datei hergibt: Bei einem Einzelturnier fehlen die Mannschaftslisten, vor der ersten Runde die Kreuztabelle.
Liste wählen. Deren Einstellungen erscheinen sofort — das Auswahlfeld schickt die Maske ab. Welche das sind, hängt von der Liste ab:

Liste	Einstellungen
Teilnehmer, Rangliste	Spalten — siehe Spalten und Sortierung
Rangliste, Kreuztabelle, Fortschritt, Mannschaftstabelle, Kreuztabelle der Mannschaften	Stand nach Runde — siehe Zeitpunkt und Runden
Paarungen, Ergebnisse, Wettkämpfe	Angezeigte Runden
Mannschaften, Wettkämpfe	Spieler mit ausgeben
Kreuztabelle der Mannschaften	Kreuztabelle kürzen
alle	Hinweise zu den Zahlen anzeigen, sofern die Datei welche erzeugt

Das Feld Format der Turnierdatei steht ab Schritt 2 bereit. „Automatisch erkennen" ist der Regelfall; die Formate erkennen ihre Dateien am Inhalt, nicht an der Endung. Ein Format von Hand zu wählen hilft nur, wenn eine Datei nicht erkannt wird, obwohl sie dazugehört.

Steht die Dateiendung der Turnierformate nicht unter Einstellungen → Erlaubte Dateitypen, warnt das Inhaltselement: Ohne den Eintrag lässt sich gar keine Turnierdatei hochladen, und die Dateiauswahl bliebe ohne erkennbaren Grund leer.

Mehrere Ausgaben als Reiter

Zwischen Umschlag Anfang und Umschlag Ende gehören beliebig viele Turnierausgaben. Sie müssen nicht dieselbe Turnierdatei verwenden — ein Umschlag kann ebenso gut Vorrunde und Endrunde nebeneinanderstellen.

Die Beschriftung einer Reiterlasche ist die Überschrift der Turnierausgabe, und wenn dort nichts steht, der Name der Liste. Ein eigenes Feld dafür gibt es nicht.

Die Reiterleiste baut das Skript, nicht der Server: Das öffnende Element weiß beim Ausliefern nicht, was nach ihm kommt. Ohne JavaScript stehen die Ausgaben deshalb untereinander, jede vollständig lesbar — dieselbe Rückfallebene wie bisher.

Die Listen

Liste	Inhalt
Turnierdaten	Name, Ort, Zeitraum, Turnierform, Runden, Feinwertungen
Teilnehmer	Startliste mit Elo, DWZ, TWZ und Verein; bei Mannschaftsturnieren nach Mannschaften gegliedert
Rangliste	Endstand mit Bilanz, Punkten und Feinwertungen; bei Mannschaftsturnieren nach Mannschaften gegliedert
Kreuztabelle	Jeder gegen jeden, in Ranglistenreihenfolge
Fortschrittstabelle	Je Runde Ergebnis, Farbe und Gegner, darunter der Punktestand
Fortschritt ohne Punktestand	Dieselbe Tabelle, nur der Verlauf
Paarungen	Auslosung je Runde, ohne Ergebnisse; bei Mannschaftsturnieren nach Wettkämpfen gegliedert
Ergebnisse	Dieselben Partien mit Ergebnis
Mannschaften	Mannschaftsliste, auf Wunsch mit Aufstellung
Mannschaftstabelle	Wettkämpfe, Bilanz, Mannschafts- und Brettpunkte
Wettkämpfe	Die Begegnungen je Runde mit Wertungsschnitt, auf Wunsch mit Einzelpartien; die Bretter stehen nach Mannschaft ausgerichtet, die Farbe ist am Grund der Felder abzulesen
Kreuztabelle der Mannschaften	Die Wettkampfergebnisse als Kreuztabelle

Spalten und Sortierung

Für Teilnehmerliste und Rangliste lässt sich einstellen, welche Spalten erscheinen und in welcher Reihenfolge. Angeboten wird nur, was die gewählte Datei hergibt: Ein Turnier ohne Elo-Zahlen bietet keine Elo-Spalte an, ein Einzelturnier keine Brettspalte, eine Datei ohne Feinwertung keine Feinwertungsspalte.

Zur Wahl stehen — je nach Datei — Startnummer, Platz, Brett, Name, Titel, Elo, DWZ, Turnierwertungszahl, Verein, Land, Gruppe, Geburtsjahr, FIDE-Kennung, Bilanz, Partien, Punkte und die beiden Feinwertungen. Das Auswahlfeld lässt sich ziehen; die Reihenfolge ist die der Ausgabe. Ohne Auswahl erscheinen die Vorgabespalten.

Dieselbe Auswahl taugt für mehrere Turnierdateien: Was eine Datei nicht hergibt, wird übergangen. Bleibt nichts übrig, greift die Vorgabe.

Im Frontend ordnet ein Klick auf den Spaltenkopf die Tabelle, ein zweiter dreht die Richtung um. Punktestände wie „3½" und Bilanzen wie „5/2/1" werden nach ihrem Zahlenwert geordnet, nicht als Text; leere Felder stehen in beiden Richtungen am Ende. Ohne JavaScript steht die Tabelle in der Reihenfolge der Turnierdatei.

Nach Mannschaften gegliederte Tabellen lassen sich nicht sortieren — die Kopfzeilen der Mannschaften rutschten sonst zwischen die Spieler.

Zeitpunkt und Runden

Je nach Liste steht eines von zwei Feldern in der Maske. Sie tun Verschiedenes:

Stand nach Runde — bei Rangliste, Kreuztabelle, Fortschrittstabelle und den Mannschaftstabellen. Es ist ein Schnitt durch das ganze Turnier: Alles, was danach gespielt wurde, ist weg — nicht ausgeblendet, sondern entfernt. Über der Ausgabe steht dann „Stand nach Runde 4", damit niemand einen Zwischenstand für die Endtabelle hält.

„Aktueller Stand (letzte Runde)" ist die Vorgabe. Sie nimmt die gespeicherten Zahlen der Turnierdatei — die des jeweils letzten Standes — und rechnet nichts nach. Genau das will man im Regelfall: Lädt jemand eine neue Fassung der Datei hoch, wächst die Ausgabe von selbst mit.

Angezeigte Runden — bei Paarungen, Ergebnissen und Wettkämpfen. Beschränkt die Ausgabe auf einzelne Runden; ohne Auswahl erscheinen alle. Die Rundennummern kommen aus der Datei: Ein Turnier über fünf Runden bietet fünf Kästchen an.

Woher die Zahlen eines Zwischenstands kommen

Die Turnierdatei speichert Punkte und Feinwertungen nur für den Endstand. Ein Zwischenstand muss deshalb gerechnet werden, und zwar aus den Partien. Für die Punkte ist das eindeutig. Für die Feinwertungen nicht: Ob eine spielfreie Runde mitzählt, mit welchem Wert ein Gegner eingeht, der selbst ausgesetzt hat, und ob der schlechteste Wert gestrichen wird, sind Turniereinstellungen, die in der Datei an keiner bekannten Stelle stehen.

Geraten wird deshalb nicht. Der Betrachter rechnet zuerst den Endstand nach und vergleicht ihn mit dem, was in der Datei steht. Nur die Regelfassung, die dabei jeden einzelnen Wert trifft, wird auf den Zwischenstand angewandt. Findet sich keine, bleibt die Spalte leer und ein Hinweis nennt den Grund — eine Zahl, die neben der amtlichen Tabelle steht und ihr widerspricht, wäre schlimmer als keine.

Nachrechenbar sind Buchholzwertung, Buchholzsumme, mittlere Buchholz, Sonneborn-Berger und Summenwertung. Wertungen, die auf Wertungszahlen beruhen — Gegner-Elo-Mittel, Rating-Leistung —, fehlen im Zwischenstand immer.

Ebenfalls nicht im Zwischenstand: Sonderpunkte. Die Datei nennt nur ihre Summe, nicht die Runde, in der sie vergeben wurden.

Reiternavigation

Ab zwei Turnierausgaben in einem Umschlag entsteht eine Reiterleiste; mit Pfeiltasten lässt sich zwischen den Reitern wechseln. Ohne JavaScript stehen alle Ausgaben untereinander und bleiben vollständig lesbar — der Server liefert sie alle sichtbar aus, und erst das Skript blendet aus, was hinter den Reitern liegt. Bei einer einzigen Ausgabe entfällt die Leiste.

Anpassen der Ausgabe

Alle Listen sind eigene Contao-Templates und lassen sich einzeln überschreiben:

Template	Liste
`ce_chesstournamentviewer`	Rahmen einer Turnierausgabe, mit Hinweisen
`ce_chesstournamentviewerStart`	Öffnender Umschlag mit der Reiterleiste
`ce_chesstournamentviewerStop`	Schließender Umschlag
`ctv_spaltenkopf`	Ein Spaltenkopf von Teilnehmerliste und Rangliste
`ctv_spaltenzeile`	Eine Zeile von Teilnehmerliste und Rangliste, mit den gewählten Spalten
`ctv_turnierdaten`	Turnierdaten
`ctv_teilnehmer`	Teilnehmer
`ctv_rangliste`	Rangliste
`ctv_kreuztabelle`	Kreuztabelle
`ctv_fortschritt`	Fortschrittstabelle — und über einen Verweis auch die Fassung ohne Punktestand
`ctv_fortschrittohne`	Fortschritt ohne Punktestand
`ctv_paarungen`	Paarungen — und über einen Verweis auch die Ergebnisse
`ctv_ergebnisse`	Ergebnisse
`ctv_partiezeile`	Eine Partiezeile der Paarungs- und Ergebnisliste, nach Farbe ausgerichtet
`ctv_wettkampfzeile`	Eine Brettzeile im Wettkampf, nach Mannschaft ausgerichtet
`ctv_spaltenkopf`	Ein Spaltenkopf von Teilnehmerliste und Rangliste
`ctv_spaltenzeile`	Eine Zeile von Teilnehmerliste und Rangliste, mit den gewählten Spalten
`ctv_mannschaften`	Mannschaften
`ctv_mannschaftsrangliste`	Mannschaftstabelle
`ctv_mannschaftspaarungen`	Wettkämpfe
`ctv_mannschaftskreuztabelle`	Kreuztabelle der Mannschaften

Für die Formatierung steht in den Templates die Klasse Schachbulle\ContaoChesstournamentviewerBundle\Liste\Ausgabe bereit: punkte() schreibt halbe Punkte als ½, esc() maskiert Werte aus der Turnierdatei, spalte() holt eine Spaltenbeschriftung aus der Sprachdatei, zelle() gibt den Inhalt einer wählbaren Spalte aus.

Welche Spalten es gibt und welche eine Datei füllen kann, steht in Schachbulle\ContaoChesstournamentviewerBundle\Liste\Spalten. Eine neue Spalte braucht dort einen Eintrag, einen Zweig in Ausgabe::zelle() und eine Beschriftung in den Sprachdateien.

Farben und Abstände kommen aus betrachter.css. Alle Farben stehen als CSS-Eigenschaften am Element .ctv und lassen sich im eigenen Theme überschreiben, ohne die Datei zu ersetzen:

.ctv {
    --ctv-grund: #fff;            /* Grund des aktiven Reiters */
    --ctv-text: #1c1c1c;          /* Schrift in Reitern und Tabellen */
    --ctv-linie: #d5d5d5;         /* Tabellen- und Reiterlinien */
    --ctv-kopf: #eceef0;          /* Tabellenkopf, Blindfelder */
    --ctv-wechsel: #f6f7f8;       /* jede zweite Zeile, ruhende Reiter */
    --ctv-gedaempft: #6b6b6b;     /* Nebenangaben wie Farbe und Punktestand */
    --ctv-akzent: #1c5a8c;        /* Balken über dem aktiven Reiter */
    --ctv-blind: #c9ced3;         /* Blindfelder der Kreuztabelle */
    --ctv-blind-figur: #6b7379;   /* der König darin */
    --ctv-weiss: #fff;            /* Feld des Weißspielers im Wettkampf */
    --ctv-schwarz: #e2e5e8;       /* Feld des Schwarzspielers */
}

Auf einer dunklen Seite sind mindestens --ctv-grund, --ctv-text und --ctv-wechsel zu setzen: Die Reiter bringen ihre Farben ausdrücklich mit, statt sie vom Theme zu erben — sonst stünde je nach Theme dunkle Schrift auf dunklem Grund.

Was der Betrachter über die Zahlen sagt

Über den Tabellen können Hinweise stehen. Sie sind kein Fehler, sondern Selbstkontrolle: Die Punktzahlen stehen in einer SWT-Datei zweimal — einmal auf den Karteikarten der Teilnehmer, einmal als Ergebnisse in den Paarungen. Gehen beide auseinander, sagt der Betrachter das, statt es zu verschweigen. Häufigster Fall ist eine Rangliste, die noch nicht neu berechnet wurde, nachdem die letzte Runde eingegeben war.

Mannschaftswertung

Der Ausgang eines Mannschaftskampfes steht nicht in der SWT-Datei: Die Paarungssätze der Mannschaften führen Spielort, Gegner und Tischnummer, aber kein Ergebnis. Swiss-Chess rechnet den Kampf jedes Mal aus den Einzelpartien zurück, und der SWT-Leser dieses Bundles tut dasselbe — Brettpunkte aus den Ergebnissen aller Spieler einer Mannschaft in einer Runde, Mannschaftspunkte aus dem Vergleich mit dem Gegner, mit zwei oder drei Punkten für den Sieg je nach Turniereinstellung.

Der Nachweis gegen die Ausgaben von Swiss-Chess selbst:

Vergleich	Umfang	Abweichungen
Mannschaftstabelle Blitz-MM 2012 (Platz, S/R/N, MP, BP)	28 Mannschaften	0
Mannschaftstabelle Betriebs-MM 2012 (Platz, Name, S/R/N, MP, BP)	38 Mannschaften	0
Kreuztabelle der Mannschaften Blitz-MM 2012	784 Felder	0

Freilose bleiben unbewertet. Zu einer spielfreien Runde steht in der Datei nichts als das Fehlen eines Gegners. Ob die Turnierleitung dafür einen kampflosen Sieg gutgeschrieben hat, ist daraus nicht zu erkennen — manche tun es, manche nicht. Weicht die hier gezeigte Tabelle deshalb von der in der Datei gespeicherten ab, steht darüber ein Hinweis.

Die Spalte Ø TWZ ist eine eigene Zahl und nicht die von Swiss-Chess: Gemittelt wird über alle gemeldeten Spieler einer Mannschaft, also über genau den Kreis, den die Mannschaftsliste mit eingeschalteter Aufstellung darunter zeigt. Nach welcher Regel Swiss-Chess seine TWZ-Spalte bildet, ließ sich an den vorliegenden Ausgaben nicht bestimmen; die Einzelheiten stehen im Klassenkommentar von Mannschaftswertung::wertungsschnitt().

Unterstützte Turnierformate

Format	Endungen	Umfang
SWT (Swiss-Chess)	`swt`	Vollständig: Teilnehmer, Ergebnisse, Rangliste, Feinwertungen, Mannschaftswertung
Swiss-Manager	`tun`, `tunx`, `tur`, `turx`, `tum`, `tumx`, `tut`, `tutx`	Teilnehmer, Ergebnisse, Mannschaften und Wettkämpfe. Ohne Feinwertungen — siehe unten

Bei Swiss-Manager stehen Punkte, Platzierungen und Feinwertungen nicht in der Datei; das Programm rechnet sie bei jeder Anzeige neu. Der Betrachter tut dasselbe, und zwar für die Punkte vollständig. Bei den Feinwertungen geht das nicht: In der Datei steht nicht, welche das Turnier führt. Punktgleiche Teilnehmer teilen sich deshalb den Platz, und die Feinwertungsspalten entfallen. Ein Hinweis über der Tabelle sagt das.

Ab 250 Teilnehmern entfällt außerdem die Kreuztabelle — bei den 1031 Teilnehmern einer Schacholympiade hätte sie über eine Million Felder.

Der Aufbau des Swiss-Manager-Formats ist in SWISS-MANAGER.md beschrieben.

Weitere Turnierformate

Ein neues Format braucht eine Klasse, die Schachbulle\ContaoChesstournamentviewerBundle\Format\TurnierFormatInterface umsetzt, und einen Eintrag in der services.yaml des eigenen Bundles. Den Dienst-Tag setzt die Autokonfiguration; Verzeichnis, Dateiauswahl und Formatauswahl im Backend füllen sich daraufhin von allein.

Die Klasse liefert ein Turnier — ein reines Datenobjekt mit Teilnehmern, Mannschaften, Paarungen, Rangliste und Runden. Zwei Festlegungen sind dabei bindend, weil die Listen darauf bauen: Teilnehmer sind nach Teilnehmernummer indiziert, Mannschaften lückenlos ab 1 nach Mannschaftsnummer.

Prüfstand

Im Verzeichnis tests/ liegen Testfälle, die ohne Contao und ohne Turnierdateien auskommen:

vendor/bin/phpunit

Geprüft werden die Rückrechnung der Mannschaftswertung, die Fortschrittstabelle, die Formaterkennung, das Listenverzeichnis, der Rundenschnitt samt Kalibrierung der Feinwertungen und das Kürzen der Eingabemaske.

Lizenz

LGPL-3.0-or-later. Die Klasse SwtFile ist vom SWT-Parser des Zugzwang-Projekts abgeleitet (http://www.zugzwang.org/projects/swtparser), Copyright © 2005, 2012 Gustaf Mossakowski, Jacob Roggon, Falco Nogatz, und steht unter derselben Lizenz.

schachbulle / contao-chesstournamentviewer-bundle

Maintainers

Package info

Statistics

Security