Laravel Maestro योगदानकर्ता ट्यूटोरियल
Laravel Starter Kits बनाने के लिए Maestro का उपयोग करता है। इन किट्स में योगदान देने के लिए दस्तावेज़ (documentation) बहुत कम उपलब्ध हैं।
यदि आप किसी Starter Kit में नई सुविधाएँ जोड़ना चाहते हैं या बग्स (bugs) ठीक करना चाहते हैं, तो आपको वर्कफ़्लो को समझना होगा। यह गाइड बताती है कि Maestro का सही ढंग से उपयोग कैसे करें।
डायरेक्टरी संरचना (The Directory Structure)
रिपॉजिटरी के तीन मुख्य भाग हैं:
kits/: इसमें वास्तविक Starter Kit फ़ाइलें होती हैं। यही एकमात्र डायरेक्टरी है जिसे आप commit करते हैं।orchestrator/: यह बिल्ड प्रक्रिया को प्रबंधित करता है और किट्स को चलाता है।build/: यह एक अस्थायी वर्कस्पेस है। जब आप बिल्ड चलाते हैं, तो Maestro इसे बनाता है।
डेवलपमेंट वर्कफ़्लो (The Development Workflow)
kits/ डायरेक्टरी में सीधे काम न करें, जब तक कि आप एक साथ कई फ़ाइलों को अपडेट न कर रहे हों। इसके बजाय, इन चरणों का पालन करें:
एनवायरनमेंट सेटअप करें
orchestrator/फ़ोल्डर पर जाएँ।composer installऔरnpm installचलाएँ।अपने टारगेट किट को बिल्ड करें
php artisan buildचलाएँ। अपना फ्रेमवर्क, वेरिएंट और फीचर्स चुनें। इससेbuild/फ़ोल्डर बन जाएगा।किट चलाएँ
orchestrator/फ़ोल्डर सेcomposer kit:runका उपयोग करें। यह पोर्ट 8000 पर एप्लिकेशन शुरू कर देता है।अपने बदलाव करें
build/डायरेक्टरी खोलें। जिन फ़ाइलों को बदलने की आवश्यकता है उन्हें ढूँढें और उन्हें एडिट करें।वॉचर (watcher) को अपना काम करने दें Maestro एक वॉचर का उपयोग करता है। जब आप
build/में कोई फ़ाइल सेव करते हैं, तो यह स्वचालित रूप सेkits/डायरेक्टरी में सही फ़ाइल को अपडेट कर देता है।अपने बदलावों का परीक्षण करें सबसे पहले
kit:runप्रक्रिया को रोकें। जब किट चल रही हो, तब आप टेस्ट नहीं चला सकते।orchestrator/फ़ोल्डर से, चलाएँ:
composer kits:pint(फॉर्मेटिंग के लिए)composer kits:check(PHP टेस्ट के लिए)composer kits:lint(JavaScript टेस्ट के लिए)
- अपना काम कमिट करें
अपना
git statusचेक करें। आपकोkits/फ़ोल्डर में बदलाव दिखने चाहिए। अपने कमिट में केवलkits/डायरेक्टरी को ही जोड़ें।
उदाहरण: टेक्स्ट को "Log in" से बदलकर "Log on" करना
build/के अंदर blade या component फ़ाइल को एडिट करें।- वॉचर द्वारा
kits/को अपडेट करने का इंतज़ार करें। - टेस्ट चलाएँ ताकि यह सुनिश्चित हो सके कि आपने अन्य वेरिएंट्स को खराब नहीं किया है।
kits/में फ़ाइलों को कमिट करें।
यह प्रक्रिया सुनिश्चित करती है कि आपका योगदान स्वच्छ रहे और Maestro आर्किटेक्चर का पालन करे।
स्रोत: https://dev.to/catatsumuri/laravel-maestro-contributor-tutorial-2p89