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

Kirby Nedir?

Kirby, farklı türde web siteleri oluşturmak için esnek ve güçlü bir dosya tabanlı içerik yönetim sistemidir (CMS). Kirby veritabanına bağımlı değildir, bunun yerine içerik için dosya sistemini kullanır, bu da onu çok hafif ve dağıtımı kolay hale getirir.

Kirby Kurulum Adımları

Bu makalede, ServBay ortamında Composer kullanarak Kirby 4.2'nin nasıl kurulacağını ve yapılandırılacağını göstereceğiz.

Adım 1: Proje Dizini Oluşturma

İlk olarak, ServBay'in www dizininde yeni bir proje dizini oluşturun:

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

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

ServBay zaten Composer ile birlikte gelir, bu yüzden doğrudan Composer'ı kullanarak Kirby projesi oluşturabiliriz:

composer create-project getkirby/starterkit .

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

1. Yeni Site Ekleme

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

   • Adı: My Kirby Site
   • Alan Adı: servbay-kirby.local
   • Site Türü: PHP
   • PHP Versiyonu: 8.2
   • Web Sitesi Kök Dizini: /Applications/ServBay/www/servbay-kirby-app

2. Yapılandırmayı Kaydetme

   Yapılandırmayı kaydedin.

Adım 4: Kirby Yapılandırılması

1. İçerik Dizini Oluşturma

   Proje kök dizininde content dizini zaten Kirby Starterkit tarafından oluşturulmuştur.

Adım 5: Kirby Çalıştırma

1. Kirby'ye Erişim

   Tarayıcınızı açın ve https://servbay-kirby.local adresine gidin, Kirby'nin varsayılan karşılama sayfasını göreceksiniz.

Adım 6: Kirby Paneli Kurulumu (İsteğe Bağlı)

Eğer Kirby'nin yönetim panelini kullanmak isterseniz, aşağıdaki adımları takip edebilirsiniz:

1. Kirby Paneline Erişim

   Tarayıcınızı açın ve https://servbay-kirby.local/panel adresine gidin, Kirby panelinin kurulum sayfasını göreceksiniz.

2. Yönetici Hesabı Oluşturma

   Sayfadaki talimatları takip ederek bir yönetici hesabı oluşturun, kullanıcı adı, şifre ve e-posta adresinizi girin ve "Hesap Oluştur" butonuna tıklayın.

Kirby Kullanarak Web Sitesi Oluşturma

Artık ServBay ortamında Kirby'yi başarıyla kurduğunuza ve yapılandırdığınıza göre, Kirby'yi kullanarak web sitenizi oluşturmaya başlayabilirsiniz. İşte bazı yaygın işlemler:

Sayfa ve İçerik Oluşturma

1. Sayfa Oluşturma

   content dizininde yeni sayfa dizinleri oluşturun. Örneğin, bir about sayfası oluşturun:

   mkdir content/about
   echo "Title: About Us\n----\nThis is the about page." > content/about/about.txt

2. Şablonları Düzenleme

   site/templates dizininde şablon dosyaları oluşturun veya düzenleyin. Örneğin, bir about.php şablonu oluşturun:

   <!-- site/templates/about.php -->
   <h1><?= $page->title() ?></h1>
   <p><?= $page->text() ?></p>

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

1. Şablonu Düzenleme

   site/templates dizininde ana şablon dosyanızı düzenleyin, örneğin default.php, ve navigasyon menüsü ekleyin:

   <!-- site/templates/default.php -->
   <nav>
     <ul>
       <?php foreach ($site->children()->listed() as $item): ?>
         <li>
           <a href="<?= $item->url() ?>"><?= $item->title() ?></a>
         </li>
       <?php endforeach ?>
     </ul>
   </nav>

Stil ve Betikleri Özelleştirme

1. Stil Ekleme

   assets/css dizininde CSS dosyaları oluşturun ve şablon dosyalarında referans verin. Örneğin, style.css oluşturun:

   /* assets/css/style.css */
   body {
     font-family: Arial, sans-serif;
   }

   Şablon dosyasında CSS dosyasına referans verin:

   <!-- site/templates/default.php -->
   <link rel="stylesheet" href="<?= url('assets/css/style.css') ?>">

2. Betik Ekleme

   assets/js dizininde JavaScript dosyaları oluşturun ve şablon dosyalarında referans verin. Örneğin, script.js oluşturun:

   // assets/js/script.js
   document.addEventListener('DOMContentLoaded', function() {
     console.log('Hello, Kirby!');
   });

   Şablon dosyasında JavaScript dosyasına referans verin:

   <!-- site/templates/default.php -->
   <script src="<?= url('assets/js/script.js') ?>"></script>

Yukarıdaki adımlarla, Kirby'yi ServBay ortamında başarıyla kurup yapılandırdınız ve web sitenizi oluşturmaya başladınız. Kirby'nin esnekliği ve dosya tabanlı mimarisi, çeşitli türlerde web siteleri oluşturmak için ideal bir seçimdir.