kılavuz: KabaForge kullanım kılavuzu (EN + TR, 10 bölüm)

2026-07-24 09:33:01 +03:00
commit dfebe8a742
11 changed files with 1096 additions and 0 deletions
@@ -0,0 +1,141 @@
+# 🇬🇧 10 — Working from your computer
+
+The browser is enough for documents. For real work — many files at once, or running the code — copy the repository to your machine.
+
+## Getting a copy
+
+Press the **Clone** button on the repository page and copy the address.
+
+```bash
+git clone https://forge.kabaforce.com/owner/project.git
+cd project
+```
+
+## The daily loop
+
+```bash
+git pull              # get what others changed
+# ... edit files ...
+git status            # what did I change?
+git add .             # stage the changes
+git commit -m "add setup notes"
+git push              # send them to KabaForge
+```
+
+If `git push` is rejected, somebody else pushed first: run `git pull`, resolve anything it reports, then push again.
+
+## Signing in from the command line
+
+Your KabaForce ID password does not work over HTTPS. Create a token instead:
+
+1. **Avatar → Settings → Applications → Generate New Token**.
+2. Give it a name and only the permissions you need (`repo` is usually enough).
+3. Copy it once — it is never shown again.
+4. When git asks for a password, paste the token.
+
+Store it so you are asked only once:
+
+```bash
+git config --global credential.helper store
+```
+
+## SSH instead of tokens
+
+1. Create a key if you do not have one: `ssh-keygen -t ed25519`
+2. Copy `~/.ssh/id_ed25519.pub`.
+3. **Avatar → Settings → SSH Keys → Add Key**, paste it.
+4. Clone with the SSH address shown under **Clone**.
+
+No password prompts after that.
+
+## Useful extras
+
+| Need | Command |
+|------|---------|
+| See the history | `git log --oneline --graph` |
+| Discard local changes to a file | `git restore file.md` |
+| Switch branch | `git switch branch-name` |
+| Create a branch | `git switch -c new-branch` |
+
+## Automation
+
+Repositories can also be read and written through the KabaForge API using the same token:
+
+```bash
+curl -H "Authorization: token YOUR_TOKEN" \
+  https://forge.kabaforce.com/api/v1/repos/owner/project/contents
+```
+
+Treat tokens like passwords: never put one in a file you commit.
+
+---
+
+# 🇹🇷 10 — Bilgisayarınızdan çalışma
+
+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.