diff --git a/07-images-and-media/readme.md b/07-images-and-media/readme.md new file mode 100644 index 0000000..5f13041 --- /dev/null +++ b/07-images-and-media/readme.md @@ -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 +Network topology +``` + +## 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 +Ağ topolojisi +``` + +## 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.