Yardım — KabaForge

60 saniyede başlayın

Hesabınız varsa ilk deponuz bir dakikadan kısa sürer.

1 · Giriş yapın

KabaForge'un ayrı parolası yoktur; tek hesabınız KabaForce ID'dir.

KabaForce ID ile Giriş'e basın
Hesap bilgilerinizi girin
Giriş yapmış olarak geri dönersiniz

2 · Depo oluşturun

Depo, tek bir projedir — her dosya için değil, her proje için bir depo.

+ → Yeni Depo
Küçük harfli, boşluksuz bir ad verin
Depoyu başlat kutusunu işaretleyin

3 · Dosya ekleyin

Her şey tarayıcıda olur, kurulacak araç yoktur.

Dosya Ekle → Yeni Dosya
Ad olarak readme.md yazın
Değişiklikleri Uygula

4 · Bilgisayarınıza alın

Çok dosyayı birden değiştirmek veya kodu çalıştırmak için.

Klonla ile adresi kopyalayın
git clone <adres>
Parola yerine erişim jetonu kullanın

Kılavuz — 17 bölüm

Bölümler bağımsızdır; ihtiyacınız olana atlayın. Başlık Türkçesini, sağdaki kodlar aynı bölümün diğer dillerdeki karşılığını açar.

Git komut kartı

Bilgisayarınızdan çalışırken günde kullandığınız her şey (ayrıntısı bölüm 10'da).

Günlük döngü

git pull
git status
git add .
git commit -m "kurulum notları eklendi"
git push

Depoyu almak

git clone https://forge.kabaforce.com/sahip/proje.git
cd proje
git remote -v

Dallar

git switch -c yeni-dal
git switch main
git merge origin/main
git push -u origin yeni-dal

Geri alma

git restore dosya.md
git restore --staged dosya.md
git commit --amend
git revert <işleme>

Bakmak

git log --oneline --graph
git diff
git show <işleme>
git blame dosya.md

Temizlik

git rm -r eski-klasor
git branch -d biten-dal
git fetch --prune
git stash

Depo sekmeleri ne işe yarar?

Bir depoyu açtığınızda üstte gördüğünüz sekmelerin kısa karşılığı.

Kod

Dosyalar, dallar, etiketler ve dosya geçmişi. Klonlama adresi de buradadır. → bölüm 03

Konular

Yapılacaklar, hatalar ve tartışmalar; etiket, kilometre taşı ve atama ile düzenlenir. → bölüm 11

Değişiklik İstekleri

Bir dalın main'e katılma önerisi; satır satır inceleme burada yapılır. → bölüm 09

İşlemler

Her işlemede otomatik test/derleme (CI). İş akışı .gitea/workflows/ içindedir. → bölüm 12

Sürüm

Etiketlenmiş yayınlar, sürüm notları ve indirilebilir ekler. → bölüm 12

Paketler

Depoya bağlı paket kayıtları (npm, container, generic).

Projeler

Konuları sütunlara taşıdığınız kanban panosu. → bölüm 11

Viki

Depoya bağlı, ayrı geçmişi olan belge alanı. → bölüm 11

Aktivite

Seçtiğiniz aralıkta kim ne yaptı: işleme, konu, değişiklik isteği özeti.

Ayarlar

Katkıcılar, dal koruma, webhook, dağıtım anahtarı, arşivleme. → bölüm 13

Sık sorulanlar

En çok takılınan yerler ve kısa cevapları.

Giriş yapamıyorum / parolam çalışmıyor

KabaForge'un ayrı bir parolası yok. Giriş yalnızca KabaForce ID ile Giriş düğmesiyle, id.kabaforce.com üzerinden yapılır. Hesabınız yoksa aynı sayfadaki Üye Ol bağlantısını kullanın.

Komut satırında git parolamı kabul etmiyor

HTTPS üzerinden hesap parolası çalışmaz; erişim jetonu üretin: Avatar → Ayarlar → Uygulamalar → Yeni Jeton Üret. Jeton bir kez gösterilir; git parola sorduğunda onu yapıştırın.

git config --global credential.helper store

Ayrıntı: bölüm 10.

Her seferinde parola sorulmasın istiyorum (SSH)

ssh-keygen -t ed25519
cat ~/.ssh/id_ed25519.pub

Çıktıyı Avatar → Ayarlar → SSH Anahtarları → Anahtar Ekle ile ekleyin, sonra Klonla altındaki SSH adresiyle klonlayın.

Boş klasör oluşturunca neden .gitkeep çıkıyor?

Sürüm kontrolü klasörleri değil dosyaları takip eder. Henüz içi boş bir klasörün kaybolmaması için içine boş bir .gitkeep konur. Projenize etkisi yoktur; klasör gerçek içerikle dolunca silebilirsiniz. → bölüm 04

Yanlışlıkla sildim, geri gelir mi?

Silme de bir işlemedir; eski içerik geçmişte durur. Klasörün Geçmişini açın, silmeden önceki işlemeyi bulun, dosyayı orada açıp içeriği geri kopyalayın. Bir kez işlenmiş her şey geri getirilebilir. → bölüm 05

Yanlışlıkla parola/jeton işledim

Dosyadan silmek onu geçmişten kaldırmaz. Tek doğru çözüm sırrın kendisini değiştirmektir: parolayı yenileyin, jetonu iptal edip yeniden üretin.

git push reddedildi

Genellikle başkası sizden önce göndermiştir: git pull çalıştırın, çakışmaları çözün, tekrar gönderin. main korumalıysa doğrudan gönderim yerine değişiklik isteği açmanız gerekir. → bölüm 09

Görselim belgede görünmüyor

Çoğunlukla addaki boşluk ya da büyük harf yüzündendir. Klasör ve görsel adlarını küçük harfli ve boşluksuz tutun (ekran-alintisi.png); adda boşluk varsa bağlantıda %20 yazın. → bölüm 07

İşlemler (CI) çalışmıyor

Dosya .gitea/workflows/ altında ve .yml uzantılı olmalı. runs-on değeri bu sunucudaki çalıştırıcının etiketlerinden biri olmalı: ubuntu-latest, ubuntu-24.04, ubuntu-22.04. → bölüm 12

Depoyu API ile kullanmak istiyorum

curl -H "Authorization: token JETONUNUZ" \
  https://forge.kabaforce.com/api/v1/repos/sahip/proje/contents

Jetonları parola gibi saklayın; işleyeceğiniz dosyaya asla koymayın.

Depoyu silmeden dondurabilir miyim?

Evet — Ayarlar → Arşivle depoyu salt-okunur yapar; içerik ve geçmiş durur. Silme geri alınamaz. → bölüm 13

Bu kılavuz hakkında

API ve otomasyon

Jetonla HTTP üzerinden depo okuma/yazma, konu açma, sayfalama ve hata kodları: bölüm 16. Kısayollar ve paylaşılabilir adres kalıpları: bölüm 15.

Beş dil

Türkçe, İngilizce, Almanca, Fransızca ve Rusça — on üç bölümün tamamı her dilde. Her sayfanın üstündeki 🌍 satırı aynı bölümün diğer dilini açar.

Kaynak metinler

Sayfaların üretildiği Markdown dosyaları kaynak/<dil>/<bölüm>.md altında duruyor; düzeltmek isterseniz oradan başlayın.

Hesap ve giriş

Parola, iki adımlı doğrulama ve oturum işlemleri KabaForce ID üzerinden yürür.