feat: Update CSV I project chapter

Author: schnaitter

040-Projekt_CSV_I/000-Einleitung.md

@@ -0,0 +1,26 @@
+---
+numbering:
+    heading_1: true
+    heading_2: true
+    title: true
+---
+
+# Projekt: Zählen einer ISBN in einem Datensatz (CSV)
+
+```{seealso} 🎓 Lernziele
+:icon: false
+
+In diesem Kapitel erlernen Sie, …
+
+- … wie Sie mit Dateien umgehen können.
+- … wie Sie CSV-Dateien "von Hand" verarbeiten.
+- … wie Ihre Skripte Kommandozeilen-Parameter nutzen können.
+
+```
+
+```{hint} 📝 Kleine Aufgabe
+:icon: false
+
+Die Aufgabe am Endes dieses Kapitels kann als Kleine Aufgabe angerechnet werden.
+
+```

040-Projekt_CSV_I/010-Dateiformat.md

@@ -0,0 +1,63 @@
+---
+short_title: CSV
+numbering:
+    heading_1: true
+    heading_2: true
+    title: true
+---
+
+# Dateiformat CSV
+
+Das Dateiformat CSV (_comma separated values_, `.csv`) ist ein gängiges Format für den
+Austausch tabellarischer Daten. Wie der Name sagt nutzt eine "klassische"
+CSV-Datei Kommata für die Trennung von einzelnen Werten (Spalten). Oft wird
+aber auch ein Semikolon genutzt.
+
+## Struktur einer CSV-Datei
+
+Eine CSV-Datei sieht typischerweise so aus:
+
+Alle Werte in der CSV-Datei werden als Text (Zeichenkette, String)
+abgespeichert und auch so eingelesen. Sollen manche Werte/Spalten bspw. als
+Zahl interpretiert werden, so muss diese Transformation explizit durchgeführt
+werden.
+
+Ein Datensatz entspricht in einer CSV-Datei immer einer Zeile in der Datei. Die
+Reihenfolge der Zeilen ist normalerweise nicht sinntragend, d.h. wenn ein
+anderer Datensatz "referenziert" werden soll, dann sollte dies über eindeutige
+IDs in Schlüsselspalten geschehen und nicht über einen Zeilen-Index.
+
+Zellen können Leerzeichen enthalten. Zellen können optional mit doppelten
+Anführungsstrichen umschlossen sein. Dann können auch Zeichen wie `,` oder `\r`
+(CR, Carriage Return),`\n` (LF, Line Feed, Newline) in der Zelle stehen. Manche
+Programme können jedoch nicht mit solchen Dateien umgehen, weshalb dies nicht
+unbedingt empfohlen wird. Dies ist auch einer der Gründe, warum häufig ein
+Semikolon für die Spalten-Trennung genutzt wird. Das Semikolon wird innerhalb
+typischer Daten viel seltener genutzt als das Komma.
+
+## Beispieldateien
+
+```csv
+id, family name, given name, birthdate
+0, musterfrau, martha, 1.2.2003
+1, müller, kim, 1999-8-7
+2, 王, 祖寇, February 21, 2005
+```
+
+```csv
+index;date;time;temp
+2;2025-10-10;11:51:02;21.4
+3;2025-10-10;11:51:12;21.5
+6;2025-10-10;11:57:05;21.1
+7;2025-10-10;11:57:20;21.6
+```
+
+Es gibt auch das verwandte Dateiformat TSV (_tabulator separated values_, `.tsv`), welches einen Tabulator (`\t`) als Trennzeichen nutzt.
+
+```tsv
+Matrikel Nr.\tNachname\tVorname\tAdresse\tHZB
+123456\tAa-Bb\tCcc\tMuster Str. 7b\t2,4
+234567\tAa\tDdd\tDeppendorf 12\t1,0
+345678\tBb\tEee\tAlexanderplatz 4\t1,3
+
+```

040-Projekt_CSV_I/020-Dateien_öffnen.ipynb

@@ -0,0 +1,41 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "ea9b1de2-17ee-40aa-a796-706cedce3a8d",
+   "metadata": {},
+   "source": [
+    "---\n",
+    "numbering:\n",
+    "    heading_1: true\n",
+    "    heading_2: true\n",
+    "    title: true\n",
+    "---\n",
+    "# Dateien öffnen\n",
+    "\n",
+    "Um im Verlauf des Kapitels mit einer CSV-Datei arbeiten zu können müssen wir diese öffnen und deren Inhalt lesen können.\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.13.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

040-Projekt_CSV_I/Einleitung.md

@@ -23,13 +23,16 @@ project:
         - file: 020-Projekt_Taschenrechner_I/040-Jupyter_Notebooks.ipynb
         - file: 020-Projekt_Taschenrechner_I/050-Ausführbare_Skripte.md
     - file: 030-Exkurs_Unix/Einleitung.md
+    - file: 040-Projekt_CSV_I/000-Einleitung.md
+      children:
+        - file: 040-Projekt_CSV_I/010-Dateiformat.md
+        - file: 040-Projekt_CSV_I/020-Dateien_öffnen.ipynb
     - file: 045-Projekt_Taschenrechner_II/010-Taschenrechner.ipynb
       children:
             - file: 045-Projekt_Taschenrechner_II/020-Nutzerinneneingabe.ipynb
             - file: 045-Projekt_Taschenrechner_II/030-Schleifen.ipynb
             - file: 045-Projekt_Taschenrechner_II/040-Implementierung.ipynb
             - file: 045-Projekt_Taschenrechner_II/050-Aufgabe_Erweiterung.md
-    - file: 040-Projekt_CSV_I/Einleitung.md
     - file: 050-Exkurs_Git/Einleitung.md
     - file: 060-Projekt_CSV_II/Einleitung.md
     - file: 070-Projekt_MARC-XML/Einleitung.md