🇬🇧 07 — Images and attachments

Putting an image in a document

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

![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:

![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:

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

Controlling the size

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

<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:

[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

Görseli belgenin yanına yükleyin: klasörü açın, Dosya Ekle → Dosya Yükle.
Markdown dosyasından ona atıf yapın:

![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:

![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:

![Topoloji](Ekran%20Alintisi.PNG)

Boyut ayarlama

Markdown'da boyut seçeneği yoktur; gerektiğinde düz HTML etiketi kullanın:

<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:

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