guide/07-images-and-media/readme.md

# 🇬🇧 07 — Images and attachments

## Putting an image in a document

1. Upload the image next to the document: open the folder, **Add File → Upload File**.
2. Reference it from the Markdown file:

```markdown
![Network topology](topology.png)
```

The text in brackets is the description shown if the image cannot load, and read aloud by screen readers. Write a real description, not "image".

## Where to keep images

A predictable layout that always works:

```
project/
  readme.md
  assets/
    topology.png
    rack.jpg
```

and in `readme.md`:

```markdown
![Network topology](assets/topology.png)
```

## Naming — the one rule to remember

Use lowercase names without spaces for **folders** and image files:

| Fragile | Safe |
|---------|------|
| `Ekran Alıntısı.PNG` | `ekran-alintisi.png` |
| `1-) Inter-VLAN Notes/` | `01-inter-vlan/` |

If a name does contain spaces, write them as `%20` in the link:

```markdown
![Topology](Ekran%20Alintisi.PNG)
```

## Controlling the size

Markdown has no size option, so use a plain HTML tag when you need one:

```markdown
<img src="assets/topology.png" alt="Network topology" width="600">
```

## Linking a file instead of showing it

Drop the exclamation mark and you get a download link:

```markdown
[Packet Tracer file](main.pkt)
```

## Attachments in issues

While writing an issue or a comment, drag a file into the text box. It is uploaded and the link is inserted for you. Use this for screenshots and logs that do not belong in the repository itself.

---

# 🇹🇷 07 — Görseller ve ekler

## 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.