Bu öğretici ile ilk AstroJS proje'nizi nasıl oluşturacağınızı öğreneceksiniz. npm create astro aracını kullanarak OpenAI API ile etkileşim kurabilen bir sunucu uygulaması oluşturacağız. Oluşturulan proje yapısını keşfedecek ve nasıl çalıştırılacağına dair kısa bir genel bakış sunacağız. Hadi başlayalım!

En Önemli Bulgular

  • AstroJS'de yeni bir proje oluşturmak kolaydır ve etkileşimli bir sihirbaz tarafından desteklenir.
  • Proje oluşturma, Bağımlılıkların (NPM Modül) yapılandırılmasını ve proje adının belirlenmesini içerir.
  • AstroJS'in entegre Hot-Reload fonksiyonu, sayfayı manuel olarak yeniden yüklemeden değişiklikleri anlık olarak görmemizi sağlar.

Adım Adım Kılavuz

AstroJS projenizi oluşturmak için aşağıdaki adımları izleyin:

İlk olarak terminalinizi açmalısınız. Komutları çalıştırabildiğinizden emin olun. İlk adım npm create astro komutunu girmektir. Bu komut, sizi yeni projenin oluşturulması sürecinde yönlendiren bir sihirbaz başlatacaktır. 

AstroJS temel projesinin oluşturulması

Sihirbaza başladığınızda belirli bir NPM paketinin kurulumunu onaylamanız istenebilir. Bu durumda kurulumu onaylayın.

Daha sonra yeni projeniz için bir isim seçmeniz istenecektir. Bizim durumumuzda projeyi ai-chat olarak adlandırıyorum. İstediğiniz adı girin ve enter tuşuna basın.

Sihirbaz daha sonra örnek dosyaların yüklenip yüklenmeyeceğinizi soracaktır. Biz gerek duymadığımız için "hayır"ı seçin ve devam edin.

AstroJS temel projesinin oluşturulması

Sonraki adım, gerekli Bağımlılıkların yüklenmesidir. İlgili npm modüllerini doğrudan yüklemek isteyip istemediğiniz sorulacaktır. Kurulum sürecini otomatikleştirmek için bunu kabul etmeniz önerilir.

AstroJS temel projesinin oluşturulması

Bağımlılıklar yüklendikten sonra, Sihirbaz TypeScript kullanıp kullanmayacağınızı soracaktır. TypeScript kullanımını reddetmeniz önerilir, çünkü bu karmaşıklığı artırabilir. Gerektiğinde daha sonra istediğiniz zaman TypeScript ekleyebilirsiniz.

AstroJS temel projesinin oluşturulması

Bir sonraki adım, başlangıçta bir başlangıç deposu kullanıp kullanmayacağınıza karar vermektir. Genellikle bu başlangıçta gerekli değildir, bu yüzden burada da "hayır"ı seçin.

AstroJS temel projesinin oluşturulması

Tüm sorulara cevap verildikten sonra, Sihirbazdan güzel bir bitiriş mesajı alacaksınız. Bu onay ile projenin temel kısmı tamamlanmış olacak.

AstroJS temel projesinin oluşturulması

Oluşturulan projenin yapısına bir göz atalım. Oluşturulan yapıyı keşfetmek için oluşturulan dizine cd ai-chat ile geçin.

AstroJS taban projesinin oluşturulması

Projedeki yapıyı tree komutu ile görebilirsiniz. Bu size oluşturulan dosyaları ve klasörleri gösterir.

AstroJS temel projesinin oluşturulması

Projedeki dizinde, asıl Astro kaynak kodlarını içeren src klasörünü bulacaksınız. Burada başlangıç sayfanız olarak işlev gören index.astro dosyası bulunmaktadır ve onunla ilgili daha detaylı bilgi edineceğiz.

AstroJS temel projesinin oluşturulması

Astro projenizi yerel olarak çalıştırmak için bir betik çağırmanız gerekmektedir. npm run dev komutunu kullanın. Bu komut, uygulamayı sağlayan bir geliştirme sunucusu başlatacaktır.

Geliştirme sunucusu çalışmaya başladığında, genellikle localhost:3000 adresi size gösterilecektir. Bu adresi web tarayıcınızda açarak uygulamayı görebilirsiniz.

AstroJS temel projesinin oluşturulması

Adresi kopyalayıp tarayıcının adres çubuğuna yapıştırabilirsin. Alternatif olarak, adresi terminalde kontrol+tıklayarak (veya Mac'te Komut+tıklayarak) doğrudan tarayıcıda açabilirsin.

AstroJS temel projesinin oluşturulması

Her şey doğru şekilde kurulmuşsa, sunucunun başarıyla çalıştığını gösteren Astro sayfanı görmelisin.

Değişiklik yapmanın ne kadar kolay olduğunu göstermek için index.astro dosyasındaki metni değiştirebilirsin. Metni "ai Chatbot" olarak değiştirelim ve tarayıcıda değişikliğin görünüp görünmediğini kontrol edelim.

AstroJS temel projesinin oluşturulması

Değişikliği kaydettikten sonra, sayfa tarayıcıda otomatik olarak yenilenecek, manuel olarak yenileme yapmanıza gerek kalmayacak. Bu, AstroJS'nin harika özelliklerinden biridir!

AstroJS temel projesinin oluşturulması

Bu Canlı Yükleme işlevi, geliştirme sürecini önemli ölçüde hızlandırarak değişiklikleri anlık olarak görmene olanak tanır.

AstroJS temel projesinin oluşturulması

İlk Astro projen artık hazır ve daha fazla uyarlama yapabilir veya bunun üzerine inşa edebilirsin. index.astro dosyası HTML sayfasına dönüştürülüp tarayıcıya teslim edilir. Şimdi geliştirmeye başlayabilir ve yeni özellikler ekleyebilirsin.

AstroJS temel projesinin oluşturulması

Sonraki heyecan verici adımları birlikte keşfetmeye geldiğimiz bir sonraki sefere kadar!

Özet

Bu öğreticide, npm create astro ile yeni bir AstroJS projesi oluşturmayı öğrendin. Bağımlılıkların yüklenmesinden Canlı Yükleme'nin kullanımına kadar, ilk Astro sayfanı çalıştırmak için temel adımları tamamladın.

Sıkça Sorulan Sorular

AstroJS nedir?AstroJS, hızlı ve dinamik web siteleri oluşturmak için modern bir çerçevedir.

AstroJS nasıl kurulur?AstroJS'yi terminalinde npm create astro komutunu kullanarak kurabilirsin.

Astro projemde TypeScript kullanabilir miyim?Evet, projende TypeScript'i ileride etkinleştirerek kullanabilirsin.

Astro sayfamdaki değişiklikleri nasıl görebilirim?Dahili Canlı Yükleme işlevi sayfadaki değişiklikleri otomatik olarak tarayıcıda gösterir, sayfayı yenilemen gerekmez.

AstroJS, npm olmadan da çalışır mı?AstroJS, paketleri ve bağımlılıkları yönetmek için npm'ye bağımlıdır; bu nedenle npm kullanmak gereklidir.