Das Programm borep kann zum Einpflegen der Datenbankdaten oder zur Erstellung einer statischen Webseite verwendet werden.
Format der Eingabedatei
Die zuverarbeitenden Daten werden dem Programm als Textdatei übergeben. Jede Zeile der Datei beschreibt eine Runde eines Spieler. Die Zeile beginnt jeweils mit dem Namen des Spielers, es gefolgen die einzelnen Frames der Runde. Hierbei wird ein Strike mittels x , ein Spare mittels / und eine Ratte mittels - angegeben. Die Gliederung der Datei ist wie folgt:
Beispiele sind in dem Verzeichnis examples zu finden.
Prüfen der Eingabedatei
Da das Erstellen der Eingabedatei meist ein manueller Prozess ist, kurz Entippen, kann mittels borep eine Überprüfung der Datei vorgenommen werden. Der Aufruf kann wie folgt aussehen:
> ./csrc/borep -T example/04-02-25.txt
Player (league 1): ost
Round: 1, sum: 106, kumulus: 106
Round: 2, sum: 164, kumulus: 270
Round: 3, sum: 159, kumulus: 429
Round: 4, sum: 134, kumulus: 563
strikes: 10, spares 1
best: 164, worst 10
<snip>
Ist die Eingabedatei syntaktisch fehlerfrei, gibt das Programm eine textuelle Zusammenfassung aus.
Achtung! Auch syntaktisch korrekte Dateien können inhaltlich falsch sein, eine manuelle Überprüfung ist in jedem Fall sinnvoll.
Erzeugen der HTML-Seite
Das Programm borep erstellt aus der Eingabedatei eine Verzeichnis mit drei statischen HTML-Seiten. Hierzu ist das Programm wie folgt aufzurufen:
> borep -n examples/navi_table.html -H examples/04-02-25.txt
Das Programm erzeugt in dem aktuellen Verzeichnis ein Unterverzeichnis mit dem Namen der Datei ohne Erweiterung. In diesem Verzeichnis befinden sich die statischen HTML-Dateien:
zusammenfassung.html | Gesamtergebnisse, die Anzahl der Spares und Strikes sowie die jeweils besten Runden des Spieltages |
1-liga.html | Rundenübersicht der 1. Liga und |
2-liga.html | Rundenübersicht der 2. Liga. |
Die Angabe einer Navigationleiste mittels -n ist optional. Der Inhalt der Datei wird in die Dateien eingebettet und dient dem Einbinden einer eigenen Navigationsleiste.
Datenbank aktualisieren
Neben dem Erzeugen der statischen HTML-Seite kann das Programm borep zum Aktualisieren der Datenbank verwendet werden. Hierzu ist das Programm wie folgt aufzurufen:
> borep -M examples/mysql.conf examples/04-02-25.txt
Die Zugangsdaten zur Datenbank werden dem Programm mit dem Parameter -M als Datei übergeben. In der Datei müssen die Parameter aus der Initialisierung der Datenbank angegeben werden. Die Angaben werden über die folgenden Schlüsselwörter spezifiziert:
server | MYSQL-Datenbank Rechnername / IP-Adresse, |
user | Nutzername, |
db | Datenbankname und |
pwd | Passwort. |
Für das Aktualisieren der Datenbank muss das zuvor angelegte Admin-Profil verwendet werden. Vor dem Aufruf sollte zudem kontrolliert werden, dass die Daten der Eingabedatei korrekt sind. Ein nachträgliches Korregieren bzw. Überschreiben ist aber auch mittels des Programmparameters -r möglich.
|