Add Sphinx documentation and Read the Docs configuration

Author: vsvito420

.gitignore

@@ -1 +1,2 @@
-code/
+code/
+.venv

.readthedocs.yaml

@@ -0,0 +1,37 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.13"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+  builder: html
+
+# Optionally declare the Python requirements required to build your documentation
+# e.g:
+# build:
+#   apt_packages:
+#     - graphviz
+#   os: ubuntu-22.04
+#   tools:
+#     python: "3.13"
+#   jobs:
+#     - requirements: docs/requirements.txt
+#       name: Python 3.13
+
+# Optionally set the version of Python and requirements required to build your documentation
+# build:
+#   os: ubuntu-22.04
+#   tools:
+#     python: "3.13"
+#   jobs:
+#     - requirements: docs/requirements.txt
+#       name: Python 3.13

.vscode/extensions.json

@@ -5,6 +5,7 @@
         "github.copilot",
         "ms-python.vscode-pylance",
         "visualstudioexptteam.vscodeintellicode",
-        "formulahendry.code-runner"
+        "formulahendry.code-runner",
+        "ms-vsliveshare.vsliveshare"
     ]
 }

Anleitungen/06_lernweg.md

@@ -0,0 +1,198 @@
+# Python Lernweg für Jugendliche 🚀
+
+## Inhaltsverzeichnis
+- [Einführung](#einführung)
+- [Lernziele](#lernziele)
+- [Übersicht der Lerneinheiten](#übersicht-der-lerneinheiten)
+- [Detaillierter Lernpfad](#detaillierter-lernpfad)
+  - [Phase 1: Grundlagen](#phase-1-grundlagen)
+  - [Phase 2: Erste Schritte mit Programmen](#phase-2-erste-schritte-mit-programmen)
+  - [Phase 3: Fortgeschrittene Konzepte](#phase-3-fortgeschrittene-konzepte)
+  - [Phase 4: Projekte und Anwendungen](#phase-4-projekte-und-anwendungen)
+- [Tipps für Lehrkräfte](#tipps-für-lehrkräfte)
+- [FAQ](#faq)
+
+---
+
+Vorheriges Thema: [String-Operationen](/Anleitungen/05_string_operationen.md) | Nächstes Thema: [Bedingungen und Entscheidungen](/Anleitungen/07_bedingungen.md)
+
+---
+
+## Einführung
+
+Dieser Lernweg ist speziell für Jugendliche konzipiert, die Python lernen möchten. Er bietet eine strukturierte, schrittweise Herangehensweise, die auf die Bedürfnisse junger Lernender zugeschnitten ist. Jedes Thema baut auf dem vorherigen auf und führt neue Konzepte ein, ohne zu überfordern.
+
+Der Lernweg ist in Phasen unterteilt, die jeweils mehrere Lerneinheiten umfassen. So können Schülerinnen und Schüler in ihrem eigenen Tempo lernen und haben regelmäßig Erfolgserlebnisse durch kleine, erreichbare Ziele.
+
+## Lernziele
+
+Nach Abschluss dieses Lernwegs werden die Schülerinnen und Schüler:
+
+- Die Grundlagen der Python-Programmierung verstehen 🧠
+- Eigene Programme schreiben können 💻
+- Algorithmisches Denken entwickelt haben 🧩
+- Probleme systematisch lösen können 🔍
+- Kreative Projekte umsetzen können 🎨
+- Grundlegende Konzepte der Informatik kennen 📚
+
+## Übersicht der Lerneinheiten
+
+![Lernweg-Übersicht](pfad/zum/bild.png)
+
+| Phase | Schwerpunkt | Hauptthemen | Dauer |
+|-------|-------------|-------------|-------|
+| 1 | Grundlagen | Kommentare, Python Interpreter, Variablen, Strings | 2-3 Wochen |
+| 2 | Erste Programme | Bedingungen, Schleifen, Listen, Funktionen | 3-4 Wochen |
+| 3 | Fortgeschrittene Konzepte | Module, Dateien, Fehlerbehandlung | 2-3 Wochen |
+| 4 | Projekte | Spieleentwicklung, Datenanalyse, Web-Anwendungen | 3-4 Wochen |
+
+## Detaillierter Lernpfad
+
+### Phase 1: Grundlagen
+
+#### Einheit 1: Erste Schritte
+- **[Python Interpreter](/Anleitungen/03_python_interpreter.md)** - Kennenlernen der Programmierumgebung
+  - *Praktische Übung*: Erste Befehle im Python Interpreter ausprobieren
+  - *Zeitaufwand*: 1-2 Unterrichtsstunden
+  - *Ziel*: Die Schüler können den Python Interpreter starten und einfache Befehle ausführen
+
+#### Einheit 2: Kommentare und Algorithmen
+- **[Python Kommentare](/Anleitungen/01_Kommentare.md)** - Dokumentation von Code
+- **[Algorithmen](/Anleitungen/02_Algorithmen.md)** - Grundverständnis für Abläufe
+  - *Praktische Übung*: Alltägliche Prozesse als Algorithmen beschreiben
+  - *Zeitaufwand*: 1-2 Unterrichtsstunden
+  - *Ziel*: Die Schüler verstehen das Konzept von Algorithmen und können Code dokumentieren
+
+#### Einheit 3: Variablen und Datentypen
+- **[Variablen und Datentypen](/Anleitungen/04_variablen_und_Datentypen.md)** - Speichern und Verwenden von Informationen
+  - *Praktische Übung*: [Grundlagen](/Aufgaben/Kapitel_1/Grundlagen.md)
+  - *Zeitaufwand*: 2 Unterrichtsstunden
+  - *Ziel*: Die Schüler können Variablen erstellen und verschiedene Datentypen unterscheiden
+
+#### Einheit 4: Arbeiten mit Text
+- **[String-Operationen](/Anleitungen/05_string_operationen.md)** - Textverarbeitung in Python
+  - *Praktische Übung*: [Strings](/Aufgaben/Kapitel_1/Strings.md)
+  - *Zeitaufwand*: 2 Unterrichtsstunden
+  - *Ziel*: Die Schüler können mit Strings arbeiten und grundlegende String-Operationen durchführen
+
+### Phase 2: Erste Schritte mit Programmen
+
+#### Einheit 5: Entscheidungen im Programm
+- **Bedingungen und Verzweigungen** - Entscheidungen in Programmen treffen
+  - *Praktische Übung*: [Bedingungen und Dictionaries](/Aufgaben/Kapitel_2/Bedingungen_und_Dictionaries.md)
+  - *Zeitaufwand*: 2-3 Unterrichtsstunden
+  - *Ziel*: Die Schüler können if-else-Strukturen verwenden und Entscheidungen in Programmen implementieren
+
+#### Einheit 6: Wiederholungen
+- **Schleifen** - Wiederholte Ausführung von Code
+  - *Praktische Übung*: Einfache Schleifenaufgaben
+  - *Zeitaufwand*: 2 Unterrichtsstunden
+  - *Ziel*: Die Schüler beherrschen for- und while-Schleifen und können sie anwenden
+
+#### Einheit 7: Datensammlungen
+- **Listen und Dictionaries** - Verwalten von Datensätzen
+  - *Praktische Übung*: Erstellen und Bearbeiten von Listen und Dictionaries
+  - *Zeitaufwand*: 2-3 Unterrichtsstunden
+  - *Ziel*: Die Schüler können mit Listen und Dictionaries arbeiten und deren Unterschiede verstehen
+
+#### Einheit 8: Funktionen
+- **Funktionen** - Wiederverwendbare Codeblöcke
+  - *Praktische Übung*: [Funktionen](/Aufgaben/Kapitel_6/Funktionen.md)
+  - *Zeitaufwand*: 2-3 Unterrichtsstunden
+  - *Ziel*: Die Schüler können eigene Funktionen erstellen und verwenden
+
+### Phase 3: Fortgeschrittene Konzepte
+
+#### Einheit 9: Module und Bibliotheken
+- **Module und Built-in Funktionen** - Verwenden externer Funktionalitäten
+  - *Praktische Übung*: [Module und Built-in Funktionen](/Aufgaben/Kapitel_7/Module_und_Builtin_Funktionen.md)
+  - *Zeitaufwand*: 2 Unterrichtsstunden
+  - *Ziel*: Die Schüler können Module importieren und deren Funktionen nutzen
+
+#### Einheit 10: Dateien und Daten
+- **Dateiverarbeitung** - Lesen und Schreiben von Dateien
+  - *Praktische Übung*: Textdateien erstellen und auslesen
+  - *Zeitaufwand*: 2 Unterrichtsstunden
+  - *Ziel*: Die Schüler können Dateien öffnen, lesen, schreiben und schließen
+
+#### Einheit 11: Fehlerbehandlung
+- **Fehlerbehandlung** - Umgang mit Fehlern und Ausnahmen
+  - *Praktische Übung*: Try-Except-Blöcke implementieren
+  - *Zeitaufwand*: 1-2 Unterrichtsstunden
+  - *Ziel*: Die Schüler können Fehler abfangen und behandeln
+
+### Phase 4: Projekte und Anwendungen
+
+#### Einheit 12: Grafische Elemente
+- **Turtle-Grafik** - Einfache grafische Darstellungen
+  - *Praktische Übung*: [Turtle Grafik](/Aufgaben/Kapitel_3/Turtle_Grafik.md)
+  - *Zeitaufwand*: 2-3 Unterrichtsstunden
+  - *Ziel*: Die Schüler können einfache Grafiken mit Turtle erstellen
+
+#### Einheit 13: Einfache Spiele
+- **Spieleentwicklung** - Grundlagen der Spieleprogrammierung
+  - *Praktische Übung*: [Spiele](/Aufgaben/Kapitel_4/Spiele.md)
+  - *Zeitaufwand*: 3-4 Unterrichtsstunden
+  - *Ziel*: Die Schüler können ein einfaches Spiel programmieren
+
+#### Einheit 14: Text-Generatoren
+- **Zufallsgeneratoren** - Arbeiten mit Zufallszahlen
+  - *Praktische Übung*: [Kompliment-Generator](/Aufgaben/Kapitel_5/Kompliment_Generator.md)
+  - *Zeitaufwand*: 2 Unterrichtsstunden
+  - *Ziel*: Die Schüler können mit Zufallszahlen arbeiten und einfache Text-Generatoren erstellen
+
+#### Einheit 15: Fortgeschrittene Funktionen
+- **Funktionsdesign** - Fortgeschrittene Konzepte bei Funktionen
+  - *Praktische Übung*: [Funktionsdesign](/Aufgaben/Kapitel_8/Funktionsdesign.md)
+  - *Zeitaufwand*: 2-3 Unterrichtsstunden
+  - *Ziel*: Die Schüler können komplexere Funktionen entwerfen und implementieren
+
+#### Einheit 16: Abschlussprojekt
+- **Pygame** - Entwicklung eines komplexeren Spiels
+  - *Praktische Übung*: [Pygame Ghost Game](/Aufgaben/Kapitel_9/Pygame_Ghost_Game.md)
+  - *Zeitaufwand*: 4-6 Unterrichtsstunden
+  - *Ziel*: Die Schüler können ein Pygame-Projekt umsetzen und dabei alle gelernten Konzepte anwenden
+
+## Tipps für Lehrkräfte
+
+### Allgemeine Unterrichtsgestaltung
+- **Strukturierte Einführung**: Beginnen Sie jede Einheit mit einer kurzen Erklärung des Themas und der Lernziele.
+- **Live-Coding**: Demonstrieren Sie Konzepte durch Live-Coding und ermutigen Sie die Schüler, mitzumachen.
+- **Pair Programming**: Lassen Sie die Schüler in Paaren arbeiten, um Probleme gemeinsam zu lösen.
+- **Regelmäßige Pausen**: Planen Sie kurze Pausen ein, besonders bei längeren Coding-Sessions.
+
+### Differenzierung
+- **Zusatzaufgaben**: Bereiten Sie Erweiterungsaufgaben für schnellere Schüler vor.
+- **Hilfekarten**: Erstellen Sie Hilfekarten mit Tipps für Schüler, die Schwierigkeiten haben.
+- **Gemischte Gruppen**: Bilden Sie Gruppen mit unterschiedlichen Fähigkeitsniveaus für Peer-Learning.
+
+### Motivation
+- **Realweltbezug**: Zeigen Sie praktische Anwendungen der Programmierkonzepte im Alltag.
+- **Erfolge feiern**: Heben Sie Fortschritte und kreative Lösungen der Schüler hervor.
+- **Spielerische Elemente**: Integrieren Sie spielerische Elemente wie Coding-Challenges oder kleine Wettbewerbe.
+
+## FAQ
+
+### Für Schüler
+- **F: Wie viel Zeit sollte ich für Übungen außerhalb des Unterrichts einplanen?**
+  A: 1-2 Stunden pro Woche sind ideal, um das Gelernte zu festigen.
+
+- **F: Was mache ich, wenn ich bei einer Aufgabe nicht weiterkomme?**
+  A: Versuche das Problem in kleinere Schritte zu zerlegen. Wenn du immer noch Schwierigkeiten hast, frag einen Mitschüler oder deinen Lehrer.
+
+- **F: Kann ich auch eigene Projekte entwickeln?**
+  A: Absolut! Eigene Projekte sind eine großartige Möglichkeit, das Gelernte anzuwenden und zu vertiefen.
+
+### Für Lehrkräfte
+- **F: Wie kann ich Schüler mit unterschiedlichen Vorkenntnissen gleichermaßen fördern?**
+  A: Arbeiten Sie mit differenzierten Aufgaben und bieten Sie zusätzliche Ressourcen für fortgeschrittene Schüler an.
+
+- **F: Wie gehe ich mit technischen Problemen im Unterricht um?**
+  A: Bereiten Sie im Voraus alternative Aktivitäten vor und ermutigen Sie Schüler, sich gegenseitig zu helfen.
+
+- **F: Wie bewerte ich Programmierprojekte fair?**
+  A: Verwenden Sie klare Bewertungskriterien, die nicht nur das Endergebnis, sondern auch den Prozess, die Dokumentation und die Kreativität berücksichtigen.
+
+---
+
+Viel Erfolg beim Unterrichten und Lernen von Python! 🐍