kılavuz: 07-images-and-media/readme.md

2026-07-24 06:31:34 +00:00
parent 1258e6cc85
commit 56557dbb5e
1 changed files with 133 additions and 0 deletions
@@ -0,0 +1,133 @@
+# 🇬🇧 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.