ServBay Ortamında Sculpin Kurulumu ve Yapılandırılması

Sculpin Nedir?

Sculpin, PHP tabanlı bir statik site oluşturucusudur ve bloglar, dokümantasyonlar ve diğer statik siteler oluşturmak için uygundur. Twig şablon motoru ve YAML ön uç verilerini kullanarak, web sitesi geliştirmeyi oldukça esnek ve güçlü hale getirir.

Sculpin Kurulum Adımları

Bu makalede, ServBay ortamında Sculpin'i nasıl kurup yapılandıracağınızı 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-sculpin-app
cd servbay-sculpin-app

Adım 2: Composer İle Sculpin Projesi Oluşturma

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

composer create-project sculpin/sculpin-blog-skeleton .

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

1. Yeni Site Ekleme

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

   • İsim: My Sculpin Site
   • Alan Adı: servbay-sculpin.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-sculpin-app/output_dev

2. Yapılandırmayı Kaydet

   Yapılandırmayı kaydedin ve ServBay'i yeniden başlatın.

Adım 4: Sculpin Sitesi İnşası

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

   Proje dizininde aşağıdaki komutu çalıştırarak bağımlılıkları yükleyin:

   composer install

2. Siteyi İnşa Et

   Sculpin sitesini inşa etmek için aşağıdaki komutu çalıştırın:

   vendor/bin/sculpin generate --watch --server

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

1. Yerel Geliştirme Sunucusunu Başlatın

   Yerel geliştirme sunucusunu başlatmak için aşağıdaki komutu çalıştırın:

   vendor/bin/sculpin generate --server --watch

2. Geliştirme Sunucusuna Erişin

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

Adım 6: Sculpin Sitesini Özelleştirme

1. İçeriği Düzenleyin

   Web sitenizin içeriğini ve tasarımını özelleştirmek için source dizininde Markdown dosyalarını ve Twig şablon dosyalarını düzenleyin.

2. Yeni Sayfa Ekleyin

   Yeni bir sayfa eklemek için source dizininde yeni Markdown dosyaları oluşturun. Örneğin, bir about.md dosyası oluşturun:

   ---
   title: "About Us"
   ---
   
   # About Us
   
   This is the about page.

3. Gezinme Menüsünü Yapılandırın

   Yeni gezinti bağlantıları eklemek için source/_layouts dizinindeki Twig şablon dosyalarını düzenleyin.

4. Siteyi Yeniden İnşa Edin

   Her içerik veya şablon değişikliğinden sonra, Sculpin sitesini yeniden inşa etmek için aşağıdaki komutu tekrar çalıştırın:

   vendor/bin/sculpin generate

Sculpin ile Web Sitesi Oluşturma

Artık ServBay ortamında Sculpin'i başarıyla kurup yapılandırdınız ve sitenizi oluşturmaya başlayabilirsiniz. İşte bazı yaygın işlemler:

Blog Yazısı Oluşturma

1. Yazı Oluşturun

   Yeni blog yazıları eklemek için source/_posts dizininde yeni Markdown dosyaları oluşturun. Örneğin, bir 2024-06-06-my-first-post.md dosyası oluşturun:

   ---
   title: "My First Post"
   date: 2024-06-06
   ---
   
   # My First Post
   
   This is the content of my first post.

2. Siteyi Yeniden İnşa Edin

   Sculpin sitesini inşa etmek için aşağıdaki komutu çalıştırın:

   vendor/bin/sculpin generate

Tarz ve Script Özelleştirme

1. Stilleri Düzenleyin

   Sitelerinizi özelleştirmek için source/assets/css dizininde CSS dosyalarını düzenleyin.

2. Scriptleri Düzenleyin

   Web sitenizin etkileşimli davranışını özelleştirmek için source/assets/js dizininde JavaScript dosyalarını düzenleyin.

3. Kaynakları Derleyin

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

   vendor/bin/sculpin generate

Yukarıdaki adımlarla, ServBay ortamında Sculpin'i başarıyla kurup yapılandırdınız ve sitenizi oluşturmaya başladınız. Sculpin'in esnekliği ve güçlü özellikleri, statik web siteleri oluşturmak için ideal bir seçimdir.