kılavuz: KabaForge kullanım kılavuzu (EN + TR, 10 bölüm)
This commit is contained in:
@@ -0,0 +1,91 @@
|
||||
# 🇬🇧 04 — Creating directories
|
||||
|
||||
## The quick way
|
||||
|
||||
1. Open the repository, or the folder you want the new folder inside.
|
||||
2. **Add File → New Directory**.
|
||||
3. Type the folder name, e.g. `docs`.
|
||||
4. Press **Commit Changes**.
|
||||
|
||||
The panel shows where the folder will be created (`current/path/`) above the name box, so you always know where you are.
|
||||
|
||||
## Nested folders in one go
|
||||
|
||||
Type a path instead of a single name:
|
||||
|
||||
```
|
||||
docs/images
|
||||
```
|
||||
|
||||
That creates `docs`, and `images` inside it, in a single commit.
|
||||
|
||||
## Why a `.gitkeep` file appears
|
||||
|
||||
Version control tracks *files*, not empty folders. To keep a folder that has nothing in it yet, KabaForge puts an empty file named `.gitkeep` inside. It has no effect on your project — delete it once the folder has real content, or simply leave it.
|
||||
|
||||
## The other way: create a folder while creating a file
|
||||
|
||||
**Add File → New File** and type a path in the name box:
|
||||
|
||||
```
|
||||
reports/2026/january.md
|
||||
```
|
||||
|
||||
Both folders and the file are created together. Use this when you already know the first file.
|
||||
|
||||
## Naming rules that save you pain
|
||||
|
||||
| Avoid | Use |
|
||||
|-------|-----|
|
||||
| `Ağ Ödevi (1)` | `network-lab-01` |
|
||||
| `My Notes` | `my-notes` or `notes` |
|
||||
| `resimler ve ekler` | `assets` |
|
||||
|
||||
Folder names with **spaces** or brackets make links harder to share, and relative image paths inside Markdown are more fragile. Lowercase letters, digits and hyphens are always safe.
|
||||
|
||||
---
|
||||
|
||||
# 🇹🇷 04 — Dizin oluşturma
|
||||
|
||||
## 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.
|
||||
Reference in New Issue
Block a user