feat: Clean up notebook and add REPL diagram

Author: schnaitter

020-Projekt_Taschenrechner/010-Python_REPL.ipynb

@@ -5,7 +5,6 @@
    "id": "ba0180d5",
    "metadata": {
     "editable": true,
-    "jp-MarkdownHeadingCollapsed": true,
     "slideshow": {
      "slide_type": ""
     },
@@ -18,8 +17,6 @@
     "    heading_1: true\n",
     "    heading_2: true\n",
     "    title: true\n",
-    "    figure:\n",
-    "        template: Abb. %s\n",
     "---\n",
     "\n",
     "# Die Read-Eval-Print-Loop (REPL)\n",
@@ -31,15 +28,16 @@
     "## Starten der Python REPL\n",
     "\n",
     ":::::{margin}\n",
-    "::::{admonition} Wiederholung\n",
-    ":class: seealso\n",
+    "::::{seealso} Terminal-Nutzung\n",
     "Im gesamten Kurs werden Eingaben im Terminal wie folgt dargestellt:\n",
     ":::console\n",
     "$ echo \"Hallo Welt\"\n",
     "Hallo Welt\n",
     ":::\n",
     "Dabei beginnen Zeilen mit einem Terminal-Befehl mit `$ ` und darauffolgende Zeilen bis zum nächsten `$ ` die Ausgabe des Befehls. Wenn Sie die Schritte nachvollziehen, geben Sie den Befehl selbst ein und 'starten' diesen mit `<Enter>`.\n",
     "\n",
+    "Es werden nicht alle Ausgaben (vollständig) dargestellt.\n",
+    "\n",
     "Achten Sie darauf, dass Sie ggf. Dateipfade anpassen müssen. Mehr dazu im [Exkurs: Unix](/030-Exkurs_Unix/Einleitung.md).\n",
     "::::\n",
     ":::::\n",
@@ -88,21 +86,85 @@
     "\n",
     "## Die Struktur einer REPL\n",
     "\n",
-    "Eine REPL ist ein Programm, welches:\n",
+    "Eine REPL (siehe {numref}`fig:repl`) ist ein Programm, welches:\n",
     "\n",
     "1. _**R**ead_: Einen Befehl oder hier ein Stück Python-Code einliest.\n",
     "2. _**E**val_: Dann den Code ausführt.\n",
     "3. _**P**rint_: Das Ergebnis des ausgeführten Codes zurück gibt.\n",
-    "4. _**L**oop_: Und das solange wiederholt, bis es beendet wird (bei Python via `quit()`).\n",
-    "\n",
-    "TODO: Abbildung REPL\n",
-    "\n",
-    "TODO: genauere Erklärung des Ablaufs von bspw. `print(\"Hallo\")`.\n",
+    "4. _**L**oop_: Und das solange wiederholt, bis es beendet wird (bei Python via `quit()`).\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e38bcd2d-773b-46bd-892a-07d44d9622f2",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "::::{figure}\n",
+    ":name: fig:repl\n",
+    "```mermaid\n",
+    "flowchart LR\n",
     "\n",
-    "## Lernstandskontrolle\n",
+    "start((Start)) --> R[Read]\n",
+    "R --> E[Eval]\n",
+    "E --> P[Print]\n",
+    "P --> L{Loop<br>?}\n",
+    "L -->|yes| R\n",
+    "L -->|no| stop((Stop))\n",
+    "```\n",
     "\n",
-    "```{code-cell}\n",
-    ":tags: [remove-cell]\n",
+    "Ablaufdiagramm der Bestandteile einer REPL\n",
+    "::::"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c0730c44-1c2a-439d-a146-00d8d3e37307",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "TODO: genauere Erklärung des Ablaufs von bspw. `print(\"Hallo\")`."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "099f1f56-f189-4be3-8a58-e888507e9169",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "## Lernstandskontrolle"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1281feb0-3f98-4346-bc83-76223658319f",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": [
+     "remove-cell"
+    ]
+   },
+   "outputs": [],
+   "source": [
     "from jupyterquiz import display_quiz\n",
     "c = { '--jq-multiple-choice-bg': '#202080',\n",
     "      '--jq-mc-button-bg': '#fafafa',\n",
@@ -117,11 +179,24 @@
     "      '--jq-incorrect-color': '#c80202',\n",
     "      '--jq-correct-color': '#009113',\n",
     "      '--jq-text-color': '#fafafa',\n",
-    "      '--jq-link-color': '#9abafa' }\n",
-    "```\n",
-    "\n",
-    "```{code-cell}\n",
-    ":tags: [remove-input]\n",
+    "      '--jq-link-color': '#9abafa' }"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1ee1c360-0a38-42ef-a11c-316edd98c058",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": [
+     "remove-input"
+    ]
+   },
+   "outputs": [],
+   "source": [
     "q = [{\n",
     "        \"question\": \"Welche Ausgabe erhalten Sie, wenn Sie <pre>>>> 3**3</pre> in die REPL eingeben?\",\n",
     "        \"type\": \"multiple_choice\",\n",
@@ -153,8 +228,7 @@
     "              \"feedback\": \"Korrekt. Wie in der Fehlermeldung angegeben ist die Variable `test` nicht definiert, weshalb Sie deren Wert nicht auslesen können.\"},\n",
     "        ]\n",
     "    }]\n",
-    "display_quiz(q, colors=c)\n",
-    "```"
+    "display_quiz(q, colors=c)"
    ]
   }
  ],