Astro ile Kullanım

Dosya tabanlı yönlendirme

Astro, rotaların 📁 src/pages içinde bulunmasını bekler; ancak FSD bu klasörü sayfa dilimleri için bir katman olarak kullanır. İkisi için aynı klasörü kullanamayız. Bu durumu çözmek için, FSD 🥞 pages katmanı olarak 📁 src/_pages klasörünü kullanın ve 📁 src/pages klasörünü yalnızca yönlendirme için kullanın.

• Dizinsrc

  • Dizinpages Astro yönlendirmesi (ince giriş noktaları)

    • 404.astro yerleşik 404 hata sayfası
    • index.astro
  • Dizin_pages FSD pages katmanı

    • Dizinhome

      • Dizinui

        • HomePage.astro
      • index.ts

Rota dosyası yalnızca FSD katmanındaki sayfayı içe aktarır ve render eder.

src/pages/index.astro

---
import { HomePage } from '@/_pages/home';
---

<HomePage />

Yol takma adlarını (path aliases) ayarlama

src dizininden @/ kullanarak içe aktarım yapabilmek için tsconfig.json dosyasına bir yol takma adı (path alias) ekleyin:

tsconfig.json

{
  "extends": "astro/tsconfigs/strict",
  "compilerOptions": {
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

Entegrasyonlar ile çalışma

Starlight gibi bazı Astro entegrasyonları, içerikleri için içerik koleksiyonlarını (content collections) kullanır. Bu entegrasyonlar genellikle 📁 src/content/docs gibi belirli klasörlerde içerik bulunmasını bekler.

Entegrasyon kök dizin yolunu (root path) değiştirmenize izin vermiyorsa sorun değil — olduğu gibi bırakın. Genellikle içerik koleksiyonu klasörleri FSD katmanlarıyla çakışmaz; bu nedenle FSD katmanları (🥞 _pages, 🥞 shared, vb.) bu klasörlerle yan yana bulunabilir:

• Dizinsrc

  • Dizin_pages FSD pages katmanı

    • …
  • Dizincontent Entegrasyon içeriği (Starlight dokümanları vb.)

    • Dizindocs

      • getting-started.md
  • Dizinshared FSD shared katmanı

    • …

Entegrasyonun kendi yönlendirmesini ve render işlemlerini yönetmesine izin verin; FSD yapınız ise uygulamaya özgü kodu yönetsin.

Ayrıca bakınız

• Astro Yönlendirme (Routing)
• Astro Proje Yapısı