ServBay वातावरण में Sculpin को इंस्टॉल और कॉन्फ़िगर करना

परिचय

Sculpin एक शक्तिशाली और लचीला PHP-आधारित स्टैटिक वेबसाइट जनरेटर है, जो ब्लॉग, डोक्युमेंटेशन वेबसाइट या किसी भी परियोजना के लिए उपयुक्त है, जिसमें डायनेमिक सामग्री (जैसे Twig टेम्पलेट्स और Markdown फ़ाइलें) को उच्च-प्रदर्शन वाले स्टैटिक HTML पृष्ठों में बदलना होता है। यह Composer के जरिए डिपेंडेंसी मैनेजमेंट करता है और Symfony कंपोनेंट्स का उपयोग करता है, जिससे डेवेलपर्स को एक जाना-पहचाना और भरोसेमंद अनुभव मिलता है।

ServBay macOS के लिए विशेष रूप से डिज़ाइन किया गया एक लोकल वेब डेवलपमेंट एनवायरनमेंट है, जिसमें PHP, Composer, डेटाबेस (MySQL, PostgreSQL, MongoDB, Redis), वेब सर्वर (Caddy, Nginx) आदि जैसे कई प्रचलित सॉफ़्टवेयर पहले से ही शामिल हैं। यह एक आसान GUI प्रबंधन भी प्रस्तुत करता है। ServBay के साथ, macOS पर Sculpin डेवेलपमेंट एनवायरनमेंट सेटअप करना बहुत आसान हो जाता है, खासकर PHP वर्शन, डिपेंडेंसी मैनेजमेंट और वेब सर्वर कॉन्फ़िगरेशन की जटिलताओं को संभालते हुए।

यह गाइड ServBay वातावरण में Sculpin को इंस्टॉल और कॉन्फ़िगर करने और एक लोकल डेवेलपमेंट वेबसाइट सेटअप करने की पूरी प्रक्रिया बताएगा।

उपयोग के परिदृश्य

• PHP टेक्नोलॉजी स्टैक का उपयोग कर उच्च-प्रदर्शन स्टैटिक ब्लॉग बनाना।
• ओपन-सोर्स प्रोजेक्ट या प्रोडक्ट के लिए स्टैटिक डोक्युमेंटेशन वेबसाइट जनरेट करना।
• तेज़ी से कोई स्टैटिक मार्केटिंग पेज या कंपनी वेबसाइट बनाना, जिसमें बैक-एंड डेटाबेस की ज़रूरत नहीं है।
• Twig टेम्पलेट इंजन और Markdown का उपयोग करते हुए सामग्री लिखना और स्टैटिक वेबसाइट की स्पीड तथा सुरक्षा का लाभ लेना।

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

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

1. macOS पर ServBay इंस्टॉल और संचालन में है। ServBay PHP पर्यावरण, Composer पैकेज मैनेजर, और वेब सर्वर (Caddy या Nginx) प्रदान करता है।
2. बुनियादी कमांड लाइन कौशल।
3. PHP, Composer और Markdown की प्राथमिक जानकारी।

Sculpin इंस्टॉलेशन की चरणबद्ध प्रक्रिया

ServBay वातावरण में Sculpin को इंस्टॉल और कॉन्फ़िगर करने के लिए निम्न चरणों का पालन करें:

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

सबसे पहले, ServBay की वेबसाइट रूट डायरेक्ट्री (/Applications/ServBay/www) में एक नया प्रोजेक्ट फोल्डर बनाएं। उदाहरण के लिए, हम नए प्रोजेक्ट का नाम servbay-sculpin-app रखेंगे।

टर्मिनल खोलें और निम्न कमांड चलाएँ:

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

यह डायरेक्ट्री आपके Sculpin प्रोजेक्ट की सभी फाइलें रखने के लिए होगी।

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

ServBay के साथ Composer पहले से इंस्टॉल है, इसलिए अलग से इंस्टॉल करने की ज़रूरत नहीं। आप composer कमांड सीधे इस्तेमाल कर सकते हैं।

Sculpin का अधिकारिक ब्लॉग स्केलेटन प्रोजेक्ट इस्तेमाल करेंगे ताकि आप तेज़ी से शुरू कर सकें। जिस डायरेक्ट्री में आप हैं (servbay-sculpin-app), वहाँ यह कमांड चलाएँ:

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

यह कमांड Composer के माध्यम से Sculpin ब्लॉग स्केलेटन और सभी डिपेंडेंसी डाउनलोड करके इसी डायरेक्ट्री (.) में इंस्टॉल कर देगी।

चरण 3: ServBay वेबसाइट कॉन्फ़िगर करें

ServBay के वेब सर्वर (Caddy या Nginx) से अपनी Sculpin वेबसाइट तक पहुँचने के लिए, ServBay में एक नया वेबसाइट कॉन्फ़िगरेशन जोड़ें।

1. ServBay एप्लिकेशन खोलें: GUI इंटरफ़ेस शुरू करें।
2. "वेबसाइट" टैब पर जाएँ: सर्वबाय विंडो में नेविगेशन बार से "वेबसाइट" टैब चुनें।
3. नई वेबसाइट जोड़ें: नीचे बाएं कोने पर "+" बटन दबाएँ।
4. वेबसाइट जानकारी भरें:
   • नाम (Name): कोई भी पहचानने योग्य नाम डालें, जैसे My Sculpin Site।
   • डोमेन (Domain): जिस लोकल डोमेन से वेबसाइट खोलनी है, जैसे servbay-sculpin.local। ServBay .local डोमेन को ऑटोमेटिकली प्वाइंट और SSL सर्टिफिकेट (ServBay User CA के जरिये) कॉन्फ़िगर कर देता है।
   • प्रकार (Type): PHP चुनें, क्योंकि Sculpin एक PHP एप्लिकेशन है।
   • PHP संस्करण (PHP Version): इच्छित PHP संस्करण चुनें (Sculpin के संगत हो, सामान्यतः कोई भी नवीनतम संस्करण)।
   • डॉक्युमेंट रूट (Document Root): यह महत्वपूर्ण स्टेप है। Sculpin की जेनरेट की हुई स्टैटिक फाइलें आमतौर पर प्रोजेक्ट फोल्डर के output_dev या output_prod फोल्डर में होती हैं। लोकल डेवेलपमेंट के लिए रूट को डेवेलपमेंट आउटपुट डायरेक्ट्री पर सेट करें: /Applications/ServBay/www/servbay-sculpin-app/output_dev
5. सेव करें: पूरी जानकारी भरने के बाद, "सेव" बटन दबाएँ। ServBay नए कॉन्फ़िगरेशन को लागू कर देगा, आमतौर पर मैनुअल रिस्टार्ट की आवश्यकता नहीं होती।

चरण 4: Sculpin वेबसाइट बनाएं

ServBay में वेबसाइट कॉन्फ़िगर हो जाने के बाद, अब Sculpin का इस्तेमाल करके स्टैटिक फाइलें जेनरेट करना है।

टर्मिनल में प्रोजेक्ट की रूट डायरेक्ट्री /Applications/ServBay/www/servbay-sculpin-app पर जाएँ और यह कमांड चलाएँ (यदि चरण 2 पहले ही किया है, तो दुबारा चलाना आवश्यक नहीं, लेकिन यह सभी डिपेंडेंसी अप-टू-डेट करेगा):

composer install

अब Sculpin की जेनरेट कमांड चलाएँ और वेबसाइट बिल्ड करें:

vendor/bin/sculpin generate --watch

• vendor/bin/sculpin: Composer के द्वारा इंस्टॉल किया गया Sculpin executable।
• generate: Sculpin का स्टैटिक वेबसाइट बनाने का कमांड। यह source डायरेक्ट्री के कंटेंट और टेम्पलेट पढ़कर स्टैटिक फाइलें जेनरेट करके आउटपुट डायरेक्ट्री (डिफ़ॉल्ट output_dev) में डालता है।
• --watch: यह ऑप्शन Sculpin को source डायरेक्ट्री में फाइल बदलते ही वेबसाइट ऑटोमैटिकली री-जेनरेट करने को कहता है—डेवेलपमेंट के लिए बहुत सुविधाजनक।

जब यह कमांड "Sculpin has generated your site!" या ऐसा कोई मैसेज दिखाए, तब आपकी स्टैटिक फाइलें output_dev में तैयार हैं।

चरण 5: अपनी लोकल वेबसाइट खोलें

अब आप ServBay के माध्यम से बनाए गए डोमेन से अपनी Sculpin साइट देख सकते हैं।

वेब ब्राउज़र खोलें और चरण 3 में सेट किए गए डोमेन खोलें:

https://servbay-sculpin.local

चूंकि ServBay वेबसाइट का रूट output_dev पर सेट है और आप sculpin generate --watch कमांड चला रहे हैं, इसलिए आप https://servbay-sculpin.local पर अपनी वेबसाइट में हुए बदलावों का रियल टाइम पूर्वावलोकन कर सकते हैं। ServBay का ऑटो SSL सर्टिफिकेट आपको HTTPS के जरिए सुरक्षित लोकल डेवेलपमेंट देता है।

Sculpin के साथ विकास (डेवलपमेंट) करें

अब जब आपने Sculpin को अपने ServBay वातावरण में स्थापित व सेटअप कर लिया है, आप अपनी स्टैटिक साइट बना सकते हैं। नीचे कुछ सामान्य डेवेलपमेंट टास्क दिए जा रहे हैं:

Sculpin प्रोजेक्ट संरचना का परिचय

Sculpin की मुख्य डायरेक्ट्री संरचना समझकर डेवलपमेंट आसान हो जाता है:

servbay-sculpin-app/
├── app/                # ऐप की सेटिंग्स और कैश
├── output_dev/         # डेवेलपमेंट में जेनरेट की गई स्टैटिक फाइलें (ServBay रूट यहीं से)
├── output_prod/        # प्रोडक्शन में जेनरेट की गई स्टैटिक फाइलें
├── source/             # वेबसाइट का स्रोत (Markdown कंटेंट, Twig टेम्पलेट और स्टैटिक एसेट्स)
│   ├── _layouts/       # Twig लेआउट फाइलें
│   ├── _posts/         # ब्लॉग आर्टिकल्स के Markdown फाइल
│   ├── assets/         # स्टैटिक एसेट्स (CSS, JS, Images आदि)
│   └── index.md        # होमपेज का Markdown
├── vendor/             # Composer से इंस्टॉल की गई डिपेंडेंसीज
├── sculpin.yml         # Sculpin मुख्य कॉन्फ़िगरेशन फाइल
├── composer.json       # Composer डिपेंडेंसी कॉन्फ़िगरेशन
└── ...अन्य फाइलें

आपका अधिकांश कार्य source डायरेक्ट्री में होगा।

ब्लॉग पोस्ट बनाएँ

Sculpin ब्लॉग में नई पोस्ट बनाने के लिए बस source/_posts डायरेक्ट्री में नया Markdown फाइल बनाएं। फाइल का नाम आमतौर पर YYYY-MM-DD-slug.md जैसा रखें।

उदाहरण: एक नई पोस्ट 2024-06-06-my-first-post.md बनाएं:

---
title: "मेरी पहली पोस्ट"
date: 2024-06-06
tags: [ट्यूटोरियल, Sculpin, ServBay]
---

# मेरी पहली पोस्ट

यह मेरी पहली Sculpin ब्लॉग पोस्ट की सामग्री है। मैं यहाँ ServBay और Sculpin के अपने अनुभव साझा कर रहा हूँ।

Markdown सिंटैक्स का उपयोग करके यहाँ सामग्री लिख सकते हैं।

## उप-शीर्षक

सूची:
- आइटम 1
- आइटम 2

फाइल सेव करते ही, चूंकि आप sculpin generate --watch चला रहे हैं, Sculpin फाइल में बदलाव देखेगा और साइट री-जेनरेट कर देगा। फिर https://servbay-sculpin.local खोलकर नई पोस्ट देख सकते हैं।

नया पृष्ठ जोड़ें

एक स्वतंत्र पेज (जैसे "About Us") जोड़ने के लिए, source डायरेक्ट्री में कोई Markdown फाइल सीधे बनाएं, जैसे about.md:

---
title: "हमारे बारे में"
layout: page.html.twig # उपयोग किए जा रहे लेआउट की जानकारी
---

# ServBay Sculpin गाइड के बारे में

यह ServBay और Sculpin के साथ स्टैटिक वेबसाइट बनाने पर आधारित गाइड है।

फाइल सेव करने पर, Sculpin output_dev/about/index.html जेनरेट करेगा (अगर "प्रीटी" URLs सेट किए हैं)। इसके बाद https://servbay-sculpin.local/about/ पर पेज खोलें।

अपनी स्टाइल और स्क्रिप्ट कस्टमाइज़ करें

CSS और JavaScript जैसी स्टैटिक फाइलें आमतौर पर source/assets फोल्डर में रखी जाती हैं। आप इन्हें डायरेक्ट एडिट कर सकते हैं।

उदाहरण के लिए, वेबसाइट की स्टाइल बदलने के लिए source/assets/css/style.css एडिट करें।

ये संसाधन वेबसाइट जेनरेट करते समय आउटपुट डायरेक्ट्री में कॉपी हो जाते हैं। इनमें बदलाव करेंगे तो Sculpin का --watch फीचर फिर से साइट बनाई देगा।

प्रोडक्शन के लिए वेबसाइट बनाना

जब आपकी साइट तैयार हो जाए, तो डिलीवरी या लाइव करने के लिए प्रोडक्शन बिल्ड ज़रूरी है। प्रोडक्शन बिल्ड आम तौर पर रीसोर्स कंप्रेस जैसे ऑप्टिमाइजेशन भी करता है।

प्रोडक्शन मोड में बिल्ड करने के लिए यह कमांड चलाएँ:

vendor/bin/sculpin generate --env=prod

यह सभी फाइलें output_prod फोल्डर में जेनरेट करेगा। अब उन फाइलों को किसी भी स्टैटिक होस्टिंग (जैसे GitHub Pages, Netlify, Vercel, या अपनी वेब सर्वर) पर अपलोड कर सकते हैं।

अगर प्रोडक्शन आउटपुट लोकल देखना है, तो ServBay वेबसाइट कॉन्फ़िगरेशन में "Document Root" बदलकर /Applications/ServBay/www/servbay-sculpin-app/output_prod कर दें, फिर डोमेन खोलें।

ध्यान देने योग्य बातें

• ServBay संचालन में है और आपकी वेबसाइट कॉन्फ़िगरेशन इनेबल्ड है, यह सुनिश्चित करें।
• डेवेलपमेंट के दौरान sculpin generate --watch टर्मिनल में चलता रहे, ताकि वेबसाइट ऑटो अपडेट हो।
• ServBay वेबसाइट कॉन्फ़िगरेशन में Document Root ठीक से Sculpin के आउटपुट डायरेक्ट्री (आम तौर पर output_dev) पर सेट है।
• ServBay .local डोमेन के लिए SSL सर्टिफिकेट ऑटोमैटिक सेट करता है, लेकिन ऑपरेटिंग सिस्टम में ServBay User CA ट्रस्ट होना चाहिए। डिटेल्स के लिए ServBay डाक्यूमेंटेशन देखें।

सामान्य प्रश्न (FAQ)

प्र: मैंने फाइल बदली, वेबसाइट अपडेट नहीं हुई?

उ: जांचें कि आप प्रोजेक्ट डायरेक्ट्री में vendor/bin/sculpin generate --watch कमांड चला रहे हैं और इसमें कोई त्रुटि नहीं आई। टर्मिनल आउटपुट में कोई एरर दिखे तो देखें। वर्चुअल ब्राउज़र कैश क्लियर करें या प्राइवेट मोड में खोलें।

प्र: https://servbay-sculpin.local खोलने पर SSL एरर आता है?

उ: ServBay .local डोमेन के लिए सेल्फ-साइंड सर्टिफिकेट जारी करता है। इसके लिए ऑपरेटिंग सिस्टम में ServBay User CA को ट्रस्ट करना ज़रूरी है। कृपया ServBay डॉक्युमेंटेशन के अनुसार CA प्रमाणपत्र ट्रस्ट करें।

प्र: PHP वर्शन कैसे बदलें?

उ: ServBay एप्लिकेशन के "सॉफ्टवेयर पैकेज" टैब में विभिन्न PHP वर्शन इंस्टॉल/मैनेज कर सकते हैं। फिर "वेबसाइट" टैब में अपनी Sculpin वेबसाइट का वर्शन बदलकर सेव करें।

प्र: Sculpin किन टेम्पलेट इंजन और मार्कअप लैंग्वेज का सपोर्ट करता है?

उ: Sculpin डिफ़ॉल्ट रूप से Twig टेम्पलेट इंजन और Markdown सामग्री लेखन के लिए सपोर्ट करता है।

निष्कर्ष

ServBay के एकीकृत वातावरण की मदद से, macOS पर Sculpin स्टैटिक वेबसाइट जनरेटर स्थापित और कॉन्फ़िगर करना अत्यंत सुगम हो जाता है। ServBay में पहले से PHP, Composer, आसान Web सर्वर सेटअप और ऑटोमैटिक SSL जैसी सुविधाएँ उपलब्ध हैं, जिससे Sculpin का लोकल डेवेलपमेंट सहज बनता है। इस गाइड को फॉलो कर आप तेज़ी से Sculpin डेवेलपमेंट एनवायरनमेंट सेटअप कर सकते हैं और अपनी स्टैटिक वेबसाइट प्रोजेक्ट को कुशलतापूर्वक बना व पूर्वावलोकन कर सकते हैं। Sculpin की शक्ति को ServBay की सरलता से मिलाकर, आप गुणवत्ता वाली कंटेंट निर्माण पर ध्यान केंद्रित रख सकते हैं, बिना जटिल लोकल डेवेलपमेंट सेटअप की चिंता के।