Dersler ve Temeller; web örnekleri PORT ortam değişkenini okur

- dersler/: 29 kısa ders (açıklama, çalıştırılabilir örnek, alıştırma). Her örneğin ve alıştırma çözümünün çıktısı Online IDE'nin hazırlık adımında gerçekten koşulup dosyadakiyle karşılaştırılır; biçim dersler/BICIM.md. - temeller/: tek konulu 12 başlangıç programı. - web/anket, web/kisalt, web/pano: port PORT ortam değişkeninden okunur (Online IDE önizlemesi 8080 verir), yoksa eski sabit port. - README: öğrenme bölümü, Online IDE bağlantısı.
2026-10-17 22:07:47 +03:00
parent c5468f5d0a
commit 494781e84f
47 changed files with 5942 additions and 4 deletions
@@ -0,0 +1,94 @@
+---
+baslik: Yorumlar
+bolum: Giriş
+ozet: Kodun içine kendine ve başkalarına not bırakmak
+---
+
+Yorum, derleyicinin okumadığı, yalnız insanlar için yazılmış nottur. Bir hafta sonra kendi koduna baktığında "bunu neden yazmıştım?" diye sormamak için yorum yazarsın.
+
+## Tek satırlık yorum
+
+`#` işaretinden sonra satırın sonuna kadar her şey yorumdur.
+
+```kbl
+# Bu program bir selam yazar.
+yazdir("Merhaba!")
+```
+```cikti
+Merhaba!
+```
+
+## Satır sonunda yorum
+
+Kodun yanına da yorum yazabilirsin. `#`'den öncesi çalışır, sonrası yok sayılır.
+
+```kbl
+fiyat = 250        # TL cinsinden
+adet = 3           # sepetteki ürün sayısı
+yazdir(fiyat * adet)
+```
+```cikti
+750
+```
+
+## Kodu geçici olarak kapatmak
+
+Bir satırın başına `#` koyarsan o satır çalışmaz. Silmeden denemek için çok işe yarar.
+
+```kbl
+yazdir("Birinci satır")
+# yazdir("Bu satır şimdilik kapalı")
+yazdir("Üçüncü satır")
+```
+```cikti
+Birinci satır
+Üçüncü satır
+```
+
+## Metnin içindeki # yorum değildir
+
+Tırnak içindeki `#` sıradan bir karakterdir.
+
+```kbl
+yazdir("Sıra numaran: #12")   # bu kısım ise yorum
+```
+```cikti
+Sıra numaran: #12
+```
+
+> **İpucu:** İyi yorum kodun *ne* yaptığını değil *neden* yaptığını anlatır. `x = x + 1  # x'i bir artır` gereksizdir; `misafir += 1  # kapıdaki kişiyi de sayıyoruz` işe yarar.
+
+## Birden çok satırlık açıklama
+
+Uzun bir açıklama için her satırın başına `#` koyarsın.
+
+```kbl
+# Kargo ücreti hesabı:
+#   500 TL ve üstü siparişte kargo ücretsiz,
+#   altında 60 TL.
+sepet = 420
+kargo = 60
+eger sepet >= 500:
+    kargo = 0
+yazdir("Kargo:", kargo, "TL")
+```
+```cikti
+Kargo: 60 TL
+```
+
+## Alıştırma
+
+```alistirma
+Aşağıdaki programda ikinci satır hatalı bir duyuru yazıyor. O satırı **silmeden**, başına `#` koyarak kapat. Çıktıda yalnız iki doğru satır kalsın.
+%%%
+yazdir("Kütüphane 09:00'da açılır.")
+yazdir("Kütüphane pazar günü de açıktır.")
+yazdir("Kütüphane 18:00'de kapanır.")
+%%%
+yazdir("Kütüphane 09:00'da açılır.")
+# yazdir("Kütüphane pazar günü de açıktır.")
+yazdir("Kütüphane 18:00'de kapanır.")
+%%%
+Kütüphane 09:00'da açılır.
+Kütüphane 18:00'de kapanır.
+```