Kurulum
Astro’yu yüklemeye hazır mısınız? Başlamak için astro CLI oluşturmayı kullanmak için bu kılavuzu izleyin..
İlk Projemize Başalaylım
Gerekenler:
- Node.js - v16.12.0 Sürümü Veya Daha Yüksek bir sürümü.
- VSCode - Astro.js VSCode ile beraber kendi eklentisini kullanılmasını istiyor.
- Terminal - Astro’ya komut satırı arayüzü (CLI) aracılığıyla erişilir. Terminali bir klasör içinde açıyoruz. ve aşağıdaki kodu yazıyoruz
npm create astro@latest
Bu kodu terminale yazığ Enter’a bastıktan sonra “Yeni Projenizi Nereye Oluşturmak İstiyorsunuz” diye Soruyor bu işleme (.) Nokta ile cevap verirseniz bulunduğunuz klasörü seçmiş olursunuz. Daha sonra “Ne tarz bir Projeye başlayacaksınız” sorusu gelir. Seçenekler:
- Include Sample File = Hazır Template Dosyalarını Klasöre oluştururuz. Başlangıç için ideal bir seçenektir.
- Use blog template = markdown ve markdownJS dosyaları ile hazır blog şablonu oluşturur.
- Empty = Size sadece index dosyasını oluşturur. Eğer Astro’yu tamamen öğrendiyseniz Sıfırdan projeleri bu seçenek ile üretebilirsiniz.
Daha sonraki gelecek terminal ekranında ise size (Install Dependencies?) Yani Bağımlılıkları Yüklemek İstiyor musunuz? diye soracak. Burada (Yes) veya (No) Seçenekleri bulunuyor. Bağımlılıklar yön tuşları ile seçeenkler arası dolaşıp (Yes) Seçeneğini seçebilirsiniz.
Bir sonraki seçenek olarak size TypeScript yazmayı düşünüyor musunuz diye soruyor. aynı şekilde evet veya hayır ı seçebilirsiniz. eğer hayır seçeneğini seçtiyseniz daha sonradan da typescript özelliğini yüklemenize izin vermektedir.
Bir sonraki seçenek Github deposu oluşturmak istiyormusunuz diye soruyor eğer kodlarınızı github da yayınlamak istiyorsanız seçebilirsiniz.
Projemizi Çalıştıralım
Terminali açıyoruz ve aşağıdaki kodları giriyoruz.
npm run dev
Her şey yolunda giderse, Astro projenizi localhost:3000 veya localhost:4321 gibi bir boş portta çalıştıracaktır.
Astro, src/ dizininizdeki canlı dosya değişikliklerini dinler, böylece geliştirme sırasında değişiklik yaparken sunucuyu yeniden başlatmanız gerekmez.
Eğer Projenizi Çalıştırırken hata alıyorsanız package.json dosyanızı kontrol edebilirsiniz.
Başlangıç Şablonları
İsterseniz resmi astro Sablonlarını seçebilirsiniz isterseniz github üzerinden oluşturabilirsiniz.
Örneğin: “astro-paper” isminde Github’ da yayınlanmış bir şablonu oluşturmak istiyorsunuz.
Terminali açıyoruz ve aşağıdaki kodları giriyoruz.
npm create astro@latest -- --template satnaing/astro-paper
Bu kod ile github üzerinden beğendiğiniz bir şablonu oluşturabilirsiniz. Astronun Kendi Sitesinde yayınladığı şablonlar için Buraya tıklayabilirsiniz.