Astro Starlight

Astro Starlight, Astro web çerçevesi üzerine inşa edilmiş bir dokümantasyon temasıdır. Hızlı, erişilebilir ve kolay bakım yapılabilir dokümantasyon web siteleri oluşturmak için hazır bir yapı sunar. Diğer dokümantasyon araçlarının aksine, Starlight tarayıcıya minimum JavaScript gönderir, bu da daha hızlı yükleme süreleri ve daha iyi performans sağlar.

Araç, dokümantasyonunuzu oluştururken size esneklik sağlayan Markdown, MDX ve Markdoc formatlarında içerik yazmayı destekler. Otomatik gezinme oluşturma, Pagefind destekli yerleşik arama ve tüm cihazlarda çalışan duyarlı tasarım içerir. Starlight ayrıca kutudan çıktığı gibi çoklu dil desteği sunar, bu da onu küresel dokümantasyon projeleri için uygun kılar. Tema, yapılandırma dosyaları aracılığıyla yüksek derecede özelleştirilebilir olup, kurulumun sadeliğini korurken markanıza uyum sağlamanıza olanak tanır.

Astro Starlight ile başlaması basittir ve sadece birkaç adım gerektirir:

• Starlight'ı terminalinizde npm create astro@latest -- --template starlight komutunu çalıştırarak komut satırı üzerinden kurun. Bu işlem her şeyi otomatik olarak ayarlar.

• Kurulum tamamlandıktan sonra, npm run dev komutuyla geliştirme sunucusunu başlatın ve belgeler sitenizi tarayıcınızda yerel olarak önizleyin.

• src/content/docs/ dizininde Markdown veya MDX dosyaları oluşturarak yeni belge sayfaları ekleyin. Her dosya otomatik olarak bir sayfa haline gelir.

• astro.config.mjs dosyasında site ayarlarınızı yapılandırın. Burada site başlığınızı belirleyebilir, sosyal medya bağlantıları ekleyebilir ve gezinme yan menüsünü özelleştirebilirsiniz.

• Belgeler dizini içinde klasörler oluşturarak sayfalarınızı düzenleyin. Starlight, dosya yapınıza göre otomatik olarak gezinme oluşturur.

• Yayınlamaya hazır olduğunuzda, npm run build komutuyla sitenizi derleyin ve Netlify, Vercel veya GitHub Pages gibi herhangi bir statik barındırma hizmetine dağıtın.

• Minimum JavaScript ile hızlı statik site oluşturma

• Pagefind ile yerleşik arama

• Tam uluslararasılaştırma desteği

• Otomatik gezinme oluşturma

• Karanlık ve aydınlık temalar dahil

• Markdown, MDX ve Markdoc desteği

• Çoklu çerçeve entegrasyonu (React, Vue, Svelte)

• Erişilebilirlik odaklı tasarım

• Mobil uyumlu düzen

• Özelleştirilebilir temalar ve renkler

• Sayfa düzenleme bağlantıları

• Sosyal medya entegrasyonu

• SEO optimize edilmiş