QuizScanner 3.1.0

Największe wydanie od początku projektu — wzory matematyczne, motywy, dźwięki i pełne raporty po lekcji. Zawiera wszystko z pominiętej wersji 3.0.0.

🧮 Wzory matematyczne

Dwie drogi, obie z jednego przybornika w edytorze:

• Symbole Unicode w sześciu sekcjach: podstawowe (± × ÷ ≤ ≥ ≈), potęgi i ułamki (² ³ ⁿ √ ½), greka (α β π Δ Σ), zbiory i logika (∈ ⊂ ∪ ∀ ⇒ ℝ), geometria (∠ ⊥ ∥ △ ≅), analiza (∑ ∏ ∫ ∂ lim).
• LaTeX renderowany przez KaTeX — wzór zamykasz w dolarach:

  Ile wynosi $\frac{1}{2} + \frac{1}{4}$ ?
  Pole koła: $\pi r^2$,  granica: $\lim_{x \to 0} \frac{\sin x}{x}$
  $$\begin{cases} x + y = 2 \\ x - y = 0 \end{cases}$$
  

  Gotowe szablony: ułamek piętrowy, pierwiastek stopnia n, całka z granicami, suma, granica, symbol Newtona, wektor, układ równań, macierz. Podwójne dolary dają wzór wyśrodkowany.

Szablony działają na zaznaczeniu — zaznacz x+1, kliknij √( ), wychodzi √(x+1). Przyciski x² / x₂ zamieniają zaznaczenie na indeks górny lub dolny. Pod przybornikiem jest podgląd na żywo: widzisz dokładnie to, co pojawi się na tablicy, a błąd składni świeci się od razu.

KaTeX razem z czcionkami siedzi w repozytorium i w pliku .exe (~600 kB) — nic nie pobiera się z internetu, aplikacja dalej działa w pełni offline.

🎨 Siedem motywów, ciemny domyślnie

Ciemny · Jasny · Ocean · Las · Zachód słońca · Cukierkowy · Wysoki kontrast

Wybór z listy w panelu lub edytorze przebiera od razu także tablicę — również wtedy, gdy tablica stoi na drugim komputerze przy rzutniku. Do jasnej sali najlepszy jest Wysoki kontrast.

🔊 Dźwięki tablicy

Sygnał startu pytania, ciche odliczanie w ostatnich pięciu sekundach (ostatnia wyżej), koniec czasu, fanfara przy wyniku i na podium. Generowane w przeglądarce — zero plików audio. Przełącznik i suwak głośności w panelu.

📊 Raport po lekcji

Nowy przycisk „📊 Raport": ranking, skuteczność każdego ucznia, odpowiedź na każde pytanie (kolumny P1, P2, …), rozkład A/B/C/D i wskazanie najtrudniejszego pytania.

Format	Do czego
PDF	wydruk, teczka wychowawcy
XLSX	dziennik, przeliczanie na oceny
CSV	import gdzie indziej (Excel otwiera bez kreatora)
HTML	podgląd i wydruk przez Ctrl+P
JSON	własne zestawienia i skrypty
TXT	szybki podgląd, wklejenie do wiadomości

Po ostatnim pytaniu komplet HTML + CSV + JSON zapisuje się sam do data/raporty/. W raportach wzory zapisywane są tekstem ($\frac{1}{2}$ → (1)/(2)), a pełny LaTeX zostaje w eksporcie JSON.

⬆️ Automatyczna aktualizacja

Program przy starcie pyta GitHuba o najnowsze wydanie. Gdy jest nowsze, u góry panelu pojawia się pasek — jedno kliknięcie pobiera plik, a podmiana dzieje się przy zamykaniu programu. Sprawdzanie można wyłączyć; wtedy aplikacja nie wykonuje żadnych połączeń na zewnątrz.

🗂️ Porządek w plikach

• Kod w pakiecie quizscanner/, dokumentacja w docs/, skrypty w scripts/.
• Wszystkie Twoje dane w jednym folderze data/ obok programu: quizy, media, lista uczniów, raporty, ustawienia. Łatwiej skopiować i zarchiwizować, a aktualizacja tego folderu nie dotyka.
• Serwer ze źródeł uruchamia się przez python -m quizscanner (dawniej python app.py).

📖 Dokumentacja

• FAQ — ok. 45 pytań o karty, kamerę, wzory, raporty, prywatność i typowe kłopoty.
• Przebudowana strona repozytorium i CHANGELOG.
• python tools/selftest.py — szybkie sprawdzenie, czy wszystko działa: strony, API, karty PDF, cały przebieg quizu, wszystkie formaty raportu i kompletność tłumaczeń PL/EN.

📦 Instalacja

• Windows: pobierz QuizScanner-v3.1.0.exe, przenieś na Pulpit, kliknij dwukrotnie. Bez Pythona, bez instalacji.
• Linux / macOS: ./scripts/install.sh, potem ./start.sh.

Aktualizujesz z wersji 2.x? Twoje quizy i lista uczniów leżą obok starego programu — przenieś quizzes/ i students.csv do nowego folderu data/.