Geräte-Anleitung — Lesen, Bearbeiten, Sync

Dieses Paket funktioniert auf iPhone, iPad, Android-Handy, Android-Tablet, Windows, Mac und Linux.

Empfohlene Nutzung nach Gerät

Ziel	Beste Option
Unterwegs lesen	Browser → Ordner `html/index.html` öffnen
Schülerin: Übungen schreiben	`html/schueler-es.html` oder `schueler-en.html` — Felder im Browser, Auto-Speichern
Inhalt ändern (Lehrer)	Dateien `*.md` bearbeiten (siehe unten)
Vokabeln lernen	Anki-App + `anki/deutsch-es-en-2000.csv`
Ausdrucken	HTML im Browser → Drucken (Layout optimiert)
Mit Tastatur arbeiten	Computer + Cursor, VS Code oder Word

1. Lesen auf Handy & Tablet (ohne Installation)

iPhone / iPad (iOS)

Ordner deutsch-lernplan-spanisch in iCloud Drive oder Dateien legen (AirDrop vom Mac, oder Sync).
Datei html/index.html antippen → öffnet in Safari.
Optional: Teilen → „Zum Home-Bildschirm“ → Schnellzugriff wie eine App.
In Lehrer-/Schüler-HTML: oben Woche 1–16 antippen zum Springen.

Android (Handy & Tablet)

Ordner in Google Drive hochladen oder lokal speichern.
Mit Chrome oder Firefox html/index.html öffnen
(Dateimanager → HTML-Datei → „Mit Chrome öffnen“).
Woche-Leiste horizontal wischen.

Schülerin: interaktives Workbook

html/schueler-es.html (Spanisch) oder html/schueler-en.html (Englisch) öffnen.
In jeder Übung direkt in die Felder tippen (Lückentext, Zuordnung, Dialog, Hausaufgabe-Tabelle).
Antworten werden automatisch auf diesem Gerät gespeichert (kein Server).
Toolbar: Export JSON, Import, Drucken.
Cloud-Sync (optional) aufklappen — nur wenn du zwischen Geräten synchronisieren willst:
iCloud / Google Drive: JSON-Datei im Cloud-Ordner (gleiche Datei auf Handy + PC)
Supabase / eigener Server: siehe sync/README.md oder html/sync-setup.html

Wichtig

Schüler-HTML = ausfüllbares Workbook. Lehrer-HTML = nur Lesen.
Zum Ändern der Aufgaben-Stammdaten: Markdown (.md) bearbeiten und HTML neu erzeugen (Abschnitt 4).
Alle Dateien sind UTF-8 (Umlaute, ß, español ✓).
Ordnerstruktur beibehalten: html/, assets/ und anki/ müssen zusammen bleiben, damit Layout und CSS laden.
In Google Drive-Vorschau kann das Layout fehlen → Ordner herunterladen und lokal index.html öffnen.

2. Lesen & Bearbeiten auf dem Computer

Schnell lesen (Browser)

Doppelklick auf html/index.html (Chrome, Safari, Edge, Firefox).

Bearbeiten (Lehrer)

Programm	Dateien	Hinweis
Cursor / VS Code	`*.md`	Beste Wahl; Vorschau mit Markdown-Extension
Word / LibreOffice	`.md` importieren oder kopieren	Für Kommentare in Übungen
Google Docs	Inhalt aus `.md` kopieren	Gut für gemeinsame Korrektur mit Schülerin
Apple TextEdit	`.md` als Klartext	Nur einfache Änderungen

Quelldateien (bearbeiten):

01-Lehrer-A1-16-Wochen.md
02-Loesungsbuch-A1.md
03-Schueler-ES-A1-16-Wochen.md
04-Schueler-EN-A1-16-Wochen.md

3. Bearbeiten auf dem Tablet & Handy

iOS (empfohlen)

Dateien + iCloud: .md mit Runestone (Editor), iA Writer oder 1Writer bearbeiten.
Oder am Mac in Cursor bearbeiten — iCloud synchronisiert automatisch.

Android (empfohlen)

Markor (kostenlos): Markdown direkt auf dem Handy.
Google Drive + Docs nur für kurze Notizen; für den ganzen Plan besser Markor oder PC.

CSV / Vokabeln bearbeiten

App	Plattform
Google Sheets	iOS, Android, Web
Microsoft Excel	iOS, Android, PC
Numbers	nur Apple

Datei: anki/deutsch-es-en-2000.csv
Nach Änderungen erneut in Anki importieren (siehe anki/ANKI-IMPORT.md).

4. Cloud-Sync (Lehrer + Schülerin)

Empfohlen: ein gemeinsamer Ordner mit Lese-/Schreibrechten getrennt:

Dienst	Lehrer	Schülerin
Google Drive	ganzer Ordner	nur `03-Schueler-ES` + `html/schueler-es.html`
iCloud Drive	Ordner teilen (Apple)	Einladung „Nur Betrachten“ für HTML
Dropbox / OneDrive	wie Google Drive	Schüler-Dateien freigeben

Regel: Lösungsbuch (02-Loesungsbuch) und Lehrer-HTML nicht an Schülerin freigeben.

5. HTML nach Änderungen aktualisieren

Wenn du .md-Dateien bearbeitet hast (am PC):

cd deutsch-lernplan-spanisch
python3 generate_materials.py    # falls Anki/Inhalte aus Skript
python3 generate_html.py         # HTML für Handy/Tablet neu

Dann den Ordner html/ erneut in die Cloud legen.

Ohne Python: Markdown-Inhalte manuell in Docs nutzen; HTML nur als bequeme Lesefassung.

6. Listen & Repeat — Audio (MP4)

Fertige Dateien unter audio/lr/woche-01/ … woche-16/:

Datei	Inhalt
`komplett-langsam.mp4`	Ganze Woche, langsam
`komplett-normal.mp4`	Ganze Woche, normal
`komplett-pausen.mp4`	Mit Pause nach jedem Satz
`01-guten-tag-normal.mp4`	Einzelne Sätze

Auf iPhone/Android in der Dateien-App oder Cloud antippen → Wiedergabe.
Stimme: de-DE-KatjaNeural (natürlich, neural).
Neu erzeugen: python3 generate_audio.py (Internet erforderlich).

7. Anki (iOS & Android)

Anki aus App Store / Play Store installieren.
CSV auf das Gerät kopieren (AirDrop, Drive, E-Mail).
In Anki: Importieren → deutsch-es-en-2000.csv
Details: anki/ANKI-IMPORT.md oder html/anki-import.html.

8. Drucken

html/lehrer.html (oder Schüler-Version) im Browser öffnen.
Drucken (Strg+P / Cmd+P).
Navigation und Woche-Leiste werden automatisch ausgeblendet.

Tipp: Einzelne Wochen per Sprungmarke (#woche-05) scrollen, dann nur diese Seite drucken (Browser: „Auswahl drucken“).

9. Technische Kompatibilität

Format	iOS	Android	Windows	Mac
`.html` + CSS	✓ Safari	✓ Chrome	✓	✓
`.md`	✓ mit Editor-App	✓ Markor	✓	✓
`.csv` (UTF-8)	✓	✓	✓ Excel	✓ Numbers

Zeilenumbrüche: LF (Unix) — funktioniert überall.
Schrift auf kleinen Screens: mindestens 17px im HTML-Layout.

Kurz-Hilfe

Nur lesen, kein PC: html/index.html auf dem Handy öffnen.
Plan anpassen: 01-Lehrer-…md am Computer bearbeiten → generate_html.py.
Vokabeln: Anki + CSV, 15–25 neue Karten pro Woche.