Skip to content

Commit 8fc3513

Browse files
vsvito420vsvito420
committed
Aktualisiere Anleitungen mit verlinkten Inhaltsverzeichnissen und besserer Formatierung
1 parent 1b296d4 commit 8fc3513

3 files changed

Lines changed: 284 additions & 0 deletions

File tree

‎Anleitungen/01_Kommentare.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# Python Kommentare 💬
2+
3+
## Inhaltsverzeichnis
4+
- [Einzeilige Kommentare](#einzeilige-kommentare)
5+
- [Mehrzeilige Kommentare](#mehrzeilige-kommentare)
6+
- [Best Practices](#best-practices)
7+
- [Beispiele](#beispiele)
8+
9+
---
10+
11+
Nächstes Thema: [Algorithmen](/Anleitungen/02_Algorithmen.md)
12+
13+
---
14+
15+
Python bietet verschiedene Möglichkeiten, Code zu kommentieren. Kommentare sind wichtig, um deinen Code zu dokumentieren und anderen (oder dir selbst in der Zukunft) zu erklären, was dein Code tut.
16+
17+
## Einzeilige Kommentare
18+
19+
Einzeilige Kommentare beginnen mit dem `#` Symbol:
20+
21+
```python
22+
# Dies ist ein einzeiliger Kommentar
23+
x = 5 # Kommentar am Ende einer Code-Zeile
24+
```
25+
26+
Alles nach dem `#` wird vom Python-Interpreter ignoriert und dient nur zur Information für Menschen, die den Code lesen.
27+
28+
## Mehrzeilige Kommentare
29+
30+
Mehrzeilige Kommentare werden mit dreifachen Anführungszeichen erstellt:
31+
32+
```python
33+
"""
34+
Dies ist ein mehrzeiliger
35+
Kommentar über
36+
mehrere Zeilen
37+
"""
38+
```
39+
40+
Diese Art von Kommentaren wird auch für Docstrings verwendet, um Funktionen und Module zu dokumentieren.
41+
42+
## Best Practices
43+
44+
Hier sind einige bewährte Praktiken für das Schreiben von Kommentaren: 📝
45+
46+
- Kommentare sollten kurz und präzise sein
47+
- Kommentare erklären das "Warum", nicht das "Was"
48+
- Verwende aussagekräftige Variablen- und Funktionsnamen statt unnötiger Kommentare
49+
- Halte Kommentare aktuell, wenn du deinen Code änderst
50+
- Nutze Kommentare, um komplexe Algorithmen oder Entscheidungen zu erklären
51+
- Verwende Docstrings für Funktionen und Module
52+
53+
## Beispiele
54+
55+
Hier sind einige Beispiele für gute Kommentare:
56+
57+
```python
58+
def calculate_sum(a, b):
59+
# Addiere zwei Zahlen und gib das Ergebnis zurück
60+
return a + b
61+
62+
"""
63+
Diese Funktion berechnet
64+
die Summe zweier Zahlen
65+
und gibt das Ergebnis zurück
66+
"""
67+
68+
# Konstanten für die Berechnung der Mehrwertsteuer
69+
TAX_RATE = 0.19 # 19% Mehrwertsteuer in Deutschland
70+
71+
# Schlechtes Beispiel - unnötiger Kommentar
72+
x = x + 1 # Erhöhe x um 1
73+
74+
# Gutes Beispiel - erklärt das Warum
75+
retry_count = retry_count + 1 # Erhöhe Wiederholungszähler nach fehlgeschlagenem Netzwerkversuch
76+
```
77+
78+
---
79+
80+
Kommentare sind ein wichtiger Teil des Programmierens und helfen dir, deinen Code verständlicher und wartbarer zu machen. Nutze sie weise! 🧠

‎Anleitungen/02_Algorithmen.md‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# Eigenschaften von Algorithmen 🧮
2+
3+
## Inhaltsverzeichnis
4+
- [Eindeutigkeit](#eindeutigkeit)
5+
- [Finitheit](#finitheit)
6+
- [Terminierung](#terminierung)
7+
- [Determinismus](#determinismus)
8+
- [Determiniertheit](#determiniertheit)
9+
- [Ausführbarkeit](#ausführbarkeit)
10+
- [Beispiele für Algorithmen](#beispiele-für-algorithmen)
11+
12+
---
13+
14+
Vorheriges Thema: [Python Kommentare](/Anleitungen/01_Kommentare.md) | Nächstes Thema: [Python Interpreter](/Anleitungen/03_python_interpreter.md)
15+
16+
---
17+
18+
Ein Algorithmus ist eine eindeutige Handlungsvorschrift zur Lösung eines Problems oder einer Klasse von Problemen. Algorithmen bestehen aus endlich vielen, wohldefinierten Einzelschritten. Damit können sie zur Ausführung in ein Computerprogramm implementiert werden.
19+
20+
## Eindeutigkeit
21+
22+
- Ein Algorithmus muss klare und eindeutige Anweisungen haben, damit jeder genau weiß, was zu tun ist. 🔍
23+
- Es darf keine Verwirrung oder Mehrdeutigkeit geben.
24+
- Beispiel: "Addiere 5 zu x" ist eindeutig, "Mache x größer" ist nicht eindeutig.
25+
26+
## Finitheit
27+
28+
- Ein Algorithmus muss in einer begrenzten Anzahl von Schritten fertig sein. ⏱️
29+
- Er darf nicht unendlich viele Schritte benötigen.
30+
- Die Beschreibung des Algorithmus muss endlich sein.
31+
32+
## Terminierung
33+
34+
- Ein Algorithmus muss immer zu einem Ende kommen und ein Ergebnis liefern. 🏁
35+
- Er darf nicht für immer weiterlaufen.
36+
- Für jede gültige Eingabe muss der Algorithmus nach endlich vielen Schritten anhalten.
37+
38+
## Determinismus
39+
40+
- Wenn man einen Algorithmus mit den gleichen Eingaben ausführt, sollte immer das gleiche Ergebnis herauskommen. 🔄
41+
- Der Algorithmus muss vorhersehbar sein.
42+
- Zufallsalgorithmen sind eine Ausnahme, aber auch sie folgen bestimmten Wahrscheinlichkeitsverteilungen.
43+
44+
## Determiniertheit
45+
46+
- Jeder Schritt im Algorithmus muss genau festgelegt sein. 📋
47+
- Es darf keine Unsicherheiten geben, was als Nächstes passiert.
48+
- Nach jedem Schritt muss klar sein, welcher Schritt als nächstes folgt oder ob der Algorithmus beendet ist.
49+
50+
## Ausführbarkeit
51+
52+
- Ein Algorithmus muss so geschrieben sein, dass ein Computer oder Mensch ihn tatsächlich ausführen kann. 💻
53+
- Jeder einzelne Schritt muss ausführbar sein.
54+
- Die benötigten Ressourcen (Zeit, Speicher) müssen realistisch sein.
55+
56+
## Beispiele für Algorithmen
57+
58+
Hier sind einige Beispiele für einfache Algorithmen:
59+
60+
1. **Summe berechnen**:
61+
```
62+
1. Setze Summe = 0
63+
2. Für jede Zahl in der Liste:
64+
a. Addiere die Zahl zur Summe
65+
3. Gib die Summe zurück
66+
```
67+
68+
2. **Größte Zahl finden**:
69+
```
70+
1. Setze max = erste Zahl in der Liste
71+
2. Für jede weitere Zahl in der Liste:
72+
a. Wenn die Zahl größer als max ist, setze max = diese Zahl
73+
3. Gib max zurück
74+
```
75+
76+
3. **Sortieralgorithmus (Bubble Sort)**:
77+
```
78+
1. Für i von 0 bis Länge der Liste - 1:
79+
a. Für j von 0 bis Länge der Liste - i - 1:
80+
i. Wenn Liste[j] > Liste[j+1], tausche die Elemente
81+
2. Die Liste ist nun sortiert
82+
```
83+
84+
---
85+
86+
Algorithmen sind die Grundlage der Informatik und des Programmierens. Sie helfen uns, Probleme systematisch zu lösen und effiziente Lösungen zu finden. 🚀

‎Anleitungen/03_python_interpreter.md‎

Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
# Der Python Interpreter 🐍
2+
3+
## Inhaltsverzeichnis
4+
- [Was ist der Python Interpreter?](#was-ist-der-python-interpreter)
5+
- [Starten des Interpreters](#starten-des-interpreters)
6+
- [Grundlegende Verwendung](#grundlegende-verwendung)
7+
- [Nützliche Befehle](#nützliche-befehle)
8+
- [Tipps](#tipps)
9+
- [Vorteile des Interpreters](#vorteile-des-interpreters)
10+
11+
---
12+
13+
Vorheriges Thema: [Algorithmen](/Anleitungen/02_Algorithmen.md) | Nächstes Thema: [Variablen und Datentypen](/Anleitungen/04_variablen_und_Datentypen.md)
14+
15+
---
16+
17+
## Was ist der Python Interpreter?
18+
19+
Der Python Interpreter ist ein Programm, das Python-Code direkt ausführt. Er bietet eine interaktive Umgebung, in der du Python-Befehle eingeben und sofort die Ergebnisse sehen kannst. 💻
20+
21+
Der Interpreter arbeitet nach dem REPL-Prinzip:
22+
- **R**ead: Liest die Eingabe
23+
- **E**val: Wertet sie aus
24+
- **P**rint: Gibt das Ergebnis aus
25+
- **L**oop: Wiederholt den Vorgang
26+
27+
## Starten des Interpreters
28+
29+
So startest du den Python Interpreter:
30+
31+
1. Öffne die Kommandozeile (cmd) oder Terminal
32+
2. Gebe `python` oder `python3` ein (je nach Installation)
33+
3. Du siehst nun die Python-Prompt (`>>>`)
34+
35+
```
36+
C:\> python
37+
Python 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) [MSC v.1929 64 bit (AMD64)] on win32
38+
Type "help", "copyright", "credits" or "license" for more information.
39+
>>>
40+
```
41+
42+
## Grundlegende Verwendung
43+
44+
Im Interpreter kannst du direkt Python-Code eingeben und ausführen:
45+
46+
```python
47+
>>> 2 + 2
48+
4
49+
>>> print("Hallo Welt")
50+
Hallo Welt
51+
>>> name = "Python"
52+
>>> print(f"Ich lerne {name}")
53+
Ich lerne Python
54+
```
55+
56+
Du kannst auch mehrere Zeilen Code eingeben, zum Beispiel eine Schleife:
57+
58+
```python
59+
>>> for i in range(3):
60+
... print(f"Zahl: {i}")
61+
...
62+
Zahl: 0
63+
Zahl: 1
64+
Zahl: 2
65+
```
66+
67+
## Nützliche Befehle
68+
69+
Der Interpreter bietet einige spezielle Befehle:
70+
71+
- `help()` - Zeigt die Hilfe an
72+
```python
73+
>>> help(print)
74+
# Zeigt Dokumentation zur print-Funktion
75+
```
76+
77+
- `dir()` - Listet verfügbare Namen im aktuellen Namespace
78+
```python
79+
>>> dir()
80+
['__annotations__', '__builtins__', '__doc__', ...]
81+
```
82+
83+
- `exit()` oder `quit()` - Beendet den Interpreter
84+
```python
85+
>>> exit()
86+
```
87+
88+
- `Strg + C` - Bricht die aktuelle Operation ab
89+
90+
## Tipps
91+
92+
Hier sind einige nützliche Tipps für die Arbeit mit dem Interpreter: 🔍
93+
94+
- Benutze die Pfeiltasten ↑↓ für die Befehlshistorie
95+
- Nutze Tab für die Auto-Vervollständigung von Befehlen und Variablennamen
96+
- Mit `Strg + L` kannst du den Bildschirm löschen (in vielen Terminals)
97+
- Verwende `_` für das letzte Ergebnis:
98+
```python
99+
>>> 10 * 5
100+
50
101+
>>> _ + 2
102+
52
103+
```
104+
105+
## Vorteile des Interpreters
106+
107+
Der Python Interpreter bietet viele Vorteile: 🚀
108+
109+
- **Schnelles Testen** von Code und Ideen
110+
- **Interaktives Lernen** der Sprache
111+
- **Debugging und Experimentieren** mit Funktionen und Bibliotheken
112+
- **REPL-Funktionalität** für sofortiges Feedback
113+
- **Exploration** von Objekten und Modulen
114+
- **Prototyping** von Algorithmen und Funktionen
115+
116+
---
117+
118+
Der Python Interpreter ist ein mächtiges Werkzeug zum Lernen und Experimentieren mit Python. Probiere ihn aus und entdecke, wie er dir beim Programmieren helfen kann! 🐍

0 commit comments

Comments
 (0)