Kabaforce/guide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

kılavuz: dil dizinleri (en/tr/de/fr/ru) + dil değiştirici ve bölüm gezinmesi

Browse Source 
- iki dilli tek dosyalar en/ ve tr/ altına ayrıldı
- Almanca, Fransızca, Rusça çeviriler eklendi (10 bölüm)
- kök README dil seçici oldu; her dilde kendi içindekiler sayfası
- her bölüme dil değiştirici satırı + önceki/sonraki gezinme eklendi
This commit is contained in:
semih
2026-07-24 10:21:13 +03:00
parent dfebe8a742
commit 01e9b4d15f
59 changed files with 2697 additions and 705 deletions
Download Patch File Download Diff File Expand all files Collapse all files
de/01-getting-started/readme.md
+43
View File
@@ -0,0 +1,43 @@
# 01 — Erste Schritte
🌍 [English](../../en/01-getting-started/readme.md) · [Türkçe](../../tr/01-getting-started/readme.md) · **Deutsch** · [Français](../../fr/01-getting-started/readme.md) · [Русский](../../ru/01-getting-started/readme.md)
KabaForge ist der Ort, an dem Ihr Code, Ihre Dokumente und Ihre Projekthistorie leben. Dieses Kapitel meldet Sie an und zeigt Ihnen die Umgebung.
## Anmelden
1. Öffnen Sie [forge.kabaforce.com](https://forge.kabaforce.com).
2. Klicken Sie auf **Mit KabaForce-ID anmelden**.
3. Geben Sie Ihre KabaForce-Kontodaten auf `id.kabaforce.com` ein.
4. Sie kehren angemeldet zu KabaForge zurück.
Für KabaForge gibt es kein eigenes Passwort — Ihre KabaForce-ID ist das einzige Konto, das Sie brauchen. Falls Sie noch keines haben, nutzen Sie den Link **Registrieren** auf derselben Seite.
## Was Sie nach der Anmeldung sehen
| Bereich | Wofür er da ist |
|---------|-----------------|
| **Übersicht** (Startseite) | Letzte Aktivitäten in Ihren Repositories |
| **Erkunden** | Öffentliche Repositories auf diesem Server |
| **+** (oben rechts) | Neues Repository oder neue Organisation anlegen |
| **Avatar** (oben rechts) | Profil, Einstellungen und Abmelden |
## Begriffe, die Ihnen begegnen
- **Repository (Repo)** — ein Projekt: seine Dateien samt vollständiger Historie.
- **Commit** — eine gespeicherte Änderung mit einer beschreibenden Nachricht.
- **Branch** — ein paralleler Arbeitsstrang; der Standard heißt meist `main`.
- **Pull Request** — der Vorschlag, einen Branch in einen anderen zu überführen.
## Ihre ersten fünf Minuten
1. Klicken Sie auf **+ → Neues Repository**.
2. Nennen Sie es `test` (oder wie Sie mögen), setzen Sie den Haken bei *Repository initialisieren*, klicken Sie auf **Erstellen**.
3. Öffnen Sie es und klicken Sie auf **Datei hinzufügen → Neue Datei**.
4. Tippen Sie `readme.md` als Namen, schreiben Sie ein paar Zeilen, klicken Sie auf **Änderungen übernehmen**.
Sie haben jetzt ein Repository mit einer Startseite. Die nächsten Kapitel erklären jeden dieser Schritte im Detail.
---
📚 [Inhalt](../README.md) · [Weiter: 02 — Ein Repository anlegen](../02-create-repository/readme.md) ➡
de/02-create-repository/readme.md
+41
View File
@@ -0,0 +1,41 @@
# 02 — Ein Repository anlegen
🌍 [English](../../en/02-create-repository/readme.md) · [Türkçe](../../tr/02-create-repository/readme.md) · **Deutsch** · [Français](../../fr/02-create-repository/readme.md) · [Русский](../../ru/02-create-repository/readme.md)
Ein Repository ist ein Projekt. Legen Sie eines pro Projekt an, nicht eines pro Datei.
## Schritte
1. Klicken Sie oben rechts auf **+** → **Neues Repository**.
2. **Besitzer** — Sie selbst oder eine Organisation, der Sie angehören.
3. **Repository-Name** — klein geschrieben, ohne Leerzeichen: `network-lab`, `web-site`, `guide`.
4. **Beschreibung** — eine Zeile, die erklärt, worum es geht. Sie erscheint in Suchergebnissen.
5. **Sichtbarkeit**
- *Öffentlich* — jeder, der den Server erreicht, kann lesen.
- *Privat* — nur Sie und die Personen, die Sie einladen.
6. **Repository initialisieren** — Haken setzen. Damit entsteht der erste Commit mit einer `README.md`, das Repository ist sofort nutzbar.
7. Klicken Sie auf **Repository erstellen**.
## Gute Namen
| Statt | Besser |
|-------|--------|
| `Neues Projekt (final)` | `neues-projekt` |
| `Netzwerk Übung 1` | `network-lab-01` |
| `test test 2` | `packet-tracer-tests` |
Leerzeichen und Klammern in Namen erschweren das Teilen von Links und können relative Pfade in Dokumenten durcheinanderbringen. Kleinbuchstaben, Ziffern und Bindestriche sind immer sicher.
## Nach dem Anlegen
- **Einstellungen → Mitarbeiter** — anderen Lese- oder Schreibrechte geben.
- **Einstellungen → Branches** — `main` schützen, damit niemand direkt darauf committet.
- **Datei hinzufügen** — das Repository füllen (Kapitel 03).
## Ein Repository löschen
**Einstellungen → Gefahrenzone → Dieses Repository löschen.** Zur Bestätigung müssen Sie den Repository-Namen eintippen. Das lässt sich nicht rückgängig machen — die Historie geht mit.
---
⬅ [Zurück: 01 — Erste Schritte](../01-getting-started/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 03 — Dateien hinzufügen und bearbeiten](../03-add-and-edit-files/readme.md) ➡
de/03-add-and-edit-files/readme.md
+52
View File
@@ -0,0 +1,52 @@
# 03 — Dateien hinzufügen und bearbeiten
🌍 [English](../../en/03-add-and-edit-files/readme.md) · [Türkçe](../../tr/03-add-and-edit-files/readme.md) · **Deutsch** · [Français](../../fr/03-add-and-edit-files/readme.md) · [Русский](../../ru/03-add-and-edit-files/readme.md)
Alles in diesem Kapitel passiert im Browser. Es muss nichts installiert werden.
## Das Menü „Datei hinzufügen“
Öffnen Sie ein Repository (oder einen Ordner darin) und klicken Sie auf **Datei hinzufügen**:
| Eintrag | Wofür |
|---------|-------|
| **Neue Datei** | Eine Datei von Hand schreiben — Notizen, Code, `readme.md` |
| **Neues Verzeichnis** | Einen leeren Ordner anlegen (Kapitel 04) |
| **Datei hochladen** | Dateien vom eigenen Rechner — Bilder, PDFs, Archive |
| **Patch** | Ein fertiges Diff anwenden |
## Eine neue Datei schreiben
1. **Datei hinzufügen → Neue Datei**.
2. Tippen Sie oben den Dateinamen ein, zum Beispiel `notizen.md`.
Tippen Sie `docs/notizen.md`, wird der Ordner `docs` gleich mit angelegt.
3. Schreiben Sie den Inhalt in den Editor.
4. Füllen Sie unten den Commit-Kasten aus:
- **Zusammenfassung** — kurz, in der Befehlsform: *Einrichtungsnotizen hinzufügen*.
- **Beschreibung** — optionale Details.
5. Wählen Sie **Direkt auf `main` committen** oder *einen neuen Branch anlegen*, wenn Sie erst eine Prüfung möchten (Kapitel 09).
6. Klicken Sie auf **Änderungen übernehmen**.
## Dateien hochladen
1. **Datei hinzufügen → Datei hochladen**.
2. Ziehen Sie Dateien hinein oder klicken Sie in das Feld, um sie auszuwählen.
3. Für einen Unterordner tragen Sie den Ordnernamen oben im Pfadfeld ein.
4. Klicken Sie auf **Änderungen übernehmen**.
Sehr große Dateien (Video, Datenträgerabbilder) gehören in einen Dateispeicher, nicht in ein Repository — die Historie bewahrt jede Version für immer auf.
## Eine vorhandene Datei bearbeiten
1. Öffnen Sie die Datei.
2. Klicken Sie oben rechts auf das Stift-Symbol ✏️.
3. Ändern Sie den Text; der Reiter **Änderungen in der Vorschau** zeigt, was Sie geändert haben.
4. Committen Sie wie oben.
## Umbenennen und verschieben
Beim Bearbeiten können Sie den Pfad ändern: Klicken Sie in das Namensfeld und tippen Sie einen neuen Pfad, z. B. `docs/notizen.md`. Beim Commit wird die Datei verschoben — die Historie bleibt erhalten.
---
⬅ [Zurück: 02 — Ein Repository anlegen](../02-create-repository/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 04 — Verzeichnisse anlegen](../04-create-directory/readme.md) ➡
de/04-create-directory/readme.md
+50
View File
@@ -0,0 +1,50 @@
# 04 — Verzeichnisse anlegen
🌍 [English](../../en/04-create-directory/readme.md) · [Türkçe](../../tr/04-create-directory/readme.md) · **Deutsch** · [Français](../../fr/04-create-directory/readme.md) · [Русский](../../ru/04-create-directory/readme.md)
## Der schnelle Weg
1. Öffnen Sie das Repository oder den Ordner, in dem der neue Ordner liegen soll.
2. **Datei hinzufügen → Neues Verzeichnis**.
3. Tippen Sie den Ordnernamen ein, z. B. `docs`.
4. Klicken Sie auf **Änderungen übernehmen**.
Über dem Namensfeld zeigt die Seite, wo der Ordner angelegt wird (`aktueller/pfad/`) — Sie wissen also immer, wo Sie sind.
## Verschachtelte Ordner in einem Zug
Tippen Sie einen Pfad statt eines einzelnen Namens:
```
docs/images
```
Das legt `docs` und darin `images` in einem einzigen Commit an.
## Warum eine Datei `.gitkeep` auftaucht
Versionsverwaltung verfolgt *Dateien*, keine leeren Ordner. Damit ein noch leerer Ordner erhalten bleibt, legt KabaForge darin eine leere Datei namens `.gitkeep` ab. Sie hat keinerlei Wirkung auf Ihr Projekt — löschen Sie sie, sobald der Ordner echten Inhalt hat, oder lassen Sie sie einfach liegen.
## Der andere Weg: einen Ordner beim Anlegen einer Datei erzeugen
**Datei hinzufügen → Neue Datei** und im Namensfeld einen Pfad eintippen:
```
berichte/2026/januar.md
```
Beide Ordner und die Datei entstehen gemeinsam. Nutzen Sie das, wenn Sie die erste Datei schon kennen.
## Namensregeln, die Ärger ersparen
| Vermeiden | Nutzen |
|-----------|--------|
| `Netzwerk Übung (1)` | `network-lab-01` |
| `Meine Notizen` | `meine-notizen` oder `notes` |
| `bilder und anhänge` | `assets` |
Ordnernamen mit **Leerzeichen** oder Klammern erschweren das Teilen von Links, und relative Bildpfade in Markdown werden anfälliger. Kleinbuchstaben, Ziffern und Bindestriche sind immer sicher.
---
⬅ [Zurück: 03 — Dateien hinzufügen und bearbeiten](../03-add-and-edit-files/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 05 — Dateien und Verzeichnisse löschen](../05-delete-files/readme.md) ➡
de/05-delete-files/readme.md
+49
View File
@@ -0,0 +1,49 @@
# 05 — Dateien und Verzeichnisse löschen
🌍 [English](../../en/05-delete-files/readme.md) · [Türkçe](../../tr/05-delete-files/readme.md) · **Deutsch** · [Français](../../fr/05-delete-files/readme.md) · [Русский](../../ru/05-delete-files/readme.md)
Nichts geht wirklich verloren: Eine Löschung ist nur ein weiterer Commit, und der alte Inhalt bleibt in der Historie.
## Eine einzelne Datei löschen
1. Öffnen Sie die Datei.
2. Klicken Sie oben rechts in der Dateiansicht auf das Menü **…**.
3. Wählen Sie **Diese Datei löschen** (oder das Symbol 🗑️ neben dem Bearbeitungsstift).
4. Schreiben Sie eine Commit-Nachricht und klicken Sie auf **Änderungen übernehmen**.
## Einen Ordner löschen
1. Öffnen Sie den Ordner.
2. Klicken Sie auf das Menü **…** neben *Datei hinzufügen*.
3. Wählen Sie **Dieses Verzeichnis löschen**.
4. Committen Sie.
Alles im Ordner wird in diesem einen Commit entfernt.
## Mehrere Dateien auf einmal löschen
Der Browser löscht einen Pfad nach dem anderen. Für großes Aufräumen arbeiten Sie vom eigenen Rechner (Kapitel 10):
```bash
git rm -r alter-ordner
git commit -m "alten Ordner entfernen"
git push
```
## Eine gelöschte Datei zurückholen
1. Öffnen Sie **Historie** im Ordner, der sie enthielt, oder die Repository-Historie.
2. Suchen Sie den Commit *vor* der Löschung.
3. Öffnen Sie die Datei in diesem Commit und kopieren Sie den Inhalt, oder klicken Sie auf **Quellcode zu diesem Zeitpunkt ansehen** und legen Sie sie neu an.
Alles, was jemals committet wurde, lässt sich wiederherstellen. Etwas, das Sie im Editor getippt, aber nie committet haben, nicht.
## Vorsicht bei
- **Ordner statt Datei löschen** — prüfen Sie, ob im Menü *Datei* steht, wenn Sie eine Datei meinen.
- **Geschützten Branches** — ist `main` geschützt, läuft die Löschung über einen Pull Request (Kapitel 09).
- **Geheimnissen** — ein Passwort aus einer Datei zu löschen entfernt es *nicht* aus der Historie. Ändern Sie das Passwort selbst.
---
⬅ [Zurück: 04 — Verzeichnisse anlegen](../04-create-directory/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 06 — Markdown-Grundlagen](../06-markdown-basics/readme.md) ➡
de/06-markdown-basics/readme.md
+83
View File
@@ -0,0 +1,83 @@
# 06 — Markdown-Grundlagen
🌍 [English](../../en/06-markdown-basics/readme.md) · [Türkçe](../../tr/06-markdown-basics/readme.md) · **Deutsch** · [Français](../../fr/06-markdown-basics/readme.md) · [Русский](../../ru/06-markdown-basics/readme.md)
Markdown ist einfacher Text mit ein paar Zeichensetzungsregeln. Dateien mit der Endung `.md` werden automatisch gerendert, und eine Datei namens `readme.md` erscheint auf der Seite ihres Ordners.
## Überschriften
```markdown
# Titel
## Abschnitt
### Unterabschnitt
```
Lassen Sie vor und nach einer Überschrift eine Leerzeile.
## Text
```markdown
**fett** *kursiv* ~~durchgestrichen~~ `Code`
```
Ein einzelner Zeilenumbruch wird ignoriert. Für einen neuen Absatz lassen Sie eine Leerzeile.
## Listen
```markdown
- erstens
- zweitens
- verschachtelt (zwei Leerzeichen)
1. Schritt eins
2. Schritt zwei
```
## Links
```markdown
[KabaForge](https://forge.kabaforce.com)
[Kapitel 04](../04-create-directory/readme.md)
```
Links auf Dateien im selben Repository schreiben Sie am besten als relative Pfade — so funktionieren sie in jedem Branch weiter.
## Code
Umzäunte Blöcke behalten die Einrückung und färben den Code ein. Schreiben Sie die Sprache hinter die öffnende Zaunzeile:
~~~markdown
```bash
git status
```
~~~
## Tabellen
```markdown
| Spalte | Bedeutung |
|--------|-----------|
| `main` | Standard-Branch |
| `.md` | Markdown-Datei |
```
## Zitate, Linien, Aufgaben
```markdown
> Eine zitierte Notiz.
---
- [x] erledigt
- [ ] noch offen
```
## Praktische Tipps
- Vor dem Commit ansehen: Der Reiter **Vorschau** im Editor zeigt genau das, was andere sehen werden.
- Schreiben Sie in langen Dokumenten einen Satz pro Zeile — Unterschiede zwischen Versionen bleiben lesbar.
- Emoji funktionieren direkt: 📌 ✅ ⚠️
---
⬅ [Zurück: 05 — Dateien und Verzeichnisse löschen](../05-delete-files/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 07 — Bilder und Anhänge](../07-images-and-media/readme.md) ➡
de/07-images-and-media/readme.md
+71
View File
@@ -0,0 +1,71 @@
# 07 — Bilder und Anhänge
🌍 [English](../../en/07-images-and-media/readme.md) · [Türkçe](../../tr/07-images-and-media/readme.md) · **Deutsch** · [Français](../../fr/07-images-and-media/readme.md) · [Русский](../../ru/07-images-and-media/readme.md)
## Ein Bild in ein Dokument einbauen
1. Laden Sie das Bild neben das Dokument: Ordner öffnen, **Datei hinzufügen → Datei hochladen**.
2. Verweisen Sie in der Markdown-Datei darauf:
```markdown
![Netzwerktopologie](topologie.png)
```
Der Text in den eckigen Klammern ist die Beschreibung, die erscheint, wenn das Bild nicht geladen werden kann, und die Screenreader vorlesen. Schreiben Sie eine echte Beschreibung, nicht „Bild“.
## Wo Bilder liegen sollten
Ein vorhersehbarer Aufbau, der immer funktioniert:
```
projekt/
readme.md
assets/
topologie.png
rack.jpg
```
und in `readme.md`:
```markdown
![Netzwerktopologie](assets/topologie.png)
```
## Benennung — die eine Regel
Verwenden Sie für **Ordner** und Bilddateien Kleinbuchstaben ohne Leerzeichen:
| Anfällig | Sicher |
|----------|--------|
| `Bildschirmfoto.PNG` | `bildschirmfoto.png` |
| `1-) Inter-VLAN Notizen/` | `01-inter-vlan/` |
Enthält ein Name doch Leerzeichen, schreiben Sie sie im Link als `%20`:
```markdown
![Topologie](Bildschirmfoto%20neu.PNG)
```
## Die Größe steuern
Markdown kennt keine Größenangabe; nutzen Sie bei Bedarf einfaches HTML:
```markdown
<img src="assets/topologie.png" alt="Netzwerktopologie" width="600">
```
## Eine Datei verlinken, statt sie anzuzeigen
Lassen Sie das Ausrufezeichen weg, und Sie erhalten einen Download-Link:
```markdown
[Packet-Tracer-Datei](main.pkt)
```
## Anhänge in Issues
Ziehen Sie beim Schreiben eines Issues oder Kommentars eine Datei in das Textfeld. Sie wird hochgeladen und der Link automatisch eingefügt. Nutzen Sie das für Screenshots und Logs, die nicht ins Repository selbst gehören.
---
⬅ [Zurück: 06 — Markdown-Grundlagen](../06-markdown-basics/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 08 — Commits und Historie](../08-commits-and-history/readme.md) ➡
de/08-commits-and-history/readme.md
+46
View File
@@ -0,0 +1,46 @@
# 08 — Commits und Historie
🌍 [English](../../en/08-commits-and-history/readme.md) · [Türkçe](../../tr/08-commits-and-history/readme.md) · **Deutsch** · [Français](../../fr/08-commits-and-history/readme.md) · [Русский](../../ru/08-commits-and-history/readme.md)
Ein Commit ist ein gespeicherter Schritt: was sich geändert hat, wer es geändert hat, wann und warum.
## Eine gute Nachricht schreiben
```
VLAN-Konfigurationsnotizen hinzufügen
falsche Gateway-Adresse in readme korrigieren
ungenutzten Paketmitschnitt entfernen
```
- Eine Zeile, Gegenwart, kein Punkt am Ende.
- Sagen Sie, *was* die Änderung tut — nicht „Update“ oder „Kram gefixt“.
- Längere Erklärung? Ab in das Beschreibungsfeld unter der Zusammenfassung.
## Gut committen
- **Eine Idee pro Commit.** Zwei unabhängige Änderungen sind zwei Commits.
- **Committen Sie oft.** Kleine Schritte lassen sich leicht prüfen und leicht zurücknehmen.
- **Niemals Passwörter, Schlüssel oder Tokens committen.** Sie später zu entfernen entfernt sie nicht aus der Historie — Sie müssen das Geheimnis selbst ändern.
## Historie lesen
| Wo | Was Sie bekommen |
|----|------------------|
| Schaltfläche **Historie** an Ordner oder Datei | Jeder Commit, der sie berührt hat |
| Die Seite eines Commits | Das vollständige Diff: rot entfernt, grün hinzugefügt |
| **Blame** an einer Datei | Welcher Commit jede Zeile zuletzt geändert hat |
| Reiter **Aktivität** | Beitragsdiagramm über die Zeit |
## Rückgängig machen
- **Ein Commit war falsch** → Commit öffnen, **Revert** klicken. Das erzeugt einen neuen Commit, der ihn aufhebt; nichts wird gelöscht.
- **Eine Datei war falsch** → ihre Historie öffnen, die gute Version ansehen, den Inhalt zurückkopieren und committen.
- **Ein Commit ist noch nicht gepusht** (Arbeit vom eigenen Rechner) → `git commit --amend`, um den letzten vor dem Teilen zu korrigieren.
## Vergleichen
Hängen Sie `/compare/main...mein-branch` an die Repository-URL an oder nutzen Sie die Schaltfläche **Vergleichen**, um jeden Unterschied zwischen zwei Branches oder Tags zu sehen.
---
⬅ [Zurück: 07 — Bilder und Anhänge](../07-images-and-media/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 09 — Branches und Pull Requests](../09-branches-and-pull-requests/readme.md) ➡
de/09-branches-and-pull-requests/readme.md
+58
View File
@@ -0,0 +1,58 @@
# 09 — Branches und Pull Requests
🌍 [English](../../en/09-branches-and-pull-requests/readme.md) · [Türkçe](../../tr/09-branches-and-pull-requests/readme.md) · **Deutsch** · [Français](../../fr/09-branches-and-pull-requests/readme.md) · [Русский](../../ru/09-branches-and-pull-requests/readme.md)
Ein Branch ist eine sichere Kopie des Projekts, in der Sie arbeiten können, ohne `main` zu stören. Ein Pull Request ist die Bitte, diese Arbeit zurückzuführen.
## Wann Sie einen Branch brauchen
- Die Änderung ist so groß, dass halbfertige Arbeit Dinge kaputt machen würde.
- Jemand sollte darauf schauen, bevor sie live geht.
- Sie wollen eine Idee ausprobieren und sie notfalls verwerfen können.
Für einen Tippfehler in einem Dokument genügt ein Commit direkt auf `main`.
## Einen Branch im Browser anlegen
Wählen Sie beim Committen (Kapitel 03) **Für diesen Commit einen neuen Branch anlegen und einen Pull Request starten**, benennen Sie den Branch und committen Sie. Gute Namen beschreiben die Arbeit:
```
docs/vlan-notizen
fix/falsches-gateway
feature/report-export
```
## Einen Pull Request eröffnen
1. Gehen Sie zu **Pull Requests → Neuer Pull Request**.
2. Wählen Sie den Quell-Branch (Ihren) und das Ziel (`main`).
3. Titel = was die Änderung tut. Beschreibung = warum, plus alles, was Prüfende beachten sollten.
4. Klicken Sie auf **Pull Request erstellen**.
## Review
- Prüfende kommentieren einzelne Zeilen im Reiter **Geänderte Dateien**.
- Pushen Sie weitere Commits auf denselben Branch — der Pull Request aktualisiert sich selbst.
- Ist er freigegeben, klicken Sie auf **Pull Request zusammenführen** und löschen anschließend den Branch.
## Merge-Konflikte
Hat `main` dieselben Zeilen geändert wie Sie, bittet KabaForge Sie um Auflösung. Vom eigenen Rechner:
```bash
git switch mein-branch
git fetch origin
git merge origin/main
# markierte Dateien öffnen, die richtigen Zeilen behalten
git add .
git commit
git push
```
## `main` schützen
**Einstellungen → Branches → Regel hinzufügen**: Pull Requests und Freigaben verlangen, bevor etwas nach `main` gelangt. Empfohlen, sobald mehr als eine Person im Repository arbeitet.
---
⬅ [Zurück: 08 — Commits und Historie](../08-commits-and-history/readme.md) · 📚 [Inhalt](../README.md) · [Weiter: 10 — Vom eigenen Rechner arbeiten](../10-clone-and-tokens/readme.md) ➡
de/10-clone-and-tokens/readme.md
+75
View File
@@ -0,0 +1,75 @@
# 10 — Vom eigenen Rechner arbeiten
🌍 [English](../../en/10-clone-and-tokens/readme.md) · [Türkçe](../../tr/10-clone-and-tokens/readme.md) · **Deutsch** · [Français](../../fr/10-clone-and-tokens/readme.md) · [Русский](../../ru/10-clone-and-tokens/readme.md)
Für Dokumente genügt der Browser. Für echte Arbeit — viele Dateien auf einmal oder das Ausführen des Codes — kopieren Sie das Repository auf Ihren Rechner.
## Eine Kopie holen
Klicken Sie auf der Repository-Seite auf **Klonen** und kopieren Sie die Adresse.
```bash
git clone https://forge.kabaforce.com/besitzer/projekt.git
cd projekt
```
## Der tägliche Ablauf
```bash
git pull # holen, was andere geändert haben
# ... Dateien bearbeiten ...
git status # was habe ich geändert?
git add . # Änderungen vormerken
git commit -m "Einrichtungsnotizen hinzufügen"
git push # an KabaForge senden
```
Wird `git push` abgelehnt, hat jemand anderes zuerst gepusht: `git pull` ausführen, gemeldete Konflikte lösen, dann erneut pushen.
## Anmelden auf der Kommandozeile
Ihr KabaForce-ID-Passwort funktioniert über HTTPS nicht. Erzeugen Sie stattdessen ein Token:
1. **Avatar → Einstellungen → Anwendungen → Neues Token erzeugen**.
2. Geben Sie ihm einen Namen und nur die Rechte, die Sie brauchen (`repo` genügt meist).
3. Kopieren Sie es einmal — es wird nie wieder angezeigt.
4. Wenn Git nach einem Passwort fragt, fügen Sie das Token ein.
So werden Sie nur einmal gefragt:
```bash
git config --global credential.helper store
```
## SSH statt Token
1. Erzeugen Sie einen Schlüssel, falls Sie keinen haben: `ssh-keygen -t ed25519`
2. Kopieren Sie `~/.ssh/id_ed25519.pub`.
3. **Avatar → Einstellungen → SSH-Schlüssel → Schlüssel hinzufügen**, einfügen.
4. Klonen Sie mit der SSH-Adresse unter **Klonen**.
Danach fragt nichts mehr nach einem Passwort.
## Nützliche Ergänzungen
| Bedarf | Befehl |
|--------|--------|
| Historie ansehen | `git log --oneline --graph` |
| Lokale Änderungen an einer Datei verwerfen | `git restore datei.md` |
| Branch wechseln | `git switch branch-name` |
| Branch anlegen | `git switch -c neuer-branch` |
## Automatisierung
Repositories lassen sich mit demselben Token auch über die KabaForge-API lesen und schreiben:
```bash
curl -H "Authorization: token IHR_TOKEN" \
https://forge.kabaforce.com/api/v1/repos/besitzer/projekt/contents
```
Behandeln Sie Tokens wie Passwörter: niemals in eine Datei schreiben, die Sie committen.
---
⬅ [Zurück: 09 — Branches und Pull Requests](../09-branches-and-pull-requests/readme.md) · 📚 [Inhalt](../README.md)
de/README.md
+38
View File
@@ -0,0 +1,38 @@
# 📘 KabaForge-Handbuch — Deutsch
Kurze, praktische Anleitungen zur Nutzung von KabaForge — Vorkenntnisse sind nicht nötig.
🌍 [English](../en/README.md) · [Türkçe](../tr/README.md) · **Deutsch** · [Français](../fr/README.md) · [Русский](../ru/README.md)
---
## 📚 Kapitel
| # | Kapitel |
|---|---------|
| 01 | [Erste Schritte](01-getting-started/readme.md) |
| 02 | [Ein Repository anlegen](02-create-repository/readme.md) |
| 03 | [Dateien hinzufügen und bearbeiten](03-add-and-edit-files/readme.md) |
| 04 | [Verzeichnisse anlegen](04-create-directory/readme.md) |
| 05 | [Dateien und Verzeichnisse löschen](05-delete-files/readme.md) |
| 06 | [Markdown-Grundlagen](06-markdown-basics/readme.md) |
| 07 | [Bilder und Anhänge](07-images-and-media/readme.md) |
| 08 | [Commits und Historie](08-commits-and-history/readme.md) |
| 09 | [Branches und Pull Requests](09-branches-and-pull-requests/readme.md) |
| 10 | [Vom eigenen Rechner arbeiten](10-clone-and-tokens/readme.md) |
---
## 🚀 Die 60-Sekunden-Fassung
1. Melden Sie sich auf [forge.kabaforce.com](https://forge.kabaforce.com) mit Ihrer KabaForce-ID an.
2. Klicken Sie auf **+ → Neues Repository**, vergeben Sie einen Namen, setzen Sie den Haken bei *Repository initialisieren*.
3. Öffnen Sie das Repository, klicken Sie auf **Datei hinzufügen → Neue Datei**, schreiben Sie etwas und klicken Sie auf **Änderungen übernehmen**.
4. Nennen Sie eine Datei `readme.md` — sie wird auf der Ordnerseite automatisch angezeigt.
---
## 💡 Wie dieses Handbuch zu lesen ist
Die Kapitel sind voneinander unabhängig. Springen Sie direkt zu dem, das Sie
brauchen; jedes ist eine einzelne Seite, die in wenigen Minuten gelesen ist.