ServBay Ortamında Jigsaw Kurulumu ve Yapılandırması

Jigsaw Nedir?

Jigsaw, Laravel tabanlı bir statik site jeneratörüdür ve dökümantasyon, bloglar ve basit statik siteler oluşturmak için uygundur. Esnek bir şablon sistemi ve güçlü geliştirme araçları sunar, bu da statik siteleri oluşturmayı ve yönetmeyi çok basit hale getirir.

Jigsaw Kurulum Aşamaları

Bu makalede, ServBay ortamında Jigsaw'ın nasıl kurulacağını ve yapılandırılacağını anlatacağız.

Adım 1: Proje Dizini Oluşturma

Öncelikle, ServBay'in www dizininde yeni bir proje dizini oluşturun:

cd /Applications/ServBay/www
mkdir servbay-jigsaw-app
cd servbay-jigsaw-app

Adım 2: Composer Kullanarak Jigsaw Projesi Oluşturma

ServBay zaten Composer ile birlikte gelir, bu nedenle Composer'ı kullanarak doğrudan Jigsaw projesi oluşturabiliriz:

composer create-project tightenco/jigsaw

Adım 3: Web Sunucusunu Yapılandırma

1. Yeni Site Ekleme

   ServBay'i açın, "Ana Bilgisayar" sekmesine tıklayın ve yeni bir site ekleyin:

   • Adı: My Jigsaw Site
   • Alan Adı: servbay-jigsaw.local
   • Site Türü: PHP
   • PHP Sürümü: Uygun PHP sürümünü seçin
   • Site Kök Dizini: /Applications/ServBay/www/servbay-jigsaw-app/build_local

2. Yapılandırmayı Kaydet

   Yapılandırmayı kaydedin.

Adım 4: Jigsaw Sitesini Oluşturma

1. Bağımlılıkları Yükleme

   Proje dizininde npm bağımlılıklarını yüklemek için aşağıdaki komutu çalıştırın:

   npm install

2. Siteyi Oluşturma

   Jigsaw sitesini oluşturmak için aşağıdaki komutu çalıştırın:

   ./vendor/bin/jigsaw build

Adım 5: Yerel Geliştirme Sunucusunu Çalıştırma

1. Geliştirme Sunucusuna Erişme

   Tarayıcıyı açın ve https://servbay-jigsaw.local adresine gidin, Jigsaw sitesinin yerel geliştirme sürümünü göreceksiniz.

Adım 6: Jigsaw Sitesini Özelleştirme

1. İçeriği Düzenleme

   source dizininde Markdown dosyalarını ve Blade şablon dosyalarını düzenleyerek sitenizin içeriğini ve düzenini özelleştirin.

2. Yeni Sayfa Eklemek

   source dizininde yeni bir Markdown dosyası oluşturarak yeni bir sayfa ekleyin. Örneğin, about.md dosyasını oluşturun:

   ---
   title: "Hakkımızda"
   ---
   
   # Hakkımızda
   
   Bu, hakkımızda sayfasıdır.

3. Navigasyon Menüsünü Yapılandırma

   source/_layouts dizininde navigasyon menüsünün Blade şablon dosyasını düzenleyerek yeni navigasyon bağlantıları ekleyin.

4. Siteyi Yeniden Oluşturma

   İçeriği veya şablonu her değiştirdiğinizde, Jigsaw sitesini yeniden oluşturmak için aşağıdaki komutu çalıştırın:

   ./vendor/bin/jigsaw build

Jigsaw Kullanarak Site Oluşturma

Şimdi ServBay ortamında Jigsaw'ı başarıyla kurdunuz ve yapılandırdınız, onu sitenizi oluşturmak için kullanmaya başlayabilirsiniz. İşte bazı yaygın işlemler:

Blog Yazısı Oluşturma

1. Yazı Oluşturma

   source/_posts dizininde yeni bir Markdown dosyası oluşturarak blog yazısı ekleyin. Örneğin, 2024-06-05-my-first-post.md dosyasını oluşturun:

   ---
   title: "İlk Yazım"
   date: 2024-06-05
   ---
   
   # İlk Yazım
   
   Bu, ilk yazımın içeriğidir.

2. Siteyi Yeniden Oluşturma

   Jigsaw sitesini oluşturmak için aşağıdaki komutu çalıştırın:

   ./vendor/bin/jigsaw build

Stil ve Scriptleri Özelleştirme

1. Stilleri Düzenleme

   source/_assets/sass dizininde SCSS dosyalarını düzenleyerek sitenizin stilini özelleştirin.

2. Scriptleri Düzenleme

   source/_assets/js dizininde JavaScript dosyalarını düzenleyerek sitenizin etkileşimli davranışlarını özelleştirin.

3. Kaynakları Derleme

   SCSS ve JavaScript dosyalarını derlemek için aşağıdaki komutu çalıştırın:

   npm run dev

Bu adımlar sayesinde, ServBay ortamında başarıyla Jigsaw'ı kurdunuz ve yapılandırdınız ve sitenizi oluşturmaya başladınız. Jigsaw'ın sadeliği ve esnekliği onu statik siteler oluşturmak için ideal bir seçenek haline getiriyor.