Skip to content

Commit ed9a3a8

Browse files
committed
update
1 parent 6a6b2c0 commit ed9a3a8

2 files changed

Lines changed: 88 additions & 0 deletions

File tree

README.md

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# Hyperbook Informatik
2+
3+
Ein interaktives Hyperbook zum Lernen und Lehren von Informatik, entwickelt von [OpenPatch](https://openpatch.org).
4+
5+
## 📚 Über das Projekt
6+
7+
In diesem Hyperbook lernst du viele Themen der Informatik kennen. Die Inhalte sind nach Schulstufen gegliedert:
8+
9+
- **Unterstufe** (8-12 Jahre): Grundlagen der Informatik spielerisch erkunden
10+
- **Mittelstufe** (12-16 Jahre): Vertiefung von Programmierung und algorithmischem Denken
11+
- **Oberstufe** (16-19 Jahre): Fortgeschrittene Themen und Konzepte
12+
13+
Das Hyperbook verwendet interaktive Elemente, Web Components und moderne Lernmethoden, um Informatik anschaulich und praxisnah zu vermitteln.
14+
15+
## 🚀 Nutzung
16+
17+
Das Hyperbook ist online verfügbar und kann direkt im Browser genutzt werden.
18+
19+
## 🛠️ Lokale Entwicklung
20+
21+
Um das Hyperbook lokal zu entwickeln und zu testen:
22+
23+
```bash
24+
# Repository klonen
25+
git clone https://github.com/openpatch/hyperbook-informatik.git
26+
cd hyperbook-informatik
27+
28+
# Entwicklungsserver starten
29+
npx hyperbook dev
30+
```
31+
32+
**Alternative:** Installiere die [Hyperbook Extension für VS Code](https://marketplace.visualstudio.com/items?itemName=openpatch.hyperbook) für eine noch bessere Entwicklungserfahrung direkt in deinem Editor.
33+
34+
## 🤝 Mitmachen
35+
36+
Wir freuen uns über jede Unterstützung!
37+
38+
**Auf jeder Seite des Hyperbooks** findest du unten links ein Stiftsymbol (✏️), über das du direkt Korrekturen und Ergänzungen vorschlagen kannst.
39+
40+
Für ausführliche Informationen zum Mitmachen, zur Projektstruktur, zu Snippets und Web Components, siehe die [Mitmachen-Seite](book/mitmachen.md).
41+
42+
## 📁 Projektstruktur
43+
44+
```
45+
├── book/ # Inhaltsdateien (Markdown)
46+
│ ├── unterstufe/ # Inhalte für die Unterstufe
47+
│ ├── mittelstufe/ # Inhalte für die Mittelstufe
48+
│ └── oberstufe/ # Inhalte für die Oberstufe
49+
├── glossary/ # Glossareinträge
50+
├── public/ # Statische Dateien
51+
│ ├── images/ # Bilder
52+
│ └── wc/ # Web Components
53+
├── snippets/ # Snippet-Templates
54+
├── archives/ # Projektarchive (Java, etc.)
55+
└── hyperbook.json # Konfigurationsdatei
56+
```
57+
58+
## 📝 Lizenz
59+
60+
Dieses Projekt ist unter der **CC-BY-SA** (Creative Commons Attribution-ShareAlike) Lizenz veröffentlicht.
61+
62+
Das bedeutet:
63+
- ✅ Du darfst die Inhalte teilen und bearbeiten
64+
- ✅ Auch für kommerzielle Zwecke
65+
- ⚠️ Du musst angemessene Urheber- und Rechteangaben machen
66+
- ⚠️ Bearbeitungen müssen unter derselben Lizenz weitergegeben werden
67+
68+
Weitere Informationen findest du unter: https://creativecommons.org/licenses/by-sa/4.0/deed.de
69+
70+
## 📞 Kontakt
71+
72+
- **GitHub**: https://github.com/openpatch/hyperbook-informatik
73+
- **Website**: https://openpatch.org
74+
- **Issues**: Für Fehler und Verbesserungsvorschläge nutze bitte die [GitHub Issues](https://github.com/openpatch/hyperbook-informatik/issues)
75+
76+
## 🙏 Danksagungen
77+
78+
Vielen Dank an alle Mitwirkenden, die zu diesem Projekt beitragen!
79+
80+
---
81+
82+
Made with ❤️ by [OpenPatch](https://openpatch.org)

book/mitmachen.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,12 @@ Auf jeder Seite findest du unten links ein Stiftsymbol. Darüber kannst du Korre
2424
- Für dieses Thema musst du ... (Vorwissen mit Links zu den passenden Zusammenfassungsseiten)
2525
- Hier lernst du ... (Lernziele)
2626

27+
## Banner
28+
29+
- Banner sollten immer **1024x280 Pixel** oder in diesem Verhältnis (ca. 3,66:1) groß sein
30+
- Das Banner wird **über der Überschrift** der Seite platziert
31+
- Achte auf gute Lesbarkeit und passende Kontraste
32+
2733
## Absprachen zur einhaltlichen Gestaltung
2834

2935
:::alert{info}

0 commit comments

Comments
 (0)