تثبيت وتهيئة Kirby في بيئة ServBay

ما هو Kirby؟

Kirby هو نظام إدارة محتوى (CMS) مرن وقوي يعتمد على الملفات، ومناسب لبناء أنواع مختلفة من المواقع. لا يعتمد Kirby على قاعدة بيانات، بل يستخدم نظام الملفات لتخزين المحتوى، مما يجعله خفيف الوزن وسهل النشر.

خطوات تثبيت Kirby

في هذه المقالة سنشرح كيفية تثبيت وتهيئة Kirby 4.2 باستخدام Composer في بيئة ServBay.

الخطوة 1: إنشاء دليل المشروع

أولاً، أنشئ دليلاً جديدًا للمشروع في دليل www الخاص بـ ServBay:

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

الخطوة 2: إنشاء مشروع Kirby باستخدام Composer

يحتوي ServBay بالفعل على Composer، لذلك يمكننا استخدامه مباشرة لإنشاء مشروع Kirby:

composer create-project getkirby/starterkit .

الخطوة 3: تهيئة خادم الويب

1. إضافة موقع جديد

   افتح ServBay، انقر على علامة التبويب "المضيفين"، وأضف موقعًا جديدًا:

   • الاسم: My Kirby Site
   • النطاق: servbay-kirby.local
   • نوع الموقع: PHP
   • نسخة PHP: 8.2
   • دليل الجذر للموقع: /Applications/ServBay/www/servbay-kirby-app

2. حفظ التهيئة

   احفظ التهيئة.

الخطوة 4: تهيئة Kirby

1. إنشاء دليل المحتوى

   في دليل المشروع الجذري، دليل content تم إنشاؤه بالفعل بواسطة Kirby Starterkit.

الخطوة 5: تشغيل Kirby

1. زيارة Kirby

   افتح المتصفح، وزيارة https://servbay-kirby.local، سترى صفحة الترحيب الافتراضية لـ Kirby.

الخطوة 6: تثبيت لوحة Kirby (اختياري)

إذا كنت ترغب في استخدام لوحة إدارة Kirby، يمكنك اتباع الخطوات التالية للتثبيت:

1. زيارة لوحة Kirby

   افتح المتصفح، وزيارة https://servbay-kirby.local/panel، سترى صفحة تثبيت لوحة Kirby.

2. إنشاء حساب مسؤول

   اتبع التعليمات على الصفحة لإنشاء حساب مسؤول، ادخل اسم المستخدم، وكلمة المرور، وعنوان البريد الإلكتروني، ثم انقر على "إنشاء حساب".

استخدام Kirby لبناء الموقع

الآن بعد أن قمت بتثبيت وتهيئة Kirby بنجاح في بيئة ServBay، يمكنك البدء في استخدامه لبناء موقعك. فيما يلي بعض العمليات الشائعة:

إنشاء الصفحات والمحتوى

1. إنشاء الصفحات

   في دليل content، أنشئ دلائل جديدة للصفحات. على سبيل المثال، أنشئ صفحة "about":

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

2. تحرير القوالب

   في دليل site/templates، أنشئ أو حرر ملفات القوالب. على سبيل المثال، أنشئ قالب about.php:

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

تهيئة قائمة التنقل

1. تحرير القوالب

   في دليل site/templates، حرر ملف القالب الرئيسي، مثل default.php، لإضافة قائمة التنقل:

   <!-- 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>

تخصيص الأنماط والبرمجيات

1. إضافة الأنماط

   في دليل assets/css، أنشئ ملف CSS وقم بربطه في ملف القالب. على سبيل المثال، أنشئ style.css:

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

   قم بربط ملف CSS في القالب:

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

2. إضافة البرمجيات

   في دليل assets/js، أنشئ ملف JavaScript وقم بربطه في ملف القالب. على سبيل المثال، أنشئ script.js:

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

   قم بربط ملف JavaScript في القالب:

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

باتباع هذه الخطوات، تكون قد نجحت في تثبيت وتهيئة Kirby في بيئة ServBay، وبدأت في استخدامه لبناء موقعك. يعتبر Kirby خيارًا مثاليًا لبناء أنواع مختلفة من المواقع بفضل مرونته وهندسته القائمة على الملفات.