i

Dokumentation

Farben

  • #2C8F78
  • #2F4858
  • #007FBB
  • #7661B3
  • #F3EADA
  • #9FACBD
  • #bb0a21
  • #EB9928
  • #F9F871

Gliederung des Projekts

  • Die sechs Kacheln auf der Startseite sind die Themenbereiche.
  • Die Themenbereiche gliedern sich in Kapitel, diese ggf. noch einmal in Unterkapitel.
  • Mehrere Seiten bilden einen Abschnitt.

Gliederung der Startseiten

  1. Worum geht es hier? (thematische Orientierung)
  2. Für dieses Thema musst du ... (Vorwissen mit Links zu den passenden Zusammenfassungsseiten)
  3. Hier lernst du ... (Lernziele)
  4. Inhalte (blaue Inhaltsbox, die die Seitenleiste wiederspiegelt)

Gliederung einzelner Seiten

  • Überschriften mit Operatoren: <h3>Überschrift</h3> („Funktionswerte bestimmen“; nicht bei Einstiegen)
  • Aufgabe: <h3 class="aufgabe">Aufgabe 1</h3>
  • Aufgabe mit Text: <h3 class="aufgabe">Aufgabe 1: Das Ziegenproblem erkunden</h3>
  • Aufgabe mit Phase (nur wenn sinnvoll): <h3 class="aufgabe">Aufgabe 1 (Einstieg)</h3> Die Phasen Einstieg/Erarbeitung/Sicherung/Vertiefung können auch als Lernstrecke abgebildet werden.
  • Teilaufgaben: fett und mit Klammern <b>(a)</b>

Boxen

Folgendes ist noch zu klären:

  • Die i-Box ist sehr prominent, insbesondere als details-Box. Solche Informationen stechen schon sehr hervor. Wir nutzen sie aktuell aber auch für weniger wichtige Punkte.
  • In den einzelnen Themenbereichen sollten die Boxen für Definition und Satz beim ersten Auftreten (bzw. dem ersten passenden Auftreten) kurz thematisiert werden, ggf. mit Verweis auf ein Kapitel in den Grundlagen.
  • Die blaue Box wird gerade sehr unterschiedlich eingesetzt. Für Tipps (dafür ist sie eigentlich zu prominent) und für die Leitfrage einer Seite/Aufgabe.
  • Die Problem-Box ist manchmal eigentlich gleichbedeutend zur Frage-Box – je nach Formulierung. Die beiden sind aber sehr unterschiedlich auffällig. Das ist ungeschickt.
  • Grundsatzfrage: Boxen für jede Eventualität oder nur einige wenige und ansonsten eine Standard-Box mit einer Überschrift?

Wunschliste an Boxen:

  • Definition: Auszeichnung D, wie bisher, gedacht für alle Arten von Definitionen, Konventionen und Benennungen
  • Satz: Auszeichnung S, wie bisher, gedacht für Sätze, festgestellte Regeln und Zusammenhänge
  • Beispiel: Auszeichnung B, wie bisher, gedacht für Beispiele und Muster-Aufgaben
  • Information: Auszeichnung i, wie bisher, gedacht für wichtige Informationen, die vor der Bearbeitung der Aufgaben unbedingt zu lesen sind. (Die Box sticht stark hervor und eignet sich daher dafür)
  • Tipp: Auszeichnung Glühlampe, unauffälliges grau (Der Tipp soll einem nicht „ins Gesicht springen“), gedacht für alle Arten der Hilfestellung
  • Kontrolle: Auszeichnung Schlüssel, unauffälliges grau (Eine Lösung soll einem nicht „ins Gesicht springen“), gedacht für Kontrollergebnisse bei Aufgaben
  • Ziel: Auszeichnung eine Zielscheibe, blau, gedacht für Leitfrage, wichtige Problemstellung, Zwischenfazit, – also einerseits die Festlegung einer Zielsetzung und andererseits für die wichtigen Beiträge zu diesem Ziel.
  • Todo: Auszeichnung TODO, Stark abgehoben wie bisher, zur internen Verwendung
  • Didaktik-Temp: Auszeichnung Doktorhut, bitte Kontrast erhöhen, wird später noch durch neues Feature ersetzt. Gedacht für didaktische Kommentare.
  • Heft: Wie bisher mit Karos, ggf. schafft man es sogar, den Text auf die Karos auszurichten. Das ist aber nur ein Nice-to-Have.
  • Baustelle: gelb-schwarze Ränder oben und unten, Baustellen-Symbol. Gedacht für Hinweise auf aktuelle Überarbeitungen
  • keine „Boxeninflation“, also keine weitere Verwendung von achtung, problem, frage, ...
  • Für alles andere eine Standardklasse (vllt. "plain"?): grau, ohne Auszeichnung, wir nutzen ggf. eine Überschrift „Link“, „Hinweis“, „Anleitung“ usw. Optimal wäre ein optionales Attribut title="...", das den Titel direkt richtig setzt: fett, dunkelgrau. Wenn das nicht geht, dann wäre ein eigenes Tag, dass passend zu dieser Box (oder allgemein passend zur darum befindlichen Box wie bei summary?) den Titel formatiert noch nett. Wenn auch das nicht geht, dann müssen wir das eben „von Hand“ tun.

class="achtung"

Für sehr wichtige Inhalte.

class="information"

für Hinweise zur Bearbeitung der Aufgaben

class="definition"

für Definitionen, Konventionen, Benennungen

class="satz"

für Sätze, Regeln, Zusammenhänge

class="beispiel"

für Beispiele, Musteraufgaben

class="frage"

für Tipps?, für die Leitfrage? Aktuell uneinheitlich verwendet.

class="problem"

für die Problemstellung

class="todo"

um Stellen zu markieren, die im Schulbuch noch verbessert werden müssen (zurzeit nur im Stochastik-Kapitel)

class="heft"

für Eintragungen in die Unterlagen der Lernenden

Hinweis zu ausklappbaren Boxen:

Boxen können auch ausklappbar sein mit dieser Syntax:

<details class="information">
  <summary>Hinweis zu ausklappbaren Boxen:</summary>
  <p>
    Boxen können auch ausklappbar sein.
  </p>
</details>
Didaktik:

Text für einen didaktischen Kommentar, wird später durch neue Funktion ersetzt. Code sieht so aus:

<details class="didaktik-temp">
<summary>Didaktischer Kommentar</summary>
<p>Text</p>
</details class="didaktik-temp">

Kann auch als „normales“ div verwendet werden. Beim schließenden Tag wird die Klasse ergänzt; das hat keinen Effekt, erleichtert aber später eine automatisierte Änderung.

Textauszeichnungen

  • Definitionen im Fließtext: <span class="definition">Ableitung</span>; darauf achten, dass man sich in einem <p></p> befindet.

Symbole zur Kennzeichnung von Aufgaben

Diese Symbolliste muss noch ausgedünnt werden:
Symbol HTML-Code Erläuterung
🖊️ &#128394;&#65039; Stift bei Aufgaben, in denen etwas ins Heft geschrieben werden soll
🛟 &#128735; Rettungsring bei Hilfen
💬 &#128172; Sprechblase bei Partnerarbeit u.ä.
&#9654; Pfeil für Links
🎯 &#127919; Dartpfeil für Zielsetzungen
🚀 &#128640; Rakete bei Aufgaben für Schnellere
💡 &#128161; Glühlampe bei Tipps
🔑 &#128273; Schlüssel für Lösungen
🎓 &#127891; Hut bei didaktischem Kommentar
🕵 &#128373; Spion bei Fehlersuchen
&#9733; ein Stern bei leichten Aufgaben
★★ &#9733;&#9733; zwei Sterne bei mittleren Aufgaben
★★★ &#9733;&#9733;&#9733; drei Sterne bei schweren Aufgaben
&#9760; Totenkopf bei extrem kniffligen Aufgaben
👤👤 &#x1f464;&#x1f464; zwei Köpfe für Partnerarbeit

Parameter zur Einbindung der GeoGebra-Applets

https://wiki.geogebra.org/en/Reference:GeoGebra_App_Parameters

Quellen-Generator für inf-schule.de

https://www.inf-schule.de/infschule/dokumentation/kapitel-erstellen/textbereich/imgtaggenerator https://www.inf-schule.de/infschule/dokumentation/kapitel-erstellen/textbereich/imgtaggenerator

Mathematische Notation

  • $P(1|2)$ statt $P=(1,2)$
  • $1.23$ statt $1{,}23$
  • Einträge/Komponenten/Koordinaten eines Vektors?

Farbverwendung einzelner mathematischer Inhalte

Funktionen

  • rot: Stelle $x$
  • blau: Funktionswert $y$

Differentialrechnung

  • schwarz: Graph der Ursprungsfunktion $f$
  • blau: Graph der Ableitungsfunktion $f'$ und Tangente
  • grün: Sekante

Sprachliches

  • überall Du-Anrede
  • GeoGebra-Applet, wenn Lernende etwas interaktiv verändern können
  • GeoGebra-Animation, wenn etwas automatisch abläuft

Autor:innen

Die Redakteure werden immer genannt. Der/Die Hauptautor:in wird ggf. ergänzt und steht an erster Stelle.

Suche

v
10.6
o-mathe.de/omathe/dokumentation
o-mathe.de/10.6

Rückmeldung geben