Quiz · Hilfe & Anleitung

1Schnellstart

1. In der Bedienleiste (oben bzw. über das Zahnrad ⚙ am Handy) eine Quelle wählen – für den Anfang Lokal.
2. Einen Modus festlegen: Duo (Richtig/Falsch) oder Quattro (vier Antworten).
3. Ein Thema, den Level und die Anzahl der Fragen auswählen.
4. Auf Starten tippen – die Fragen werden zufällig gemischt.
5. Antwort antippen. Die App zeigt sofort, ob sie richtig war, und zählt den Punktestand hoch.
6. Am Ende siehst du dein Ergebnis in Prozent. Neu starten spielt eine neue, frisch gemischte Runde.

2Die Bedienleiste

Die Bedienleiste enthält alle Einstellungen. Am Desktop ist sie dauerhaft sichtbar, am Handy blendest du sie mit dem Zahnrad ⚙ ein und aus.

3Das Spielfeld

Während des Spiels zeigt die Oberfläche folgende Elemente:

• Punktestand (Pille oben rechts): Anzahl richtiger Antworten – im Online-Modus stattdessen die erspielten Punkte.
• Fortschrittsbalken: zeigt „Frage X / Y“ und wie weit die Runde ist.
• Fragefeld: die aktuelle Aussage (Duo) bzw. Frage (Quattro), oben mit einem Etikett wie „Frage 3“.
• Antwort-Schaltflächen: bei Duo zwei, bei Quattro vier.
• Rückmeldungszeile: Text und Symbol, das „Richtig!“ oder „Falsch!“ meldet.

Farben & Rückmeldung

Nach dem Antippen reagiert die App sofort visuell:

• ✓ Richtig  Deine korrekte Wahl pulsiert grün, die anderen werden abgedunkelt.
• × Falsch  Eine falsche Wahl wackelt rot – zusätzlich wird die tatsächlich richtige Antwort hervorgehoben.

Nach kurzer Zeit erscheint automatisch die nächste Frage. Die Antwort-Schaltflächen sind während der Auflösung gesperrt, damit keine Doppel-Eingabe passiert.

4Modi: Duo & Quattro

Duo – Richtig oder Falsch

Es erscheint eine Aussage. Du entscheidest mit ✓ Richtig oder × Falsch, ob sie zutrifft. Duo-Kataloge heißen td_[thema].htm (td = true/duo).

Quattro – eine von vier

Es erscheint eine Frage mit vier Antwortmöglichkeiten A B C D. Genau eine ist richtig. Quattro-Kataloge heißen tq_[thema].htm (tq = true/quattro).

5Quellen im Detail

Lokal – die eigenen Kataloge

Die Fragen stammen aus den Katalogdateien im Quiz-Ordner (deutschsprachig, redaktionell gepflegt). Dies ist die Standardquelle und funktioniert ohne Internet.

Open Trivia DB – weltweite Fragen

Zieht Fragen live von opentdb.com. Statt eines Themas wählst du eine Kategorie. Level und Anzahl werden an die Datenbank weitergereicht (maximal 50 Fragen pro Runde). Die Fragen sind englischsprachig; die Sprachausgabe stellt dafür automatisch auf Englisch um.

Online – gegeneinander spielen

Mehrere Personen beantworten dieselben Fragen gleichzeitig und treten in einer Rangliste gegeneinander an. Ausführlich im nächsten Abschnitt.

6Online gegeneinander spielen

Im Online-Modus eröffnet eine Person einen Raum (Host), die anderen treten mit einem Raumcode bei. Der Host bestimmt Thema, Level und Fragenanzahl.

Als Host einen Raum eröffnen

1. Quelle auf Online stellen, gewünschtes Thema wählen.
2. Im Fenster „Raum erstellen“ wählen, Namen eingeben und bestätigen.
3. Der 6-stellige Raumcode erscheint – gib ihn den Mitspielern weiter.
4. Sobald alle in der Spielerliste stehen, auf „Spiel starten“ tippen.

Als Gast beitreten

1. Quelle auf Online stellen, „Raum beitreten“ wählen.
2. Raumcode und deinen Namen eingeben, bestätigen – du landest im Warteraum, bis der Host startet.

Ablauf & Punkte

• Jede Frage hat einen Countdown (Zeitbalken oben). Wer schneller richtig antwortet, bekommt mehr Punkte.
• 1.000 Punkte Basis pro richtiger Antwort plus bis zu 500 Punkte Schnelligkeitsbonus.
• Nach jeder Frage siehst du den Zwischenstand aller Mitspieler.
• Am Ende zeigt die Rangliste die Platzierung (🥇 🥈 🥉). Mit „Nochmal“ geht es in eine neue Runde, „Verlassen“ beendet den Raum.

7Audio & Sprachausgabe

Die Sprachausgabe nutzt die im Gerät/Browser vorhandenen Stimmen. Bei der Open Trivia DB werden die englischen Fragen automatisch auf Englisch vorgelesen.

8Bedienung am Handy

• Die Bedienleiste ist am Handy eingeklappt. Mit dem Zahnrad ⚙ oben öffnest du sie.
• Nach der Auswahl tippst du auf „Übernehmen“; die Leiste schließt sich und das Spielfeld rückt in den Blick.
• Auf schmalen Bildschirmen stehen die Antworten untereinander statt nebeneinander.

9Neue Themen anlegen

Ein Thema ist eine einzelne HTML-Datei im Quiz-Ordner. Die App durchsucht den Ordner beim Start, erkennt alle passenden Dateien am Namensmuster und baut daraus die Themenliste – du musst nichts weiter registrieren.

Der Anzeigename in der App entsteht automatisch aus dem Dateinamen: Präfix und Endung entfallen, Binde-/Unterstriche werden zu Leerzeichen, Wörter groß geschrieben (td_alte_geschichte.htm → „Alte Geschichte“). Verwende im Dateinamen nur Kleinbuchstaben ohne Umlaute (z. B. ae statt ä).

Aufbau einer Datei

Jede Katalogdatei enthält genau ein <div id="question_data"> mit einer JSON-Liste von Fragen. Mehr braucht die Datei nicht.

Duo-Katalog (Richtig/Falsch)

<div id="question_data">
[
  {
    "aussage": "Der Mount Everest ist der höchste Berg der Erde.",
    "antwort": true,
    "grad": "leicht"
  },
  {
    "aussage": "Die Donau fließt durch Spanien.",
    "antwort": false,
    "grad": "mittel"
  }
]
</div>

Quattro-Katalog (vier Antworten)

<div id="question_data">
[
  {
    "frage": "Welcher Fluss fließt durch Wien?",
    "antworten": ["Donau", "Rhein", "Elbe", "Main"],
    "richtig": 0,
    "grad": "leicht"
  }
]
</div>

10Bestehende Themen erweitern

Um einem Thema neue Fragen hinzuzufügen, öffnest du die passende Datei (td_[thema].htm oder tq_[thema].htm) und fügst innerhalb der eckigen Klammern [ … ] weitere Einträge an:

1. Setze hinter den letzten Eintrag ein Komma.
2. Füge einen neuen Block im gleichen Aufbau ein (siehe Abschnitt 9).
3. Achte darauf, dass nach dem allerletzten Eintrag kein Komma steht.
4. Speichern, App neu laden – die zusätzlichen Fragen stehen sofort zur Verfügung.

  {
    "aussage": "Ein Pinguin ist ein Vogel.",
    "antwort": true,
    "grad": "leicht"
  },   ← Komma anfügen, wenn ein weiterer Eintrag folgt
  {
    "aussage": "Ein Wal ist ein Fisch.",
    "antwort": false,
    "grad": "mittel"
  }

11Kataloge prüfen & veröffentlichen

Für die Pflege der Kataloge gibt es Hilfswerkzeuge. Sie sind optional – Themen funktionieren auch, wenn du die Dateien nur von Hand bearbeitest –, ersparen aber Tippfehler.

Struktur prüfen

Das Werkzeug scripts/quiz_tool.py prüft JSON, Pflichtfelder, Anzahl und Duplikate:

# einen Katalog prüfen (mit Mindestanzahl)
python -B scripts\quiz_tool.py duo geografie check count:100

# zusätzlich Sprache prüfen (Rechtschreibung, Satzzeichen)
python -B scripts\quiz_tool.py duo geografie check --lint

# alle Kataloge auf einmal
python -B scripts\quiz_tool.py all check

Mit dem /quiz-Assistenten

In Claude Code erzeugt und prüft der /quiz-Befehl Kataloge automatisch:

Veröffentlichen

Neue oder geänderte Kataloge werden mit /quiz publish (bzw. dem Skript publish-to-weberding.ps1) auf den Webserver übertragen. Erst danach sind sie online sichtbar.

12Probleme & Lösungen