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
tr/01-getting-started/readme.md
+43
View File
@@ -0,0 +1,43 @@
# 01 — Başlarken
🌍 [English](../../en/01-getting-started/readme.md) · **Türkçe** · [Deutsch](../../de/01-getting-started/readme.md) · [Français](../../fr/01-getting-started/readme.md) · [Русский](../../ru/01-getting-started/readme.md)
KabaForge; kodunuzun, belgelerinizin ve proje geçmişinizin durduğu yerdir. Bu bölüm sizi içeri alır ve ortamı tanıtır.
## Giriş yapma
1. [forge.kabaforce.com](https://forge.kabaforce.com) adresini açın.
2. **KabaForce ID ile Giriş**'e basın.
3. `id.kabaforce.com` üzerinde KabaForce hesap bilgilerinizi girin.
4. Giriş yapmış olarak KabaForge'a dönersiniz.
KabaForge'un ayrı bir parolası yoktur — tek hesabınız KabaForce ID'dir. Henüz hesabınız yoksa aynı sayfadaki **Üye Ol** bağlantısını kullanın.
## Giriş sonrası ekran
| Alan | Ne işe yarar |
|------|--------------|
| **Panel** (ana sayfa) | Depolarınızdaki son hareketler |
| **Keşfet** | Bu sunucudaki herkese açık depolar |
| **+** (sağ üst) | Yeni depo veya organizasyon oluşturma |
| **Avatar** (sağ üst) | Profil, ayarlar ve çıkış |
## Karşılaşacağınız terimler
- **Depo (repository)** — tek bir proje: dosyaları ve tüm geçmişi.
- **İşleme (commit)** — kaydedilmiş tek bir değişiklik ve onu anlatan mesaj.
- **Dal (branch)** — paralel çalışma hattı; varsayılanı genelde `main`'dir.
- **Değişiklik isteği (pull request)** — bir dalı diğerine birleştirme önerisi.
## İlk beş dakikanız
1. **+ → Yeni Depo**'ya basın.
2. Adını `deneme` koyun, *Depoyu başlat* kutusunu işaretleyin, **Oluştur**'a basın.
3. Depoyu açıp **Dosya Ekle → Yeni Dosya**'ya basın.
4. Ad olarak `readme.md` yazın, birkaç satır ekleyin, **Değişiklikleri Uygula**'ya basın.
Artık ön sayfası olan bir deponuz var. Sonraki bölümler bu adımların her birini ayrıntılı anlatıyor.
---
📚 [İçindekiler](../README.md) · [Sonraki: 02 — Depo oluşturma](../02-create-repository/readme.md) ➡
tr/02-create-repository/readme.md
+41
View File
@@ -0,0 +1,41 @@
# 02 — Depo oluşturma
🌍 [English](../../en/02-create-repository/readme.md) · **Türkçe** · [Deutsch](../../de/02-create-repository/readme.md) · [Français](../../fr/02-create-repository/readme.md) · [Русский](../../ru/02-create-repository/readme.md)
Depo, tek bir projedir. Her dosya için değil, her proje için bir depo açın.
## Adımlar
1. Sağ üstteki **+** → **Yeni Depo**.
2. **Sahip** — kendiniz veya üyesi olduğunuz bir organizasyon.
3. **Depo adı** — küçük harf, boşluksuz: `network-lab`, `web-site`, `guide`.
4. **Açıklama** — ne olduğunu anlatan tek satır. Arama sonuçlarında görünür.
5. **Görünürlük**
- *Herkese açık* — sunucuya erişebilen herkes okuyabilir.
- *Özel* — yalnız siz ve davet ettikleriniz.
6. **Depoyu başlat** — işaretleyin. İlk işlemeyi `README.md` ile oluşturur, depo hemen kullanılabilir olur.
7. **Depo Oluştur**'a basın.
## İyi adlar
| Yerine | Tercih edin |
|--------|-------------|
| `Yeni Proje (son)` | `yeni-proje` |
| `Ağ Ödevi 1` | `network-lab-01` |
| `test test 2` | `packet-tracer-tests` |
Adlarda boşluk ve parantez, bağlantı paylaşmayı zorlaştırır ve belge içindeki göreli yolları karıştırabilir. Küçük harf, rakam ve tire her zaman güvenlidir.
## Oluşturduktan sonra
- **Ayarlar → Katkıcılar** — başkalarına okuma veya yazma yetkisi verin.
- **Ayarlar → Dallar** — `main` dalını koruyun ki kimse doğrudan işleme yapamasın.
- **Dosya Ekle** — depoyu doldurmaya başlayın (bölüm 03).
## Depo silme
**Ayarlar → Tehlikeli Bölge → Bu depoyu sil.** Onaylamak için depo adını yazmanız gerekir. Geri alınamaz — geçmiş de gider.
---
⬅ [Önceki: 01 — Başlarken](../01-getting-started/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 03 — Dosya ekleme ve düzenleme](../03-add-and-edit-files/readme.md) ➡
tr/03-add-and-edit-files/readme.md
+52
View File
@@ -0,0 +1,52 @@
# 03 — Dosya ekleme ve düzenleme
🌍 [English](../../en/03-add-and-edit-files/readme.md) · **Türkçe** · [Deutsch](../../de/03-add-and-edit-files/readme.md) · [Français](../../fr/03-add-and-edit-files/readme.md) · [Русский](../../ru/03-add-and-edit-files/readme.md)
Bu bölümdeki her şey tarayıcıda yapılır. Kurulacak araç yoktur.
## Dosya Ekle menüsü
Bir depoyu (veya içindeki bir klasörü) açıp **Dosya Ekle**'ye basın:
| Öğe | Ne için |
|-----|---------|
| **Yeni Dosya** | Elle dosya yazmak — notlar, kod, `readme.md` |
| **Yeni Dizin** | Boş klasör oluşturmak (bölüm 04) |
| **Dosya Yükle** | Bilgisayarınızdan dosya getirmek — görsel, PDF, arşiv |
| **Yama** | Hazır bir fark (diff) uygulamak |
## Yeni dosya yazma
1. **Dosya Ekle → Yeni Dosya**.
2. Üstteki alana dosya adını yazın, örneğin `notlar.md`.
`belgeler/notlar.md` yazarsanız `belgeler` klasörü de aynı anda oluşur.
3. İçeriği editöre yazın.
4. Alttaki işleme kutusunu doldurun:
- **Özet** — kısa ve emir kipinde: *kurulum notları eklendi*.
- **Açıklama** — isteğe bağlı ayrıntı.
5. **Doğrudan `main` bölümüne uygula** seçin ya da önce inceleme istiyorsanız *yeni bir dal oluştur* (bölüm 09).
6. **Değişiklikleri Uygula**'ya basın.
## Dosya yükleme
1. **Dosya Ekle → Dosya Yükle**.
2. Dosyaları sürükleyin ya da kutuya basıp seçin.
3. Alt klasöre koymak için üstteki yol alanına klasör adını yazın.
4. **Değişiklikleri Uygula**'ya basın.
Çok büyük dosyalar (video, disk imajı) depoya değil dosya depolamaya aittir — geçmiş, her sürümü sonsuza dek saklar.
## Var olan dosyayı düzenleme
1. Dosyayı açın.
2. Sağ üstteki kalem ✏️ ikonuna basın.
3. Metni değiştirin; **Değişiklikleri önizle** sekmesi neyi değiştirdiğinizi gösterir.
4. Yukarıdaki gibi işleyin.
## Yeniden adlandırma ve taşıma
Düzenleme ekranında yolu değiştirebilirsiniz: ad alanına yeni yolu yazın, örneğin `belgeler/notlar.md`. İşlediğinizde dosya taşınır — geçmiş korunur.
---
⬅ [Önceki: 02 — Depo oluşturma](../02-create-repository/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 04 — Dizin oluşturma](../04-create-directory/readme.md) ➡
tr/04-create-directory/readme.md
+50
View File
@@ -0,0 +1,50 @@
# 04 — Dizin oluşturma
🌍 [English](../../en/04-create-directory/readme.md) · **Türkçe** · [Deutsch](../../de/04-create-directory/readme.md) · [Français](../../fr/04-create-directory/readme.md) · [Русский](../../ru/04-create-directory/readme.md)
## Hızlı yol
1. Depoyu ya da yeni klasörü içine koymak istediğiniz klasörü açın.
2. **Dosya Ekle → Yeni Dizin**.
3. Klasör adını yazın, örneğin `belgeler`.
4. **Değişiklikleri Uygula**'ya basın.
Panel, ad kutusunun üstünde klasörün nereye oluşturulacağını (`mevcut/yol/`) gösterir; nerede olduğunuzu hep bilirsiniz.
## Tek seferde iç içe klasör
Tek ad yerine yol yazın:
```
belgeler/gorseller
```
Bu, tek işlemede `belgeler` klasörünü ve içinde `gorseller` klasörünü oluşturur.
## `.gitkeep` dosyası neden çıkıyor
Sürüm kontrolü klasörleri değil *dosyaları* takip eder. Henüz içi boş bir klasörü saklayabilmek için KabaForge içine `.gitkeep` adlı boş bir dosya koyar. Projenize hiçbir etkisi yoktur — klasör gerçek içerikle dolunca silebilir ya da öylece bırakabilirsiniz.
## Diğer yol: dosya oluştururken klasör açmak
**Dosya Ekle → Yeni Dosya**'ya basıp ad kutusuna yol yazın:
```
raporlar/2026/ocak.md
```
Klasörler ve dosya birlikte oluşur. İlk dosyanın ne olacağını biliyorsanız bunu kullanın.
## Sizi dertten kurtaracak adlandırma kuralları
| Kaçının | Kullanın |
|---------|----------|
| `Ağ Ödevi (1)` | `network-lab-01` |
| `Notlarım` | `notlarim` veya `notes` |
| `resimler ve ekler` | `assets` |
Klasör adlarında **boşluk** veya parantez olması bağlantı paylaşımını zorlaştırır; Markdown içindeki göreli görsel yolları da daha kırılgan olur. Küçük harf, rakam ve tire her zaman güvenlidir.
---
⬅ [Önceki: 03 — Dosya ekleme ve düzenleme](../03-add-and-edit-files/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 05 — Dosya ve dizin silme](../05-delete-files/readme.md) ➡
tr/05-delete-files/readme.md
+49
View File
@@ -0,0 +1,49 @@
# 05 — Dosya ve dizin silme
🌍 [English](../../en/05-delete-files/readme.md) · **Türkçe** · [Deutsch](../../de/05-delete-files/readme.md) · [Français](../../fr/05-delete-files/readme.md) · [Русский](../../ru/05-delete-files/readme.md)
Hiçbir şey gerçekten kaybolmaz: silme de bir işlemedir ve eski içerik geçmişte durur.
## Tek dosya silme
1. Dosyayı açın.
2. Dosya görünümünün sağ üstündeki **…** menüsüne basın.
3. **Bu dosyayı sil**'i seçin (ya da düzenleme kaleminin yanındaki 🗑️ ikonunu kullanın).
4. Bir işleme mesajı yazıp **Değişiklikleri Uygula**'ya basın.
## Klasör silme
1. Klasörü açın.
2. *Dosya Ekle*'nin yanındaki **…** menüsüne basın.
3. **Bu dizini sil**'i seçin.
4. İşleyin.
Klasörün içindeki her şey o tek işlemede kaldırılır.
## Aynı anda birden çok dosya silme
Tarayıcı tek seferde tek yol siler. Büyük temizlik için bilgisayarınızdan çalışın (bölüm 10):
```bash
git rm -r eski-klasor
git commit -m "eski klasör kaldırıldı"
git push
```
## Silinen dosyayı geri getirme
1. Dosyanın bulunduğu klasörde **Geçmiş**'i ya da depo geçmişini açın.
2. Silmeden *önceki* işlemeyi bulun.
3. Dosyayı o işlemede açıp içeriği kopyalayın veya **Bu noktadaki kaynağa göz at** ile yeniden oluşturun.
Bir kez işlenmiş her şey geri getirilebilir. Editöre yazıp hiç işlemediğiniz bir şey getirilemez.
## Dikkat edilecekler
- **Dosya yerine klasörü silmek** — tek dosya kastediyorsanız menü başlığının *dosya* dediğine bakın.
- **Korumalı dallar** — `main` korumalıysa silme, değişiklik isteğiyle ilerler (bölüm 09).
- **Sırlar** — bir parolayı dosyadan silmek onu geçmişten *kaldırmaz*. Parolanın kendisini değiştirin.
---
⬅ [Önceki: 04 — Dizin oluşturma](../04-create-directory/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 06 — Markdown temelleri](../06-markdown-basics/readme.md) ➡
tr/06-markdown-basics/readme.md
+83
View File
@@ -0,0 +1,83 @@
# 06 — Markdown temelleri
🌍 [English](../../en/06-markdown-basics/readme.md) · **Türkçe** · [Deutsch](../../de/06-markdown-basics/readme.md) · [Français](../../fr/06-markdown-basics/readme.md) · [Русский](../../ru/06-markdown-basics/readme.md)
Markdown, birkaç noktalama kuralı olan düz metindir. `.md` ile biten dosyalar otomatik olarak biçimlendirilir; `readme.md` adlı dosya bulunduğu klasörün sayfasında gösterilir.
## Başlıklar
```markdown
# Başlık
## Bölüm
### Alt bölüm
```
Başlığın öncesinde ve sonrasında boş satır bırakın.
## Metin
```markdown
**kalın** *italik* ~~üstü çizili~~ `kod`
```
Tek satır sonu yok sayılır. Yeni paragraf için boş satır bırakın.
## Listeler
```markdown
- birinci
- ikinci
- iç madde (iki boşluk)
1. birinci adım
2. ikinci adım
```
## Bağlantılar
```markdown
[KabaForge](https://forge.kabaforce.com)
[bölüm 04](../04-create-directory/readme.md)
```
Aynı depodaki dosyalara göreli yolla bağlanmak en iyisidir — her dalda çalışmaya devam eder.
## Kod
Çitli bloklar boşlukları korur ve renk verir. Açılış çitinden sonra dili yazın:
~~~markdown
```bash
git status
```
~~~
## Tablolar
```markdown
| Sütun | Anlamı |
|--------|--------|
| `main` | varsayılan dal |
| `.md` | Markdown dosyası |
```
## Alıntı, çizgi, görev listesi
```markdown
> Alıntılanmış not.
---
- [x] bitti
- [ ] henüz bitmedi
```
## Pratik ipuçları
- İşlemeden önce önizleyin: editördeki **Önizleme** sekmesi, başkalarının göreceğinin aynısını gösterir.
- Uzun belgelerde her cümleyi ayrı satıra yazın — sürümler arası farklar okunaklı kalır.
- Emoji doğrudan çalışır: 📌 ✅ ⚠️
---
⬅ [Önceki: 05 — Dosya ve dizin silme](../05-delete-files/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 07 — Görseller ve ekler](../07-images-and-media/readme.md) ➡
tr/07-images-and-media/readme.md
+71
View File
@@ -0,0 +1,71 @@
# 07 — Görseller ve ekler
🌍 [English](../../en/07-images-and-media/readme.md) · **Türkçe** · [Deutsch](../../de/07-images-and-media/readme.md) · [Français](../../fr/07-images-and-media/readme.md) · [Русский](../../ru/07-images-and-media/readme.md)
## Belgeye görsel koyma
1. Görseli belgenin yanına yükleyin: klasörü açın, **Dosya Ekle → Dosya Yükle**.
2. Markdown dosyasından ona atıf yapın:
```markdown
![Ağ topolojisi](topoloji.png)
```
Köşeli parantezdeki metin, görsel yüklenemezse gösterilen açıklamadır ve ekran okuyucular tarafından okunur. "resim" değil, gerçek bir açıklama yazın.
## Görselleri nerede tutmalı
Her zaman işe yarayan öngörülebilir düzen:
```
proje/
readme.md
assets/
topoloji.png
kabinet.jpg
```
ve `readme.md` içinde:
```markdown
![Ağ topolojisi](assets/topoloji.png)
```
## Adlandırma — akılda kalacak tek kural
**Klasör** ve görsel adlarında boşluksuz, küçük harf kullanın:
| Kırılgan | Güvenli |
|----------|---------|
| `Ekran Alıntısı.PNG` | `ekran-alintisi.png` |
| `1-) Inter-VLAN Notlar/` | `01-inter-vlan/` |
Adda boşluk varsa bağlantıda `%20` olarak yazın:
```markdown
![Topoloji](Ekran%20Alintisi.PNG)
```
## Boyut ayarlama
Markdown'da boyut seçeneği yoktur; gerektiğinde düz HTML etiketi kullanın:
```markdown
<img src="assets/topoloji.png" alt="Ağ topolojisi" width="600">
```
## Göstermek yerine bağlantı vermek
Ünlem işaretini kaldırırsanız indirme bağlantısı olur:
```markdown
[Packet Tracer dosyası](main.pkt)
```
## Konulardaki ekler
Bir konu ya da yorum yazarken metin kutusuna dosya sürükleyin. Dosya yüklenir ve bağlantısı sizin için eklenir. Deponun kendisine ait olmayan ekran görüntüleri ve günlükler için bunu kullanın.
---
⬅ [Önceki: 06 — Markdown temelleri](../06-markdown-basics/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 08 — İşlemeler ve geçmiş](../08-commits-and-history/readme.md) ➡
tr/08-commits-and-history/readme.md
+46
View File
@@ -0,0 +1,46 @@
# 08 — İşlemeler ve geçmiş
🌍 [English](../../en/08-commits-and-history/readme.md) · **Türkçe** · [Deutsch](../../de/08-commits-and-history/readme.md) · [Français](../../fr/08-commits-and-history/readme.md) · [Русский](../../ru/08-commits-and-history/readme.md)
İşleme, kaydedilmiş tek bir adımdır: ne değişti, kim değiştirdi, ne zaman ve neden.
## İyi mesaj yazma
```
VLAN yapılandırma notları eklendi
readme'deki yanlış ağ geçidi düzeltildi
kullanılmayan paket kaydı kaldırıldı
```
- Tek satır, nokta yok.
- Değişikliğin *ne yaptığını* söyleyin; "güncelleme" ya da "düzeltmeler" demeyin.
- Daha uzun anlatım gerekiyorsa özetin altındaki açıklama kutusuna yazın.
## İyi işleme alışkanlıkları
- **Her işlemede tek fikir.** İlgisiz iki değişiklik, iki işlemedir.
- **Sık işleyin.** Küçük adımlar hem kolay incelenir hem kolay geri alınır.
- **Parola, anahtar veya jetonu asla işlemeyin.** Sonradan silmek onları geçmişten kaldırmaz — sırrın kendisini değiştirmeniz gerekir.
## Geçmişi okuma
| Nerede | Ne verir |
|--------|----------|
| Klasör veya dosyadaki **Geçmiş** düğmesi | Ona dokunan tüm işlemeler |
| Bir işlemenin sayfası | Tam fark: kırmızı silinen, yeşil eklenen |
| Dosyadaki **Blame** | Her satırı en son hangi işlemenin değiştirdiği |
| **Aktivite** sekmesi | Zaman içindeki katkı grafiği |
## Geri alma
- **Bir işleme yanlıştı** → işlemeyi açıp **Geri Al**'a basın. Onu iptal eden yeni bir işleme oluşur; hiçbir şey silinmez.
- **Bir dosya yanlıştı** → geçmişini açın, doğru sürümü görüntüleyin, içeriği geri kopyalayıp işleyin.
- **İşleme henüz gönderilmediyse** (bilgisayarınızdan çalışıyorsanız) → paylaşmadan önce `git commit --amend` ile sonuncuyu düzeltin.
## Karşılaştırma
Depo adresine `/compare/main...dalim` ekleyin ya da **Karşılaştır** düğmesini kullanın; iki dal veya etiket arasındaki tüm farkı görürsünüz.
---
⬅ [Önceki: 07 — Görseller ve ekler](../07-images-and-media/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 09 — Dallar ve değişiklik istekleri](../09-branches-and-pull-requests/readme.md) ➡
tr/09-branches-and-pull-requests/readme.md
+58
View File
@@ -0,0 +1,58 @@
# 09 — Dallar ve değişiklik istekleri
🌍 [English](../../en/09-branches-and-pull-requests/readme.md) · **Türkçe** · [Deutsch](../../de/09-branches-and-pull-requests/readme.md) · [Français](../../fr/09-branches-and-pull-requests/readme.md) · [Русский](../../ru/09-branches-and-pull-requests/readme.md)
Dal, `main`'i rahatsız etmeden çalışabileceğiniz güvenli bir kopyadır. Değişiklik isteği (pull request) ise o çalışmayı geri getirme talebidir.
## Ne zaman dal gerekir
- Değişiklik, yarım hâliyle işleri bozacak kadar büyükse.
- Yayına girmeden önce birinin bakması gerekiyorsa.
- Bir fikri deneyip gerekirse çöpe atabilmek istiyorsanız.
Bir belgedeki yazım hatası için doğrudan `main`'e işlemek yeterlidir.
## Tarayıcıda dal oluşturma
İşleme sırasında (bölüm 03) **Bu işleme için yeni bir dal oluşturun ve bir değişiklik isteği başlatın** seçeneğini seçin, dala ad verip işleyin. İyi adlar işi anlatır:
```
docs/vlan-notlari
fix/yanlis-gateway
feature/rapor-disa-aktarim
```
## Değişiklik isteği açma
1. **Değişiklik İstekleri → Yeni Değişiklik İsteği**.
2. Kaynak dalı (sizinki) ve hedefi (`main`) seçin.
3. Başlık = değişikliğin ne yaptığı. Açıklama = nedeni ve incelemecilerin bakması gerekenler.
4. **Değişiklik İsteği Oluştur**'a basın.
## İnceleme
- İncelemeciler **Değişen Dosyalar** sekmesinden tek tek satırlara yorum yazar.
- Aynı dala yeni işlemeler gönderin — istek kendini günceller.
- Onaylanınca **Birleştir**'e basın, ardından dalı silin.
## Birleştirme çakışmaları
`main` sizinle aynı satırları değiştirdiyse KabaForge çözmenizi ister. Bilgisayarınızdan:
```bash
git switch dalim
git fetch origin
git merge origin/main
# işaretlenen dosyaları açın, doğru satırları bırakın
git add .
git commit
git push
```
## `main` dalını koruma
**Ayarlar → Dallar → Kural ekle**: `main`'e bir şey girmeden önce değişiklik isteği ve onay şartı koyun. Depoda birden fazla kişi çalışır çalışmaz önerilir.
---
⬅ [Önceki: 08 — İşlemeler ve geçmiş](../08-commits-and-history/readme.md) · 📚 [İçindekiler](../README.md) · [Sonraki: 10 — Bilgisayarınızdan çalışma](../10-clone-and-tokens/readme.md) ➡
tr/10-clone-and-tokens/readme.md
+75
View File
@@ -0,0 +1,75 @@
# 10 — Bilgisayarınızdan çalışma
🌍 [English](../../en/10-clone-and-tokens/readme.md) · **Türkçe** · [Deutsch](../../de/10-clone-and-tokens/readme.md) · [Français](../../fr/10-clone-and-tokens/readme.md) · [Русский](../../ru/10-clone-and-tokens/readme.md)
Belgeler için tarayıcı yeterlidir. Asıl iş için — çok dosyayı birden değiştirmek ya da kodu çalıştırmak — depoyu makinenize kopyalayın.
## Kopya alma
Depo sayfasındaki **Klonla** düğmesine basıp adresi kopyalayın.
```bash
git clone https://forge.kabaforce.com/sahip/proje.git
cd proje
```
## Günlük döngü
```bash
git pull # başkalarının değiştirdiklerini al
# ... dosyaları düzenleyin ...
git status # ne değiştirdim?
git add . # değişiklikleri hazırla
git commit -m "kurulum notları eklendi"
git push # KabaForge'a gönder
```
`git push` reddedilirse başkası sizden önce göndermiştir: `git pull` çalıştırın, bildirdiği çakışmaları çözün, sonra tekrar gönderin.
## Komut satırından kimlik doğrulama
KabaForce ID parolanız HTTPS üzerinden çalışmaz. Bunun yerine jeton oluşturun:
1. **Avatar → Ayarlar → Uygulamalar → Yeni Jeton Üret**.
2. Bir ad verin ve yalnız ihtiyaç duyduğunuz yetkileri seçin (genelde `repo` yeter).
3. Jetonu bir kez kopyalayın — bir daha gösterilmez.
4. Git parola sorduğunda jetonu yapıştırın.
Bir kez sorulması için saklayın:
```bash
git config --global credential.helper store
```
## Jeton yerine SSH
1. Anahtarınız yoksa oluşturun: `ssh-keygen -t ed25519`
2. `~/.ssh/id_ed25519.pub` içeriğini kopyalayın.
3. **Avatar → Ayarlar → SSH Anahtarları → Anahtar Ekle**, yapıştırın.
4. **Klonla** altındaki SSH adresiyle klonlayın.
Bundan sonra parola sorulmaz.
## İşe yarayan ekler
| İhtiyaç | Komut |
|---------|-------|
| Geçmişi görmek | `git log --oneline --graph` |
| Bir dosyadaki yerel değişiklikleri atmak | `git restore dosya.md` |
| Dal değiştirmek | `git switch dal-adi` |
| Dal oluşturmak | `git switch -c yeni-dal` |
## Otomasyon
Depolar aynı jetonla KabaForge API'si üzerinden de okunup yazılabilir:
```bash
curl -H "Authorization: token JETONUNUZ" \
https://forge.kabaforce.com/api/v1/repos/sahip/proje/contents
```
Jetonları parola gibi görün: işleyeceğiniz bir dosyanın içine asla koymayın.
---
⬅ [Önceki: 09 — Dallar ve değişiklik istekleri](../09-branches-and-pull-requests/readme.md) · 📚 [İçindekiler](../README.md)
tr/README.md
+38
View File
@@ -0,0 +1,38 @@
# 📘 KabaForge Kılavuzu — Türkçe
KabaForge kullanımı için kısa ve pratik tarifler — önceden bilgi gerekmez.
🌍 [English](../en/README.md) · **Türkçe** · [Deutsch](../de/README.md) · [Français](../fr/README.md) · [Русский](../ru/README.md)
---
## 📚 Bölümler
| # | Bölüm |
|---|-------|
| 01 | [Başlarken](01-getting-started/readme.md) |
| 02 | [Depo oluşturma](02-create-repository/readme.md) |
| 03 | [Dosya ekleme ve düzenleme](03-add-and-edit-files/readme.md) |
| 04 | [Dizin oluşturma](04-create-directory/readme.md) |
| 05 | [Dosya ve dizin silme](05-delete-files/readme.md) |
| 06 | [Markdown temelleri](06-markdown-basics/readme.md) |
| 07 | [Görseller ve ekler](07-images-and-media/readme.md) |
| 08 | [İşlemeler ve geçmiş](08-commits-and-history/readme.md) |
| 09 | [Dallar ve değişiklik istekleri](09-branches-and-pull-requests/readme.md) |
| 10 | [Bilgisayarınızdan çalışma](10-clone-and-tokens/readme.md) |
---
## 🚀 60 saniyelik özet
1. [forge.kabaforce.com](https://forge.kabaforce.com) adresinde KabaForce ID ile giriş yapın.
2. **+ → Yeni Depo**'ya basın, bir ad verin, *Depoyu başlat* kutusunu işaretleyin.
3. Depoyu açın, **Dosya Ekle → Yeni Dosya**'ya basın, bir şeyler yazın, **Değişiklikleri Uygula**'ya basın.
4. Bir dosyaya `readme.md` adını verirseniz klasör sayfasında otomatik gösterilir.
---
## 💡 Bu kılavuz nasıl okunur
Bölümler birbirinden bağımsızdır. İhtiyacınız olana atlayın; her biri birkaç
dakikada bitirilebilecek tek sayfadır.