Bu site nasıl çalışır? Tek sayfada
Bloklar, Tan, export ve embed tek sayfada: 37 blok, dört çıktı biçimi, sitenin yapım durumu ve en sık sorulanlar. Aşağı kaydırarak okuyun.
37
Bu site
hazır blok
Her biri aynı props ile hem slaytta hem infografikte çalışır. Bu sayfa da onlarla yazıldı.
Bir bakışta
Rakamlarla site
- 37BlokMDX'e importsuz enjekte edilir
- 28Tan pozupose prop'u ile seçilir
- 4Çıktı biçimiDeck, infografik, export, embed
- 2DilTürkçe kökte, İngilizce /en/ altında
Çıktılar
Nerede kesişirler
Deck ve infografik aynı blokları paylaşır; ikisi de embed rotasıyla başka sitede gösterilebilir.
- Deck ve İnfografik: Aynı bloklar, aynı props
- Deck ve Embed: /embed/d/<slug>/
- İnfografik ve Embed: /embed/i/<slug>/
- Üçü birden: iframe kodu
Mimari
Katmanlar
Yukarıdan aşağıya: yazdığınız şey en üstte, üretilen dosyalar en altta.
- MDX içeriğisrc/content/ altında, importsuz
- Bloklar, Slide ve PanelDeck sahnesi 1920×1080, infografik en çok 1200 px
- Astro 7 + Tailwind v4output: 'static'
- dist/Statik çıktı
- public/exports/PNG ve PDF, depoya girer
Çıktı haritası
Hangi biçim nerede
Satırlar içerik türünü, sütunlar çıktının nerede okunduğunu gösterir.
Deck ↔ İnfografik
Deck, ekranda
/d/<slug>/
- Klavye ile ilerleme
- Tam ekran: F
- Genel bakış: O
Deck, dosya olarak
PNG ve PDF
- Slayt başına 1920×1080 PNG
- Slayt başına bir sayfa PDF
İnfografik, ekranda
/i/<slug>/
- Dikey kaydırma
- En çok 1200 px genişlik
- Ziyaretçinin teması korunur
İnfografik, dosya olarak
PNG ve PDF
- 1200 px genişlikte tam sayfa PNG
- Tek sayfa PDF
Ekranda ↔ Dosya olarak
Parçalar
Kim ne yapar
Slide
1920×1080 sabit sahne; ekrana göre ölçeklenir.
Panel
En çok 1200 px genişlikte infografik şeridi.
deck.ts
Klavye, tam ekran, genel bakış ve #/n derin bağlantı.
export.mjs
dist/'i Playwright ile açıp PNG ve PDF üretir.
EmbedCode
Slayt ya da infografik için iframe kodunu verir.
Tan
Maskot; 28 pozla bloklara eşlik eder.
Döngü
İçerik değişince
Sıra bozulmaz: export, build'in çıktısını okur. Export'u build'den önce koşturmak eski sayfayı yakalar.
Her değişiklikte
- 01DüzenleMDX dosyası
- 02Buildnpm run build
- 03Exportnpm run export
- 04Commitpublic/
exports/ dahil
Başlık düzeni
Blokların başlık alanları
- Tüm bloklar37
- eyebrow alan35
- eyebrow ve title ikisi de olan31
Ölçekleme
Ekran büyüdükçe sahne
sahne ölçeği, %
Genişlik ÷ 1920; ölçüm değil, hesap
Fark
Blok olmadan ve blokla
- Slayt düzeni her seferinde yeniden çizilir
- Renkler elle seçilir
- PNG ve PDF ekran görüntüsüyle alınır
- Bloklar props ile doldurulur
- Renkler token'dan gelir (ADR-002)
- npm run export PNG ve PDF üretir
Yapım
Site nasıl yapıldı
- 00 — .ssot/ kurulumutamam
- 01 ve 01b — Proje iskeleti, site kimliğitamam
- 02 — Görsel dil (Claude Design)tamam
- 03 — Blok kütüphanesitamam
- 04 — Deck ve infografiktamam
- 05 — Embed ve exporttamam
- 06 — Vitrin içeriğitamam
Durum
Yapım durumu, yayın günü
- 8Tamam
- 0Sürüyor
- 0Bekliyor
Pano
Yayın günündeki pano
Tamam
4 kart- Faz 03
Blok kütüphanesi
- Faz 04
Deck runtime ve infografik
- Faz 05
Embed ve export
- Faz 06
Vitrin: bu deck ve bu infografik
- Faz 03
Sürüyor
1 kart- Deploy
Cloudflare Pages yayını, onayınızla
- Deploy
Sonra
1 kart- Deploy
Çerçeveleme doğrulaması: curl -sI ile iki rota
- Deploy
Dikkat
Dört not
- NotExport yalnız yerelde koşar; Cloudflare build'inde çalışmaz.
- İpucuSlayt sayısı değiştiyse export'tan sonra bir kez daha build alın; indirme bağlantıları build anında basılır.
- UyarıExport'u build'den önce koşturursanız eski build'i yakalar.
- ÇerçevelemeYalnız /embed/ rotaları gömülebilir. /d/ ve /i/ adreslerini iframe'e koyarsanız tarayıcı engeller.
Sözlük
Bu sayfadaki terimler
- Blok
- Props ile doldurulan hazır görsel parça; src/components/blocks/ altında 37 tane.
- Props
- Bir bloğa verilen metin ve ayarlar; adları sabittir.
- Slide
- Deck'in 1920×1080 sabit sahnesi.
- Panel
- İnfografiğin en çok 1200 px genişlikteki bölümü.
- Poz
- Tan'ın 28 görünümünden biri; pose prop'u ile seçilir.
- Export
- Sayfadan üretilen PNG ve PDF dosyaları.
- Embed
- Bir slaytın ya da infografiğin iframe ile başka sitede gösterilmesi.
Sık sorulanlar
Sorular ve cevaplar
Soru: Slaytları düzenleyici ile değiştirebilir miyim?
Cevap: Hayır. Düzenleyici kapsam dışıdır (PRD). İçerik bir MDX dosyasıdır; değişiklik dosyada yapılır.
Soru: Bir slaytı başka sitede gösterebilir miyim?
Cevap: Evet. Her slaytın /embed/d/<slug>/<n>/ adresi ve sayfada hazır bir iframe kodu vardır.
Soru: PDF ve PNG nereden inecek?
Cevap: Sayfadaki indirme bağlantılarından. Dosyalar public/exports/ altındadır ve depoya girer.
Soru: İngilizce var mı?
Cevap: İngilizce içerik /en/ altında yayınlanır. Karşılığı olmayan içerik yalnız kendi dilinde yayınlanır (ADR-006).
Soru: Tema seçebilir miyim?
Cevap: Site koyu temayla açılır. Deck kendi temasında kilitli açılır; infografik sizin seçiminizi korur.