Handbuch

Funktionen, Konzept und technische Dokumentation

KI im Geometrieunterricht — Thomas Schroffenegger

1. Konzept und Entstehung

Dieses Projekt ist ein vollständig statisch gehosteter akademischer Artikel mit interaktivem Quellenmanagement. Es wurde in Zusammenarbeit zwischen Thomas Schroffenegger und dem KI-System Claude (Anthropic) erstellt.

Das Besondere am Konzept:

Keine Datenbank, kein CMS. Alle Inhalte liegen als Markdown-Dateien und eine JSON-Quellendatei vor. Ein Python-Script baut daraus eine vollständige HTML-Seite und einen LaTeX-Export.
Funktioniert lokal und online. Alle Seiten laufen direkt über file:// ohne Webserver — und genauso auf jedem normalen Hosting.
290 recherchierte Quellen mit Qualitätsbewertung, Badges und Verlinkungen zu Primärquellen.
Zwei Export-Formate: HTML (mit interaktiven Funktionen) und LaTeX (für professionellen Druck).

2. Seiten und Navigation

Seite	Zweck
index.html	Startseite — Links zu allen Bereichen
standalone.html	Vollständiger Fachartikel (wird durch Build erzeugt)
quellen.html	Interaktives Quellenverzeichnis mit Filter und Suche
presentation/index.html	Präsentationsfolien für den Tag der Geometrie
handbuch.html	Diese Seite

3. Fachartikel — Funktionen

Der Fachartikel (standalone.html) enthält mehrere interaktive Elemente:

Navigationsleiste (rechts unten)

Sechs kleine Pills am rechten unteren Rand:
↑ oben ℹ Info 📊 Folien 📚 Quellen ↓ LaTeX 🖨 Drucken
Beim Drucken (Browser-Dialog oder PDF) werden diese Elemente automatisch ausgeblendet.

ℹ Info-Panel (Dokumentstatistik)

Zeigt Kapitelanzahl, Quellenanzahl, Wortzahl und geschätzte Seitenzahl (A4 und A5). Standardmäßig ausgeblendet — wird über den ℹ Info-Button ein- und ausgeblendet.

Inline-Zitationen (anklickbar)

Alle Quellenverweise im Text im Format (Autor, Jahr) sind anklickbar. Ein Klick öffnet eine Quellenkarte mit Titel, Autoren, Jahr, Journal, Score, Badges und Abstract. Enthält einen Link zur Primärquelle (DOI oder URL).

Inhaltsverzeichnis

Alle zehn Kapitel mit Sprunglinks. Beim Drucken bleibt das Inhaltsverzeichnis erhalten.

Weiterführende Literatur (Ende des Artikels)

Alle zitierten Quellen mit Score ≥ 9 — die hochwertigsten Empfehlungen. Mit Badges, Sternebewertung und DOI-Links.

Anhang 7 — Vollständiges Quellenverzeichnis

Alle 290 Quellen kompakt, zweispaltig, mit Quellen-ID und Markierung ob zitiert. Dient als Referenz und Druckbeilage.

4. LaTeX-Export

Der ↓ LaTeX-Button öffnet ein Overlay mit folgenden Optionen:

Option	Werte	Hinweis
Farbmodus	Farbe / Schwarz-Weiß	S/W: alle Badges in Grautönen
Schriftgröße	9 / 10 / 10.5 / 11 pt	11 pt ist Standard; 10 pt für Fachbücher üblich
Zeilenabstand	1.0 / 1.15 / 1.25	1.0 = klassischer Buchdruck
Ränder	Eng (±1.5 cm) / Normal (±1.8 cm) / Bundsteg	Bundsteg: innen 2.5 cm, außen 1.5 cm, twoside — für Buchbindung

Die Seitenschätzung wird live berechnet und berücksichtigt alle vier Parameter. Die tatsächliche Seitenzahl kann durch Tabellen, Abbildungen und Formeln abweichen.

Download: Die .tex-Datei wird direkt im Browser generiert und heruntergeladen — kein Server nötig. Die Datei ist für pdflatex (Overleaf, TeX Live, MiKTeX) vorbereitet.

Das LaTeX-Dokument enthält:

Vollständigen Fließtext aller 10 Kapitel
Weiterführende Literatur mit Badges
Anhang 7 mit allen 290 Quellen (zweispaltig)
Abbildungsverzeichnis (\listoffigures)
A5-Format, KOMA-Script (scrartcl), TeX Gyre Heros Condensed für Überschriften

5. Quellenverzeichnis

Das interaktive Quellenverzeichnis bietet:

Volltextsuche über Titel, Autoren, Abstract und Notizen
Filter nach Typ (Journal, Konferenz, Buch, Preprint, Bericht, Web), Sprache, Badges und Score
Sortierung nach Score, Jahr, Titel
Zitations-Backlinks: Bei zitierten Quellen erscheinen ①②③-Symbole, die direkt zur Textstelle im Artikel springen
Qualitätsbadges, Sternebewertung, Abstract-Vorschau, DOI/URL-Links

6. Badges — Bedeutung und Farben

Jede Quelle kann mehrere Badges tragen. Sie geben auf einen Blick Auskunft über Typ und Qualität:

Badge	Bedeutung
🎓 Peer-reviewed	Begutachteter Fachartikel — höchste wissenschaftliche Glaubwürdigkeit
🏛️ Institution	Offizieller Bericht einer Behörde, Organisation oder Hochschule (z. B. OECD, EU, BMBWF)
📚 Verlag	Gedrucktes Buch oder Buchkapitel aus einem Wissenschaftsverlag
🔬 Preprint	Noch nicht peer-reviewed — frühes Forschungsergebnis (arXiv, bioRxiv etc.)
🌐 Web	Webquelle — Blogs, Nachrichtenartikel, Dokumentationen
🇦🇹 Österreich	Österreichischer Bezug — besonders relevant für den Kontext TU Graz / PH Graz
🔓 Open Access	Frei zugänglich, keine Paywall
🔒 Paywall	Nur mit Institutionszugang oder Bezahlung verfügbar
🧮 Mathematik	Inhaltlich stark mathematisch — Formeln, Beweise, theoretische Grundlagen
● zitiert	Diese Quelle wird im Artikel direkt zitiert

7. Qualitätsbewertung (Score)

Jede Quelle erhält einen Score von 3–10. Er setzt sich aus drei Kriterien zusammen:

Kriterium	Skala	Bedeutung
Authority	1–4	Herkunft und wissenschaftliche Reputation (Peer-Review-Journal = 4, Blog = 1)
Recency	1–3	Aktualität (2024–2026 = 3, vor 2020 = 1)
Relevance	1–3	Thematische Nähe zu KI + Geometrie + Bildung

Score = Authority + Recency + Relevance (Maximum 10). Farbcodierung:

9–10: Exzellent — Weiterführende Literatur

7–8: Gut — solide Fachliteratur

5–6: Mittel — ergänzend nutzbar

3–4: Schwach — nur als Hintergrund

8. Abbildungen einbinden

Abbildungen werden im Ordner figures/ abgelegt und im Kapitel-Markdown referenziert:

![Beschriftung der Abbildung](figures/dateiname.png)

Der Build erzeugt daraus automatisch:

HTML: <figure>-Element mit Abbildung N:-Nummerierung und Bildunterschrift
LaTeX: \begin{figure}...\includegraphics...\caption{...}\end{figure} mit automatischer Nummerierung und Abbildungsverzeichnis

Unterstützte Formate: PNG, JPG, SVG (nur HTML), PDF (nur LaTeX).
Empfehlung für maximale Kompatibilität: PNG verwenden.

9. Build-System

Der gesamte Artikel wird durch ein einziges Python-Script erzeugt:

cd 00_research_alpha
python3 build.py

Das Script liest:

content/meta.json — Titel, Autoren, Abstract, Kapitelliste
content/01_einleitung.md bis 10_ausblick.md — Kapitelinhalte (Markdown)
sources/sources.json — alle Quellen mit Metadaten
assets/css/paper.css — Stylesheet

Es erzeugt:

standalone.html — vollständiger Artikel mit Overlay, Zitationsystem, LaTeX-Export-Overlay
standalone.tex — LaTeX-Datei (Farbe, 11 pt, Standardparameter)
standalone_sw.tex — LaTeX-Datei (Schwarz-Weiß)
quellen.html wird aktualisiert (Quelldaten + Zitations-Backlinks eingebettet)

Zitationserkennung: Das Script erkennt automatisch alle APA-Zitate im Format (Nachname, Jahr) im Text, ordnet sie den Quellen in sources.json zu und erzeugt anklickbare Spans mit Quellenkarten-Overlay.

10. Neue Quellen hinzufügen

Neue Quellen werden in sources/sources.json eingetragen. Die nächste freie ID steht im CLAUDE.md-File des Projekts.

Schema einer Quelle:

{
  "id": "S282",
  "title": "Titel des Werks",
  "authors": ["Nachname, V.", "Nachname2, V2."],
  "year": 2025,
  "journal": "Zeitschrift oder Verlag",
  "type": "journal",
  "lang": "en",
  "authority": 4,
  "recency": 3,
  "relevance": 3,
  "score": 10,
  "badges": ["peer", "openaccess", "math"],
  "abstract": "Kurzzusammenfassung auf Deutsch.",
  "doi": "10.xxxx/xxxxx",
  "url": "https://...",
  "local": null,
  "retrieved": "2026-03-21",
  "notes": ""
}

Nach dem Eintrag: Im jeweiligen Kapitel-Markdown zitieren (Nachname & Nachname, Jahr) und im Literaturabschnitt am Kapitelende eine APA-7-Referenz ergänzen. Dann python3 build.py ausführen.

Zuletzt content/meta.json und die Quellenanzahl in content/01_einleitung.md aktualisieren.