ServBay पर्यावरण में Kirby CMS को इंस्टॉल और कॉन्फ़िगर करें

Kirby एक लचीला और शक्तिशाली फाइल-ड्रिवन कंटेंट मैनेजमेंट सिस्टम (CMS) है, जिसे किसी भी प्रकार की वेबसाइट बनाने के लिए इस्तेमाल किया जा सकता है। पारंपरिक डाटाबेस-आधारित CMS के विपरीत, Kirby अपनी सामग्री फाइल सिस्टम में संग्रहित करता है, जिससे यह बेहद हल्का, संस्करण नियंत्रण के लिए आसान और सरल डिप्लॉयमेंट के लिए उपयुक्त है।

यह गाइड आपको बताएगा कि डेवलपर्स के लिए तैयार किए गए स्थानीय वेब डेवलपमेंट प्लेटफॉर्म ServBay पर, Composer की मदद से Kirby 4.2 Starterkit कैसे इंस्टॉल और कॉन्फ़िगर करें। ServBay पहले से ही PHP, वेब सर्वर (जैसे Caddy या Nginx), और Composer के साथ आता है—जिससे यह लोकल Kirby डेवेलपमेंट के लिए आदर्श बनता है।

पूर्व आवश्यकताएँ

शुरू करने से पहले सुनिश्चित करें कि आपने निम्नलिखित कर लिया है:

1. आपने ServBay को macOS पर इंस्टॉल और चालू कर लिया है।
2. ServBay में आवश्यक PHP वर्शन (इस उदाहरण में PHP 8.2) सक्रिय है।
3. ServBay के साथ Composer पहले से ही आता है, अलगा इंस्टॉलेशन जरूरी नहीं।

Kirby इंस्टॉल करने के चरण

नीचे ServBay पर्यावरण में Kirby इंस्टॉल और कॉन्फ़िगर करने के विस्तृत चरण दिए हैं:

चरण 1: प्रोजेक्ट डायरेक्ट्री बनाएँ

सबसे पहले, टर्मिनल एप्लिकेशन खोलें। ServBay के डिफ़ॉल्ट वेबसाइट रूट डायरेक्ट्री /Applications/ServBay/www में जाएँ और एक नया प्रोजेक्ट फ़ोल्डर बनाएं। यहाँ हम उदाहरण के लिए servbay-kirby-app नाम प्रयोग कर रहे हैं।

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

चरण 2: Composer से Kirby प्रोजेक्ट तैयार करें

ServBay में Composer इंटीग्रेटेड है, तो आप सीधे टर्मिनल में इसका उपयोग कर सकते हैं। प्रोजेक्ट डायरेक्ट्री servbay-kirby-app में, निम्नलिखित Composer कमांड चलाएँ ताकि Kirby Starterkit डाउनलोड एवं स्थापित हो सके:

composer create-project getkirby/starterkit .

यह कमांड Kirby के मुख्य फाइल, डिपेंडेंसी एवं एक बेसिक कंटेंट और टेम्पलेट्स वाला Starterkit आपके वर्तमान डायरेक्ट्री (.) में डाउनलोड कर देगा।

चरण 3: वेब सर्वर कॉन्फ़िगर करें (ServBay में वेबसाइट जोड़ना)

ताकि ServBay का वेब सर्वर (जैसे Caddy या Nginx) आपके Kirby प्रोजेक्ट को सर्व कर सके, आपको ServBay एप में एक नई वेबसाइट कॉन्फ़िगरेशन जोड़नी होगी।

1. ServBay खोलें: ServBay एप्लिकेशन ओपन करें।
2. वेबसाइट मैनेजमेंट पर जाएँ: ServBay विंडो के बाएँ साइडबार में "वेबसाइट" टैब पर क्लिक करें।
3. नई वेबसाइट जोड़ें: सबसे नीचे "+", या वेबसाइट जोड़ने का कोई विकल्प चुनें।
4. वेबसाइट जानकारी भरें: खुली हुई विंडो में यह जानकारियाँ भरें:
   • नाम: वेबसाइट का कोई सरल और पहचाने जाने वाला नाम, जैसे My Kirby Site।
   • डोमेन: लोकल डेवेलपमेंट डोमेन सेट करें। .local या .servbay.demo जैसे एक्सटेंशन, उदाहरणस्वरूप servbay-kirby.local। ServBay लोकल DNS ऑटोमैटिकली सेट कर देगा।
   • वेबसाइट टाइप: PHP चुनें, क्योंकि Kirby एक PHP ऐप है।
   • PHP वर्शन: वाँछित PHP वर्शन चुनें, जैसे 8.2। सुनिश्चित करें कि यह वर्शन Kirby की न्यूनतम आवश्यकताओं को पूरा करता है।
   • वेबसाइट रूट डायरेक्ट्री: अपने Kirby प्रोजेक्ट का index.php जहाँ स्थित है—आमतौर पर यही प्रोजेक्ट की रूट डायरेक्ट्री होगी। यहाँ चरण 1 में बनाया गया फोल्डर चुनें: /Applications/ServBay/www/servbay-kirby-app।
5. सेव करें: सभी जानकारी सही होने पर सेव पर क्लिक करें। ServBay नया कॉन्फ़िगरेशन लागू कर देगा और ज़रूरत पड़ने पर वेब सर्वर को रीस्टार्ट कर सकता है।

चरण 4: Kirby की प्रीलिमिनरी कॉन्फ़िगरेशन

Kirby की मुख्य सेटिंग्स site/config/config.php फाइल के ज़रिए की जाती है। Starterkit के लिए बेसिक सेटअप पहले से तैयार है, आप चाहें तो इसमें अपनी कस्टम सेटिंग्स जोड़ सकते हैं, जैसे:

• debug मोड सेट करें (c::set('debug', true);)
• पैनल भाषा को सेट करें
• कस्टम रूट्स इत्यादि

प्रोजेक्ट की रूट में स्थित content फोल्डर Kirby Starterkit द्वारा ऑटोमैटिकली बना दिया जाता है, जिसमें सभी पेजेज़ की सामग्री रखी जाती है।

चरण 5: Kirby वेबसाइट रन और एक्सेस करें

जब ServBay की कॉन्फ़िगरेशन पूरी हो जाए, आपके Kirby वेबसाइट को आपने जिस डोमेन पर सेट किया है, वहाँ से ऐक्सेस किया जा सकता है।

1. ServBay चालू रखें: यह जांच लें कि ServBay चल रहा है, और संबंधित वेब सर्वर (Caddy/Nginx) और PHP सर्विसेज एक्टिव हैं।
2. वेबसाइट विजिट करें: ब्राउज़र खोलें और एड्रेस बार में चरण 3 में सेट किया हुआ डोमेन डालें, उदाहरण के लिए: https://servbay-kirby.local

आपको Kirby Starterkit का डिफॉल्ट वेलकम पेज दिखाई देगा। ServBay में HTTPS डिफॉल्ट इनेबल्ड है, अतः https:// का इस्तेमाल करें।

चरण 6: Kirby पैनल इंस्टॉल और इस्तेमाल करें (वैकल्पिक)

Kirby एक पॉवरफुल एडमिन पैनल देता है जिससे आप वेबसाइट कंटेंट, यूज़र और सेटिंग्स बड़ी आसानी से मैनेज कर सकते हैं।

1. पैनल इंस्टाल पेज खोलें: ब्राउज़र में अपनी साइट के डोमेन के बाद /panel जोड़ें, उदाहरण: https://servbay-kirby.local/panel
2. एडमिन खाता बनाएं: पहली बार /panel पर पहुँचने पर आप इंस्टॉलेशन गाइड पर जाएंगे। निर्देशानुसार यूज़रनेम, पासवर्ड और ईमेल डालकर एडमिन अकाउंट बनाएं।
3. पैनल में लॉगिन करें: अकाउंट बन जाने के बाद पैनल में लॉगिन करें और ग्राफिकल इंटरफ़ेस से वेबसाइट कंटेंट मैनेज करें।

Kirby से वेबसाइट बनाएं

अब आपने ServBay पर Kirby CMS को सफलतापूर्वक इंस्टॉल और कॉन्फ़िगर कर लिया है। आइए जानते हैं कि फाइल-ड्रिवन प्रणाली का इस्तेमाल कर वेबसाइट कैसे बनती है और Kirby की प्रारंभिक अवधारणाएँ क्या हैं:

कंटेंट संरचना (Content)

Kirby अपनी सारी सामग्री content फोल्डर में स्टोर करता है। हर पेज का अपना अलग फ़ोल्डर होता है। अक्सर, पेज का कंटेंट उस फोल्डर के अंदर टेक्स्ट फाइल (जैसे page.txt) में Markdown-जैसे सिंटैक्स के साथ रहता है।

उदाहरण: "हमारे बारे में" पेज बनाएं

टर्मिनल में:

cd /Applications/ServBay/www/servbay-kirby-app
mkdir content/about
echo "Title: हमारे बारे में\n----\nयह हमारे बारे में पेज की सामग्री है।" > content/about/about.txt

अब https://servbay-kirby.local/about पर जाएँ (यदि टेम्पलेट्स में इसका सपोर्ट है)।

टेम्पलेट्स (Templates)

टेम्पलेट्स site/templates फोल्डर में रखी जाती हैं, और यह तय करती हैं कि हर पेज कैसे शो होगा। फाइल का नाम आमतौर पर कंटेंट फोल्डर या ब्लूप्रिंट के नाम से मेल खाता है (जैसे, about.php content/about या about ब्लूप्रिंट से जुड़े पेज के लिए)।

उदाहरण: about.php टेम्पलेट बनाएँ

site/templates/about.php फाइल में:

<?php snippet('header') ?>

<main>
  <h1><?= $page->title() ?></h1>
  <div class="text">
    <?= $page->text()->kt() // KirbyText के जरिए रेंडरिंग ?>
  </div>
</main>

<?php snippet('footer') ?>

यहाँ snippet() फ़ंक्शन का इस्तेमाल हेडर और फुटर जैसी दोहराई जाने वाली चीज़ों को इंक्लूड करने में किया गया है।

ब्लूप्रिंट्स (Blueprints)

ब्लूप्रिंट फाइल्स site/blueprints फोल्डर में रहती हैं और पैनल में पेजेज़ की संरचना, फ़ील्ड्स और विकल्प निर्धारित करती हैं। इन्हें YAML में लिखा जाता है।

उदाहरण: about.yml ब्लूप्रिंट बनाना

site/blueprints/pages/about.yml में:

title: About पेज

columns:
  - width: 2/3
    fields:
      text:
        label: टेक्स्ट कंटेंट
        type: textarea
        size: large
        buttons:
          - bold
          - italic
          - link
          - email

  - width: 1/3
    fields:
      # साइडबार फिल्ड्स, जैसे इमेज अपलोड आदि
      cover_image:
        label: कवर इमेज
        type: files
        max: 1
        uploads:
          template: image

ब्लूप्रिंट डिफाइन करने के बाद, जब आप पैनल में नया "About" पेज बनाएंगे, तो यह फ़ील्ड्स दिखेंगे।

स्निपेट्स (Snippets)

Snippets वह दोहराई जाने वाली PHP फाइलें हैं—जैसे हेडर, फुटर, नेविगेशन आदि—जो site/snippets फोल्डर में सेव होती हैं।

कंट्रोलर्स (Controllers) और मॉडल्स (Models)

अगर आपको एडवांस लॉजिक चाहिए, तो कंट्रोलर्स (site/controllers) में पेज डेटा प्रोसेस करें और मॉडल्स (site/models) में कस्टम पेज क्लासेस डिफाइन करें।

स्टैटिक संसाधन (Assets)

CSS, JavaScript, इमेज जैसे स्टैटिक फाइल्स आमतौर पर प्रोजेक्ट रूट के assets फोल्डर में रहेंगी। टेम्पलेट्स में url('assets/...') हेल्पर से इनका URL लें।

उदाहरण: CSS व JS जोड़ना

site/templates/default.php या site/snippets/header.php में:

<link rel="stylesheet" href="<?= url('assets/css/style.css') ?>">
<script src="<?= url('assets/js/script.js') ?>"></script>

सारांश

इन स्टेप्स के बाद, आपने सफलतापूर्वक ServBay लोकल डीवलपमेंट पर्यावरण में Kirby CMS को इंस्टॉल और कॉन्फ़िगर कर लिया है। ServBay की इंटीग्रेटेड सेटिंग्स PHP एप्लिकेशन की तैनाती और प्रबंधन काफी आसान बना देती हैं, जिससे आप Kirby की ताकत और फाइल-ड्रिवन लचीलापन इस्तेमाल कर वेबसाइट तैयार करने पर ध्यान केंद्रित कर सकते हैं। अब आप Kirby के टेम्पलेट्स, ब्लूप्रिंट्स, स्निपेट्स आदि के बारे में विस्तार से जान सकते हैं और और भी अधिक जटिल वेबसाइट और संरचनाएँ बना सकते हैं।