Proje Yapısı

Bu rehber size bir Starlight projesinin nasıl organize edileceğini ve farklı dosyaların projenizde neler yapacağını gösterir.

Starlight projeleri, diğer Astro projelerinde olduğu gibi aynı dosya ve dizin yapısını takip eder. Astro’nun proje yapısı dokümantasyonunu daha fazla bilgi için inceleyin.

Dosyalar ve dizinler

• astro.config.mjs — Astro yapılandırma dosyası. Starlight entegrasyon ve yapılandırmasını içerir.
• src/content/config.ts — İçerik koleksiyonlarını yapılandırma dosyası. Starlight’ın önbölüm şemasını projenize ekler.
• src/content/docs/ — İçerik dosyaları. Starlight bu dizin altındaki her bir .md, .mdx ya da .mdoc uzantılı dosyayı websitenizde bir sayfaya dönüştürür.
• src/content/i18n/ (opsiyonel) — Uluslararasılaştırmayı desteklemek için çeviri verisi.
• src/ — Projeniz için diğer kaynak kodu ve dosyaları (bileşenler, stiller, görseller vb.).
• public/ — Astro ile işlenmeyen statik mülkler (yazı karakterleri, sekme simgesi, PDF’ler, vb.).

Örnek proje içerikleri

Bir Starlight projesi dizini bunun gibi görülebilir:

• Dizinpublic/

  • favicon.svg
• Dizinsrc/

  • Dizinassets/

    • logo.svg
    • screenshot.jpg
  • Dizincomponents/

    • CustomButton.astro
    • InteractiveWidget.jsx
  • Dizincontent/

    • Dizindocs/

      • Dizinguides/

        • 01-getting-started.md
        • 02-advanced.md
      • index.mdx
    • config.ts
  • env.d.ts
• astro.config.mjs
• package.json
• tsconfig.json