İçeriğe geç
Starlight

Başlarken

Yeni Proje Oluşturma

Starlight, Astro çerçevesi üstüne kurulmuş çok özellikli bir dokümantasyon temasıdır.

Aşağıdaki komutları kullanarak yeni bir Astro + Starlight projesi oluşturabilirsin:

Terminal window
# npm ile yeni bir proje oluştur
npm create astro@latest -- --template starlight

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

Starlight ile İçerik Oluşturmak

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

Dosya Formatları

Starlight, içerik yazmada Markdown ve MDX formatlarını destekler. (Deneysel Astro Markdoc entegrasyonu‘nu yükleyerek Markdoc formatı için destek ekleyebilirsin.)

Sayfa Ekle

src/content/docs/ dizini altında .md or .mdx uzantılı dosya ekleyerek otomatik olarak sitene yeni sayfalar ekle. Dosyalarını organize etmek ve çoklu dizim bölümleri oluşturmak için yeni alt klasörler ekle:

src/content/docs/hello-world.md => your-site.com/hello-world
src/content/docs/guides/faq.md => your-site.com/guides/faq

Tip-korumalı Ön BÖlüm

Tüm Starlight sayfaları özelleştirilebilir ortak ön-bölüm mülkleri seti‘ni, sayfaların nasıl görüntüleneceğini kontrol etmek için paylaşır:

---
title: Merhaba, Dünya!
description: Bu, Starlight'la hazırlanmış sitemdeki bir sayfadır.
---

Herhangi önemli bir şeyi unutursan, Starlight sana hatırlatacaktır.

Starlight Web Siteni Yayına Al

Starlight websiteni oluşturduktan ve özelleştirdikten sonra; bir web sunucusunda ya da Netlify, Vercel, GitHub Pages ve daha fazla barındırma platformundan herhangi birinde yayına alabilirsin.

Astro dokümantasyonunda, bir Astro sitenin nasıl yayına alındığını öğren.

Starlight’ı Güncelleme

Starlight bir Astro entegrasyonudur ve herhangi bir @astrojs/* entegrasyonu gibi güncellenir:

Terminal window
# npm ile Starlight'ı güncelle
npm install @astrojs/starlight@latest

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!