# Ders dosyası biçimi

Online IDE'nin **Dersler** bölümü bu dizindeki `NN-ad.md` dosyalarından üretilir
(dosya adı sırası = ders sırası). Her ders tek dosyadır.

⚠️ Yayına almadan önce `hazirla.py` her çalıştırılabilir kod bloğunu ve her
alıştırmanın çözümünü **gerçekten derleyip çalıştırır** ve çıktıyı dosyada
yazanla karşılaştırır. Tutmayan ders listeye girmez.

## Başlık bilgisi

```
---
baslik: Değişkenler
bolum: Temeller
ozet: Değerlere ad vermek, türler ve atama
---
```

`bolum` aynı olan dersler yan çubukta aynı başlık altında toplanır.

## Metin

Düz paragraf, `## Alt başlık`, `### Küçük başlık`, **kalın**, *eğik*,
`satır içi kod`, [bağlantı](https://…), `-` ya da `1.` ile listeler,
`| a | b |` tabloları (ikinci satır `|---|---|`).

Not kutusu: `>` ile başlayan satırlar. İlk sözcük türü belirler:

```
> **İpucu:** …        (bilgi)
> **Dikkat:** …       (uyarı)
> **Not:** …          (nötr)
```

## Kod örneği

Kod bloğu `kbl` dilinde yazılır. Hemen ardından gelen `cikti` bloğu beklenen
çıktıdır; ikisi birlikte doğrulanır ve sayfada "Dene" düğmesiyle gösterilir.

    ```kbl
    yazdir("Merhaba")
    ```
    ```cikti
    Merhaba
    ```

Program girdi okuyorsa `girdi` bloğu `cikti`dan önce gelir; satırlar sırayla
standart girdiye verilir:

    ```kbl
    kullan kaba.sistem
    konsol.yaz("Adın: ")
    ad = konsol.satir_oku().deger_veya("misafir").kirp()
    yazdir(f"Merhaba {ad}")
    ```
    ```girdi
    Ayşe
    ```
    ```cikti
    Adın: Ayşe
    Merhaba Ayşe
    ```

(Program uçbirimde çalışır; verilen girdi, kullanıcı yazmış gibi ekranda da görünür.)

Doğrulanmayacak blok (ör. bilerek hatalı kod, yalnız gösterim):
`kbl goster`. Bu blokta "Dene" düğmesi yine vardır.

## Alıştırma

Dersin sonunda bir ya da birkaç alıştırma. Bölümler `%%%` satırıyla ayrılır:
soru (markdown) · başlangıç kodu · çözüm · beklenen çıktı. Çözüm çalıştırılıp
beklenen çıktıyla karşılaştırılır; öğrencinin kodu da aynı çıktıyı verince
alıştırma tamamlanmış sayılır.

    ```alistirma
    `sayi` değişkeninin karesini ekrana yazdır.
    %%%
    sayi = 7
    # buraya yaz
    %%%
    sayi = 7
    yazdir(sayi * sayi)
    %%%
    49
    ```

Karşılaştırmada satır sonlarındaki boşluklar ve en sondaki boş satırlar yok
sayılır.