İçeriğe geç
yazilimrehberi.dev

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
Terminal window
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.

Terminal window
    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.

Terminal window
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.