Başlarken

Starlight, Astro çerçevesi üstüne kurulmuş çok özellikli bir dokümantasyon temasıdır. Bu rehber, yeni projeye başlamanda yardımcı olacak. Mevcut Astro projesine Starlight eklemek için elle kurulum talimatlarını incele.

Hızlı Başlangıç

Yeni Proje Oluşturma

Aşağıdaki komutu terminalinde çalıştırarak yeni bir Astro + Starlight projesi oluştur:

npm

npm create astro@latest -- --template starlight

pnpm

pnpm create astro --template starlight

Yarn

yarn create astro --template starlight

Bu, siten için yapılandırmalar ve tüm gerekli dosyalarla birlikte yeni bir proje dizini oluşturacaktır.

Çalışan haline göz at

Starlight’ı tarayıcında dene: StackBlitz’deki taslağı aç.

Geliştirme sunucusunu başlat

Astro’nun geliştirme sunucusu lokalinizde çalışırken, çalışmanızı önizlemeye ve otomatik olarak tarayıcınızın değişiklik yaptığınızda yenilenmesine olanak tanır.

Geliştirme sunucusunu başlatmak için aşağıdaki komutu proje dizininizde çalıştırın:

npm

npm run dev

pnpm

pnpm dev

Yarn

yarn dev

Bu, terminalinizde lokal önizleme bağlantılı bir mesaj gösterecektir. Sitenizi tarayıcıda görüntülemek için bu bağlantıyı açın.

İçerik Ekle

Starlight, yeni bir içerik eklemen ya da var olan dosyalarını getirmen için hazır!

src/content/docs/ dizini içerisinde yeni Markdown dosyaları oluşturarak yeni sayfalar ekleyin.

Dosya bazlı gezinim ve MDX ile Markdoc dosya desteği hakkında daha fazlası için “Sayfalar” rehberini okuyun.

Sonraki Adımlar

• Yapılandır: “Starlight’ı özelleştirmek” rehberinde ortak ayarlar hakkında öğren.
• Gezinme: “Kenar Çubuğu Gezinimi” rehberi ile kenar çubuğunu ayarla.
• Bileşenler: “Bileşenler” rehberinde hazır yapılmış kartlar, tablar ve daha fazlasını keşfet.
• Yayına al: Astro dokümantayonu içerisindeki “Siteni yayına al” rehberi ile çalışmanı yayınla.

Starlight’ı Güncelleme

Tip

Starlight, beta sürümünde olduğundan dolayı sıklıkla güncelleme ve geliştirmeler yapılacak. Starlight’ı güncel tuttuğuna emin ol!

Starlight bir Astro entegrasyonudur. Bunu ve diğer Astro paketlerini, terminalinde aşağıdaki komutu çalıştırarak güncelleyebilirsin:

npm

npx @astrojs/upgrade

pnpm

pnpm dlx @astrojs/upgrade

Yarn

yarn dlx @astrojs/upgrade

Starlight Değişim Günlüğü‘nde her yayın içindeki değişikliklerin tümünü listeleyebilirsin.

Starlight’ta Sorun Giderme

Starlight Proje Yapılandırması ve Benzersiz Sayfa Ön-bölüm Yapılandırması bilgileri, bu sitenin referanslar bölümünde mevcuttur. Bu sayfalardan, Starlight siteni doğru yapılandırdığından ve sitenin düzgün çalıştığından emin olmak için kullanabilirsin.

İçerik eklemede ve Starlight siteni özelleştirmene yardımcı olmak için kenar çubuğundaki rehber listesine göz at. Aradığın cevap dokümantasyonda yoksa, tüm Astro dokümantasyonu için lütfen Astro Dokümantasyonu‘nu ziyaret et. Starlight teması altında Astro’nun genel olarak nasıl çalıştığıyla sorun yanıtlanmış olabilir.

Ayrıca, GitHub üzerindeki Starlight sorunları‘nı kontrol edebilir, aktif ve dost canlısı topluluğumuzdan Astro Discord üzerinden yardım isteyebilirsin! Sorularını #support forumunda “starlight” etiketi ile sorabilir, ya da özel #starlight kanalımızı mevcut geliştirmeler ve daha fazlası için ziyaret edebilirsin!