feat: Cleanup, formatting, typos and and small clarifications

Author: schnaitter

020-Projekt_Taschenrechner/000-Einleitung.md

@@ -25,27 +25,35 @@ In diesem Kapitel erlernen Sie, …
 ```{hint} 📝 Kleine Aufgabe 1
 :icon: false
 
-Die [Aufgabe am Ende des Kapitels](./070-Aufgabe_Erweiterung) kann als Kleine Aufgabe abgegeben werden.
+Die [Aufgabe am Ende des Kapitels](./070-Aufgabe_Erweiterung) kann als Kleine
+Aufgabe abgegeben werden.
+
 ```
 
 ```{hint} 📝 Kleine Aufgabe 2
 :icon: false
 
-Protokollieren Sie Ihre Nutzung des Kurses. Formulieren Sie, wie Sie an Aufgaben herangegangen sind und wo Sie Probleme hatten.
+Protokollieren Sie Ihre Nutzung des Kurses. Formulieren Sie, wie Sie an
+Aufgaben herangegangen sind und wo Sie Probleme hatten.
 
 - Welche Informationen haben Ihnen wo gefehlt?
-- Haben Sie die Informationen selbst recherchieren können oder sind Sie "stecken geblieben"?
+- Haben Sie die Informationen selbst recherchieren können oder sind Sie
+  "stecken geblieben"?
 - Wo ging es Ihrer Meinung nach zu schnell? Wo zu langsam?
-- Der Kurs übergeht (teilw. absichtlich) bestimmte Details. Sind Ihnen diese Sprünge aufgefallen und war das schlimm?
+- Der Kurs übergeht (teilw. absichtlich) bestimmte Details. Sind Ihnen diese
+  Sprünge aufgefallen und war das schlimm?
+
+Arbeiten Sie die ersten Kapitel des Kurses für insg. mindestens 3 Stunden durch
+und geben Sie Feedback.
 
-Arbeiten Sie die ersten Kapitel des Kurses für insg. mindestens 3 Stunden durch und geben Sie Feedback.
 ```
 
 ```{note} Projektziel
 
-Ziel des Projekts ist es, einen Taschenrechner zu entwickeln, der Berechnungen
-per Standardeingabe einliest und die Berechnungsergebnisse ausgibt. Er soll
-einfache arithmetische Operationen unterstützen.
+Ziel des Projekts ist es, einen Taschenrechner zu entwickeln, in den die
+Nutzer\*in Operatoren und Operanden eingeben kann und welcher dann die
+jeweiligen Berechnungsergebnisse ausgibt. Er soll einfache arithmetische
+Operationen unterstützen.
 
 ```
 
@@ -61,14 +69,3 @@ und bringen dann alles gelernte im
 schließt mit einer Aufgabe zur [Erweiterung des
 Taschenrechners](./070-Aufgabe_Erweiterung.md) um verschiedene
 Funktionalitäten.
-
-- Mathematische Operationen
-    - `+`, `-`, `*`, `/`
-    - `%`, `//`
-    - `**`
-- Zahlen
-    - `int()`
-    - `float()`
-- `def`
-- `import`
-- `if __name__=="__main__":`

020-Projekt_Taschenrechner/010-Python_REPL.ipynb

@@ -34,11 +34,15 @@
     "$ 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",
+    "Dabei beginnen Zeilen mit einem Terminal-Befehl mit `$ ` und darauffolgende\n",
+    "Zeilen bis zum nächsten `$ ` die Ausgabe des Befehls. Wenn Sie die Schritte\n",
+    "nachvollziehen, geben Sie den Befehl selbst ein und 'starten' diesen mit\n",
+    "{kbd}`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",
+    "Achten Sie darauf, dass Sie ggf. Dateipfade anpassen müssen. Mehr dazu im\n",
+    "[Exkurs: Unix](/030-Exkurs_Unix/Einleitung.md).\n",
     "::::\n",
     ":::::\n",
     "\n",
@@ -51,13 +55,17 @@
     ">>>\n",
     "```\n",
     "\n",
-    "Um die REPL zu verlassen, tippen Sie `quit()` oder nutzen Sie (in Unix-basierten Betriebssysteme) die Tastekombination `<Strg-D>`.\n",
+    "Um die REPL zu verlassen, tippen Sie `quit()` oder nutzen Sie (in\n",
+    "Unix-basierten Betriebssysteme) die Tastekombination {kbd}`Strg`+{kbd}`D`.\n",
     "\n",
     "## Ihr erstes Python\n",
     "\n",
-    "Die REPL verhält sich ähnlich zum Terminal, nur dass nicht Befehle nach (typischerweise) einem \"`$ `\" eingegeben werden, sondern dass Python-Code nach einem \"`>>> `\" eingegeben wird.\n",
+    "Die REPL verhält sich ähnlich zum Terminal, nur dass nicht Befehle nach\n",
+    "(typischerweise) einem \"`$ `\" eingegeben werden, sondern dass Python-Code nach\n",
+    "einem \"`>>> `\" eingegeben wird.\n",
     "\n",
-    "Nachfolgend finden Sie ein paar Beispiele. Probieren Sie diese selbst aus und ändern Sie sie dann ab.\n",
+    "Nachfolgend finden Sie ein paar Beispiele. Probieren Sie diese selbst aus und\n",
+    "ändern Sie sie dann ab.\n",
     "\n",
     "```python-repl\n",
     ">>> 2+2\n",
@@ -91,7 +99,8 @@
     "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"
+    "4. _**L**oop_: Und das solange wiederholt, bis es beendet wird (bei Python via\n",
+    "   `quit()`).\n"
    ]
   },
   {
@@ -139,16 +148,32 @@
     "   ```bash\n",
     "   $ python3\n",
     "   ```\n",
-    "2. Python startet, gibt die Versionsinformationen aus und zeigt Ihnen mit dem Prompt `>>> ` an, dass es zum Einlesen eines Python-Ausdrucks bereit ist. Die REPL ist nun im Zustand _Read_.\n",
+    "2. Python startet, gibt die Versionsinformationen aus und zeigt Ihnen mit dem\n",
+    "   Prompt `>>> ` an, dass es zum Einlesen eines Python-Ausdrucks bereit ist.\n",
+    "   \n",
+    "   Die REPL ist nun im Zustand _Read_.\n",
     "3. Sie können nun einen Python-Ausdruck eingeben. Dieser kann `print(\"Hallo\")` sein oder aber auch\n",
     "   ```\n",
     "   >>> print(\n",
     "   ...   \"Hallo\"\n",
     "   ... )\n",
     "   ```\n",
-    "   Während Sie den Ausdruck eingeben bleibt die REPL im Status _Read_. Haben Sie einen vollständigen Ausdruck eingegeben (Wann ein Ausdruck \"vollständig\" ist lernen Sie später.) und drücken Sie dann die Eingabetaste, so wechselt die REPL in den Zustand _Eval_.\n",
-    "4. Bei der Evaluation des Python-Ausdrucks versucht der Interpreter, den Code auszuführen. Ist er korrekt (und bezieht sich nur auf Namen(/Variablen), die bereits definiert wurden), so wird der Code ausgeführt. Nachdem der Code ausgeführt wurde wechselt die REPL in den Zustand _Print_ und es wird das **Ergebnis** des gerade ausgeführten Python-Codes gedruckt.\n",
-    "5. Dann wird in den Zustand _Loop_ gewechselt und überprüft, ob eine Abbruchbedingung erreicht wurde. Ist dies nicht der Fall – soll also wieder von Anfang begonnen werden so wechselt die REPL zurück in den Zustand _Read_ und der Ablauf springt damit zu Schritt 2. Soll die Schleife nicht fortgesetzt werden, so geht die REPL über in den Zustand _Stop_ und der Python-Interpreter wird beendet."
+    "   \n",
+    "   Während Sie den Ausdruck eingeben bleibt die REPL im Status _Read_. Haben\n",
+    "   Sie einen vollständigen Ausdruck eingegeben (Wann ein Ausdruck \"vollständig\"\n",
+    "   ist lernen Sie später.) und drücken Sie dann die Eingabetaste, so wechselt\n",
+    "   die REPL in den Zustand _Eval_.\n",
+    "4. Bei der Evaluation des Python-Ausdrucks versucht der Interpreter, den Code\n",
+    "   auszuführen. Ist er korrekt (und bezieht sich nur auf Namen(/Variablen), die\n",
+    "   bereits definiert wurden), so wird der Code ausgeführt. Nachdem der Code\n",
+    "   ausgeführt wurde wechselt die REPL in den Zustand _Print_ und es wird das\n",
+    "   **Ergebnis** des gerade ausgeführten Python-Codes gedruckt.\n",
+    "5. Dann wird in den Zustand _Loop_ gewechselt und überprüft, ob eine\n",
+    "   Abbruchbedingung erreicht wurde. Ist dies nicht der Fall – soll also wieder\n",
+    "   von Anfang begonnen werden so wechselt die REPL zurück in den Zustand _Read_\n",
+    "   und der Ablauf springt damit zu Schritt 2. Soll die Schleife nicht fortgesetzt\n",
+    "   werden, so geht die REPL über in den Zustand _Stop_ und der Python-Interpreter\n",
+    "   wird beendet."
    ]
   },
   {
@@ -173,7 +198,9 @@
     "**Nachvollziehen der Zustände der REPL**\n",
     "::::{admonition} 💪 Übung\n",
     ":icon: false\n",
-    "Nachvollziehen Sie die nachfolgende REPL-Interaktion. Was sind Ausgaben per `print` und was sind Ausgaben durch den Zustand _Print_ der REPL?\n",
+    "\n",
+    "Nachvollziehen Sie die nachfolgende REPL-Interaktion. Was sind Ausgaben per\n",
+    "`print` und was sind Ausgaben durch den Zustand _Print_ der REPL?\n",
     "\n",
     "```python-repl\n",
     ">>> hallo = \"Hallo Python-Lernende\"      # 1\n",
@@ -187,30 +214,53 @@
     "```\n",
     "\n",
     ":::{dropdown} ✅ Lösung\n",
-    "_**zu 1:**_ Hier wird eine Variable mit dem Namen `hallo` erzeugt in der das String-Literal `\"Hallo Python-Lernende\"` gespeichert wird. Dieser Ausdruck hat kein Ergebnis, weshalb nach der Zeile sofort der Prompt für die nächste Eingabe angezeigt wird.\n",
     "\n",
-    "_**zu 2:**_ Hier besteht der Python-Ausdruck nur aus der Variablen mit dem Namen `hallo`. Eine Variable hat ihren Wert als Ergebnis, weshalb im Zustand _Print_ der REPL das String-Literat `'Hallo Python-Lernende'` ausgegeben wird (siehe _**3**_).\n",
+    "_**zu 1:**_ Hier wird eine Variable mit dem Namen `hallo` erzeugt in der das\n",
+    "String-Literal `\"Hallo Python-Lernende\"` gespeichert wird. Dieser Ausdruck hat\n",
+    "kein Ergebnis, weshalb nach der Zeile sofort der Prompt für die nächste Eingabe\n",
+    "angezeigt wird.\n",
+    "\n",
+    "_**zu 2:**_ Hier besteht der Python-Ausdruck nur aus der Variablen mit dem\n",
+    "Namen `hallo`. Eine Variable hat ihren Wert als Ergebnis, weshalb im Zustand\n",
+    "_Print_ der REPL das String-Literat `'Hallo Python-Lernende'` ausgegeben wird\n",
+    "(siehe _**3**_).\n",
     "\n",
-    "Beachten Sie, dass in Python Strings entweder mit `'` oder mit `\"` umschlossen werden können. Sie sind gleichwertig und die Verwendung ist nur relevant, wenn der String selbst ein `'` oder ein `\"` enthält. Der String `\"Wie geht's?\"` müssten mit einfachen Anführungszeichen mit Hilfe eines sog. Escape-Zeichens geschrieben werden: `'Wie geht\\'s?'`. Anders herum wäre es bei diesem String: `\"Sie sagte: \\\"Hallo.\\\"\"` bzw. `'Sie sagte: \"Hallo.\"'`.\n",
+    "Beachten Sie, dass in Python Strings entweder mit `'` oder mit `\"` umschlossen\n",
+    "werden können. Sie sind gleichwertig und die Verwendung ist nur relevant, wenn\n",
+    "der String selbst ein `'` oder ein `\"` enthält. Der String `\"Wie geht's?\"`\n",
+    "müssten mit einfachen Anführungszeichen mit Hilfe eines sog. Escape-Zeichens\n",
+    "geschrieben werden: `'Wie geht\\'s?'`. Anders herum wäre es bei diesem String:\n",
+    "`\"Sie sagte: \\\"Hallo.\\\"\"` bzw. `'Sie sagte: \"Hallo.\"'`.\n",
     "\n",
-    "_**zu 4:**_ Hier wird die Funktion `print()` genutzt um den Wert der Variablen `hallo` zu drucken. Dies geschieht im Zustand _Eval_ und die Ausgabe dazu ist in _**5**_ zu sehen. Die Funktion `print()` hat selbst kein Ergebnis, weshalb nichts zusätzliches durch den Zustand _Print_ ausgegeben wird.\n",
+    "_**zu 4:**_ Hier wird die Funktion `print()` genutzt um den Wert der Variablen\n",
+    "`hallo` zu drucken. Dies geschieht im Zustand _Eval_ und die Ausgabe dazu ist\n",
+    "in _**5**_ zu sehen. Die Funktion `print()` hat selbst kein Ergebnis, weshalb\n",
+    "nichts zusätzliches durch den Zustand _Print_ ausgegeben wird.\n",
+    "\n",
+    "_**zu 6:**_ In diesem Schritt wird wie beim ersten Beispiel die Funktion\n",
+    "`print()` mit einem String-Literal genutzt. Die Ausgabe in _**7**_ ist von der\n",
+    "Version, die die Variable `hallo` nutzt nicht zu unterscheiden.\n",
     "\n",
-    "_**zu 6:**_ In diesem Schritt wird wie beim ersten Beispiel die Funktion `print()` mit einem String-Literal genutzt. Die Ausgabe in _**7**_ ist von der Version, die die Variable `hallo` nutzt nicht zu unterscheiden.\n",
     "::: \n",
     "\n",
-    ":::: \n"
+    ":::: \n",
+    "\n"
    ]
   },
   {
    "cell_type": "markdown",
    "id": "4a49e5c5-3f23-4f83-9a51-3ab4f70db039",
    "metadata": {},
    "source": [
-    "\n",
     ":::{hint} Kommentare in Python-Code\n",
-    "Die Zahlen am Ende eines Ausdrucks (bspw. `# 1`) sind ein Kommentar, um in der Musterlösung einzelne Zeilen referenzieren zu können.\n",
     "\n",
-    "In Python beginnen Kommentare mit einem `#` und es wir alles bis zum Zeilenende vom Interpreter ignoriert. Kommentare sind für Menschen, die den Code lesen gedacht und nicht für den Computer.\n",
+    "Die Zahlen am Ende eines Ausdrucks (bspw. `# 1`) sind ein Kommentar, um in der\n",
+    "Musterlösung einzelne Zeilen referenzieren zu können.\n",
+    "\n",
+    "In Python beginnen Kommentare mit einem `#` und es wir alles bis zum Zeilenende\n",
+    "vom Interpreter ignoriert. Kommentare sind für Menschen, die den Code lesen\n",
+    "gedacht und nicht für den Computer.\n",
+    "\n",
     "::: \n",
     "\n",
     "\n"