Skip to content

Commit c68a7c4

Browse files
committed
chore: Cleanup of frontmatter
1 parent b224552 commit c68a7c4

26 files changed

Lines changed: 3351 additions & 24 deletions

000-Einleitung/Einleitung.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# Einleitung

000-Einleitung/Kursinhalte.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# Kursinhalte

000-Einleitung/Spezifika_Fernstudium.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# Spezifika für Studierende des Fernstudiums

010-Installation_Technik/Einleitung.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# Installation und technische Voraussetzungen

010-Installation_Technik/JupyterHub.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# JupyterHub der Humboldt-Universität Berlin

010-Installation_Technik/JupyterLab.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# Die JupyterLab-Oberfläche

010-Installation_Technik/Lokale_Installation.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# Lokale Installation

030-Exkurs_Unix/Einleitung.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,6 @@ numbering:
33
heading_1: true
44
heading_2: true
55
title: true
6-
figure:
7-
template: Abb. %s
86
---
97

108
# Exkurs: Unix
Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
numbering:
3+
heading_1: false
4+
heading_2: true
5+
title: false
6+
---
7+
8+
# Was ist Versionskontrolle?
9+
10+
## Das Problem
11+
12+
Wer kennt das nicht? Man arbeitet an einem Python-Skript, speichert verschiedene Versionen und am Ende sieht der Dateiordner so aus:
13+
14+
```
15+
taschenrechner.py
16+
taschenrechner_v2.py
17+
taschenrechner_v2_neu.py
18+
taschenrechner_v3.py
19+
taschenrechner_final.py
20+
taschenrechner_wirklich_final.py
21+
taschenrechner_wirklich_final_v2.py
22+
```
23+
24+
Bei dieser Arbeitsweise verliert man schnell den Überblick:
25+
- Welche Datei enthält welche Änderungen?
26+
- Warum wurde etwas geändert?
27+
- Wie komme ich zu einer älteren Version zurück?
28+
- Wie kann ich mit anderen zusammenarbeiten, ohne die Arbeit der anderen zu überschreiben?
29+
30+
## Die Lösung: Versionskontrollsysteme
31+
32+
**Versionskontrollsysteme** (auch Version Control Systems oder VCS) lösen diese Probleme, indem sie:
33+
34+
- **Alle Änderungen protokollieren**: Jede Änderung wird mit Zeitstempel, Autor\*in und Beschreibung gespeichert
35+
- **Versionen verwalten**: Man kann zu jeder beliebigen früheren Version zurückkehren
36+
- **Zusammenarbeit ermöglichen**: Mehrere Personen können gleichzeitig am selben Projekt arbeiten
37+
- **Änderungen nachvollziehbar machen**: Man sieht genau, wer was wann und warum geändert hat
38+
39+
## Git: Das Standard-Versionskontrollsystem
40+
41+
**Git** ist das heute meistgenutzte Versionskontrollsystem. Es wurde 2005 von Linus Torvalds (dem Erfinder von Linux) entwickelt und ist:
42+
43+
- **Dezentral**: Jede\*r hat eine vollständige Kopie der gesamten Versionsgeschichte
44+
- **Schnell**: Die meisten Operationen funktionieren lokal ohne Internetverbindung
45+
- **Flexibel**: Unterstützt verschiedene Arbeitsweisen und Workflows
46+
- **Open Source**: Kostenlos und frei verfügbar
47+
48+
## Git vs. GitHub/GitLab
49+
50+
Ein häufiges Missverständnis: **Git und GitHub sind nicht dasselbe!**
51+
52+
::::{grid}
53+
:gutter: 2
54+
55+
:::{grid-item-card} Git
56+
Das Versionskontrollsystem, das lokal auf Ihrem Computer läuft. Git speichert und verwaltet Versionen Ihrer Dateien.
57+
:::
58+
59+
:::{grid-item-card} GitHub/GitLab/Gitea
60+
Online-Plattformen, die Git-Repositories im Internet hosten. Sie bieten zusätzliche Funktionen wie:
61+
- Zentrale Ablage für gemeinsame Projekte
62+
- Web-Oberfläche zur Verwaltung
63+
- Kollaborations-Tools (Issues, Pull Requests)
64+
- Backup Ihrer Arbeit in der Cloud
65+
:::
66+
67+
::::
68+
69+
Man kann Git auch **ohne** GitHub/GitLab nutzen – rein lokal auf dem eigenen Computer. In diesem Kurs werden wir zunächst die lokale Nutzung kennenlernen, bevor wir uns mit Remote-Plattformen beschäftigen.
70+
71+
## Warum ist Git wichtig für Bibliotheks- und Informationswissenschaftler\*innen?
72+
73+
In der Bibliotheks- und Informationspraxis arbeiten Sie häufig mit:
74+
- **Skripten zur Datenverarbeitung**: Katalogdaten konvertieren, Statistiken erstellen
75+
- **Konfigurationsdateien**: Einstellungen für Bibliothekssysteme
76+
- **Dokumentation**: Anleitungen, Workflows, Best Practices
77+
78+
Git hilft dabei:
79+
- Änderungen an Skripten und Konfigurationen nachvollziehbar zu dokumentieren
80+
- Mit Kolleg\*innen an gemeinsamen Projekten zu arbeiten
81+
- Fehler rückgängig zu machen, ohne Panik zu bekommen
82+
- Code und Dokumentation zu teilen und weiterzuentwickeln
83+
84+
:::::{margin}
85+
**Hinweis**: Viele Open-Source-Bibliothekssysteme und -Tools werden über Git und GitHub/GitLab entwickelt. Wenn Sie diese Tools nutzen oder anpassen möchten, sind Git-Kenntnisse sehr hilfreich!
86+
:::::
87+
88+
## Lernziele dieses Exkurses
89+
90+
Nach diesem Exkurs können Sie:
91+
- Git lokal auf Ihrem Computer nutzen
92+
- Versionen Ihrer Python-Projekte verwalten
93+
- Änderungen nachvollziehen und rückgängig machen
94+
- Mit Remote-Repositories (GitHub/GitLab) arbeiten
95+
- Ihre Lösungen zu den Kursaufgaben versionieren
96+
97+
:::::{admonition} Optional, aber empfohlen
98+
:class: tip
99+
Dieser Exkurs ist optional, aber **stark empfohlen**. Einige spätere Übungen im Kurs setzen voraus, dass Sie mit Git umgehen können. Wenn Sie bereits Git-Erfahrung haben, können Sie diesen Exkurs überspringen oder als Nachschlagewerk nutzen.
100+
:::::
Lines changed: 190 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,190 @@
1+
---
2+
numbering:
3+
heading_1: false
4+
heading_2: true
5+
title: false
6+
---
7+
8+
# Installation und Konfiguration
9+
10+
## Git installieren
11+
12+
Bevor Sie Git nutzen können, müssen Sie es auf Ihrem Computer installieren. Möglicherweise ist Git bereits installiert – das prüfen wir gleich.
13+
14+
### Installation überprüfen
15+
16+
Öffnen Sie ein Terminal (siehe Kapitel [Exkurs: Unix](../030-Exkurs_Unix/Einleitung.md)) und geben Sie ein:
17+
18+
```bash
19+
git --version
20+
```
21+
22+
Wenn Git installiert ist, sehen Sie eine Ausgabe wie:
23+
24+
```
25+
git version 2.39.2
26+
```
27+
28+
Die genaue Versionsnummer kann variieren – wichtig ist nur, dass Git gefunden wurde.
29+
30+
### Git installieren (falls noch nicht vorhanden)
31+
32+
Falls Sie eine Fehlermeldung erhalten, müssen Sie Git noch installieren:
33+
34+
::::{tab-set}
35+
36+
:::{tab-item} macOS
37+
Git ist Teil der Xcode Command Line Tools. Geben Sie im Terminal ein:
38+
39+
```bash
40+
xcode-select --install
41+
```
42+
43+
Alternativ können Sie Git mit [Homebrew](https://brew.sh) installieren:
44+
45+
```bash
46+
brew install git
47+
```
48+
:::
49+
50+
:::{tab-item} Windows
51+
Laden Sie Git von der offiziellen Website herunter:
52+
[https://git-scm.com/download/win](https://git-scm.com/download/win)
53+
54+
Führen Sie das Installationsprogramm aus und verwenden Sie die Standard-Einstellungen.
55+
56+
**Tipp**: Bei der Installation wird auch "Git Bash" installiert – ein Terminal für Windows, das Unix-Befehle versteht.
57+
:::
58+
59+
:::{tab-item} Linux
60+
Git ist in den Paketquellen der meisten Distributionen enthalten:
61+
62+
**Ubuntu/Debian:**
63+
```bash
64+
sudo apt-get update
65+
sudo apt-get install git
66+
```
67+
68+
**Fedora:**
69+
```bash
70+
sudo dnf install git
71+
```
72+
73+
**Arch Linux:**
74+
```bash
75+
sudo pacman -S git
76+
```
77+
:::
78+
79+
::::
80+
81+
Weitere Installationsanleitungen finden Sie im Kapitel [Installation und Technik](../010-Installation_Technik/Einleitung.md).
82+
83+
## Git konfigurieren
84+
85+
Nach der Installation müssen Sie Git einmalig konfigurieren. Git speichert bei jedem Commit (=gespeicherte Version) Ihren Namen und Ihre E-Mail-Adresse. Das ist wichtig für die Nachvollziehbarkeit, besonders bei Zusammenarbeit.
86+
87+
### Grundkonfiguration: Name und E-Mail
88+
89+
Öffnen Sie ein Terminal und geben Sie folgende Befehle ein (ersetzen Sie die Beispieldaten durch Ihre eigenen):
90+
91+
```bash
92+
git config --global user.name "Erika Mustermann"
93+
git config --global user.email "erika.mustermann@example.com"
94+
```
95+
96+
:::::{margin}
97+
**Hinweis**: Das `--global`-Flag bedeutet, dass diese Einstellung für alle Git-Repositories auf Ihrem Computer gilt. Sie müssen dies nur einmal tun.
98+
:::::
99+
100+
### Konfiguration überprüfen
101+
102+
Um zu sehen, welche Einstellungen aktuell gespeichert sind:
103+
104+
```bash
105+
git config --list
106+
```
107+
108+
Oder nur Name und E-Mail anzeigen:
109+
110+
```bash
111+
git config user.name
112+
git config user.email
113+
```
114+
115+
### Optional: Standard-Texteditor festlegen
116+
117+
Git öffnet manchmal einen Texteditor, z.B. für Commit-Nachrichten. Sie können festlegen, welcher Editor verwendet werden soll:
118+
119+
```bash
120+
# Visual Studio Code
121+
git config --global core.editor "code --wait"
122+
123+
# Nano (einfacher Terminal-Editor)
124+
git config --global core.editor "nano"
125+
126+
# Vim (fortgeschrittener Terminal-Editor)
127+
git config --global core.editor "vim"
128+
```
129+
130+
:::::{admonition} Standard-Editor
131+
:class: tip
132+
Falls Sie keinen Editor festlegen, verwendet Git den Standard-Editor Ihres Systems (häufig Vim oder Nano). Vim kann für Anfänger\*innen verwirrend sein – wenn Sie sich unsicher sind, empfehlen wir Nano oder VS Code.
133+
:::::
134+
135+
### Optional: Standard-Branch-Name
136+
137+
Neuere Git-Versionen verwenden `main` als Standard-Name für den Haupt-Branch. Ältere Versionen nutzen `master`. Um Konsistenz zu gewährleisten:
138+
139+
```bash
140+
git config --global init.defaultBranch main
141+
```
142+
143+
### Optional: Farben aktivieren
144+
145+
Git kann Ausgaben farblich hervorheben (z.B. Änderungen in grün/rot):
146+
147+
```bash
148+
git config --global color.ui auto
149+
```
150+
151+
## Konfigurationsdatei
152+
153+
Alle globalen Einstellungen werden in einer Datei gespeichert:
154+
- **Linux/macOS**: `~/.gitconfig`
155+
- **Windows**: `C:\Users\IhrName\.gitconfig`
156+
157+
Sie können diese Datei auch direkt mit einem Texteditor bearbeiten. Sie sollte etwa so aussehen:
158+
159+
```ini
160+
[user]
161+
name = Erika Mustermann
162+
email = erika.mustermann@example.com
163+
[core]
164+
editor = nano
165+
[init]
166+
defaultBranch = main
167+
[color]
168+
ui = auto
169+
```
170+
171+
## Zusammenfassung
172+
173+
Nach diesen Schritten ist Git einsatzbereit! Die wichtigsten Befehle waren:
174+
175+
```bash
176+
# Git-Version prüfen
177+
git --version
178+
179+
# Name und E-Mail konfigurieren (erforderlich)
180+
git config --global user.name "Ihr Name"
181+
git config --global user.email "ihre.email@example.com"
182+
183+
# Konfiguration anzeigen
184+
git config --list
185+
```
186+
187+
:::::{admonition} Bereit für den nächsten Schritt
188+
:class: success
189+
Git ist jetzt installiert und konfiguriert. Im nächsten Kapitel lernen Sie die grundlegenden Konzepte kennen, die Git zugrunde liegen.
190+
:::::

0 commit comments

Comments
 (0)