Download from Git/hi

गिट एक वितरित संस्करण नियंत्रण प्रणाली है। इससे आप स्रोत कोड के नवीनतम संस्करण को सभी शाखाओं और टैग किए गए प्रकाशनों के विकल्प के साथ डाउनलोड कर सकते हैं।

अगर आप एक विकासक हैं और पैच प्रस्तुत करना चाहते हैं, आपको गिट से डाउनलोड करना चाहिए।

अगर आप विकसित नहीं करना चाहते हैं और बस मीडियाविकि एक्सटेंशनों को स्थापित ही करना चाहते हैं, इसके बजाय स्थिर tarball प्रकाशन ही डाउनलोड करें।

और जानकारी, खासकर योगदान देने के बारे में, के लिए गिट देखें। नीचे कुछ साधारण कार्यों की विधियाँ हैं।

पूर्व अपेक्षित गुण
गिट का इस्तेमाल करने से पहले आपको इसे स्थापित करना होगा। आपके ऑपरेटिंग सिस्टम के अनुसार गिट पाने के कई तरीके हैं। Gerrit/Tutorial#Set up Git का पालन करें, या फिर अपने पसंदीदा खोज इंजन का इस्तेमाल करें।

यह सुझाव की जाती है कि आप तृतीय-पक्ष लाइब्रेरियों को डाउनलोड करने और स्थापित करने के लिए स्थापित कर लें, लेकिन इसकी आवश्यकता नहीं है।



डाउनलोड करें
आप मीडियाविकि मूल को गिट की मदद से डाउनलोड कर सकते हैं, साथ ही वर्तमान में विकिमीडिया संस्थान के सर्वर क्लस्टर पर स्थापित सभी एक्सटेंशन और पर होस्ट किए गए कई अन्य एक्सटेंशन भी।

पहला कदम है मीडियाविकि मूल रिपॉज़िटरी को क्लोन करना। इसमें कुछ समय लग जाएगा।



विकास के लिए डाउनलोड करें
मीडियाविकि के आखिरी विकास संस्करण को 'master' शाखा में ट्रैक किया जाता है।

पहले सुनिश्चित करें कि आपने एक विकासक खाता बनाया है, ताकि आपको एक ssh सदस्यनाम मिल जाए।

उसके बाद अपने ssh से क्लोन करने के लिए टर्मिनल विंडो में यह कमांड डालें ताकि आप पुनरीक्षण के लिए पैच प्रस्तुत कर पाएँ:

यह पूरे मीडियाविकि रिपॉज़िटरी को master शाखा से सिंक करके  नामक सब-डिरेक्ट्री में क्लोन कर लेता है।

किसी दूसरे डिरेक्ट्री में स्थापित करने के लिए, उसे कमांड लाइन पर बदल दें (और जानकारी के लिए ये प्रलेख देखें)। जब रिपॉज़िटरी क्लोन हो जाती है, आप अलग-अलग शाखाओं और टैग्स को छाँट सकते हैं। विकास शाखा,, मीडियाविकि का विकास संस्करण है; आपको किसी भी हाल में उत्पादन के लिए master कोड का इस्तेमाल नहीं करना चाहिए क्योंकि इसे स्थिर नहीं माना जाता।





एक स्थिर शाखा डाउनलोड करें
अगर आप सॉफ़्टवेयर पैच को विकसित नहीं करना चाहते पर स्थिर प्रकाशन शाखा को गुमनाम होकर क्लोन करना चाहते हैं, इस कमांड का इस्तेमाल करें:

अगर आपके इंटरनेट कनेक्शन की गति धीमी है और आप क्लोन होने वाले संस्करणों संख्या को कम करना चाहते हैं,  कमांड पर   जोड़ें।



मीडियाविकि टैग्स (स्थिर संस्करण)
वैकल्पिक रूप से, मीडियाविकि के विशिष्ट स्थिर संस्करणों को 'टैग्स' की मदद से ट्रैक किया जाता है। ये tarball प्रकाशनों से अलग होते हैं। वर्तमान में, ये हैं (स्थिर),  (LTS) और  (विरासती LTS)।

आप इसकी मदद से उपलब्ध टैग्स देख सकते हैं:

विशिष्ट टैग्स, जैसे आखिरी स्थिर प्रकाशन, का उपयोग करने के लिए:



गिट सबमॉड्यूल्स को अपडेट करें
इन शाखाओं में  डिरेक्ट्री के प्रसिद्ध एक्सटेंशनों और स्किन्स के लिए कई गिट सबमॉड्यूल्स हैं। शाखा में ये नहीं हैं। सबमॉड्यूल्स को अपडेट करने के लिए चलाएँ:



बाहरी लाइब्रेरी प्राप्त करें
मीडियाविकि बाहरी PHP लाइब्रेरियों को प्रबंधित करने के लिए का इस्तेमाल करती है, जो सभी आपके मीडियाविकि डिरेक्ट्री के   डिरेक्ट्री में चले जाते हैं।

इन आवश्यक लाइब्रेरियों को स्थापित करने के लिए आपके पास एक विकल्प है:


 * composer PHAR को डाउनलोड करके स्थापित करें, वैकल्पिक रूप से अपने OS के विधि के अनुसार composer.phar का नाम बदलें, और फिर अपने मीडियाविकि डिरेक्ट्री से  चलाएँ। यही विकल्प सुझाया जाता है।
 * अगर डिफ़ॉल्ट PHP CLI संस्करण वेब सर्वर के PHP संस्करण से मेल नहीं खाता, इसे  की मदद से निर्दिष्ट करें।
 * अगर आप Composer का उपयोग नहीं करना चाहते हैं, या यदि आप WMF उत्पादन क्लस्टर पर इस्तेमाल होने वाले वेंडर लाइब्रेरियों के सेट का ही उपयोग करना चाहते हैं, तो आप इसके बजाय आप अपने मीडियाविकि स्थापना के कोर फोल्डर में एक  डिरेक्ट्री बना सकते हैं:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * ध्यान रखें कि अगर आपके किसी भी एक्सटेंशन की अपनी Composer की ज़रूरतें हैं, आप इस विकल्प का उपयोग नहीं कर सकते।

मीडियाविकि 1.25 से पहले, कुछ बाहरी लाइब्रेरियों को मूल रिपॉज़िटरी में रखा जाता था और किसी पैकेज प्रबंधक की कभी ज़रूरत ही नहीं पड़ी।



अद्यत रखें
अगर आप मीडियाविकि के किसी विशिष्ट शाखा के विकास संस्करण ("master" शाखा) का इस्तेमाल कर रहे हैं, नवीनतम बदलावों को पाना काफ़ी आसान है। अपने मीडियाविकि क्लोन डिरेक्ट्री पर जाएँ और इस कमांड का उपयोग करें:

आप जिस शाखा का उपयोग कर रहे हैं, उसके सभी नवीनतम बदलाव लागू कर दिए जाएँगे।

कोर के नए संस्करण में आपको एक्सटेंशन और स्किन्स के नए संस्करणों की ज़रूरत पड़ सकती है, तो आपको स्किन डिरेक्ट्री के हर एक्सटेंशन में जाकर  जैसे कमांड की मदद से उन्हें अपडेट करना होगा।

आपको आवश्यक लाइब्रेरियों के साथ आवश्यक लाइब्रेरियों के नवीनतम संस्करणों के साथ  को अपडेट करने की भी ज़रूरत पड़ सकती है। इसका मतलब अकसर यह भी होता है कि Composer कमांड को भी चलाना पड़ता है, पर और जानकारी के लिए ऊपर #बाहरी लाइब्रेरी प्राप्त करें देखें।

कोड और आवश्यक लाइब्रेरियों को अपडेट करने के बाद मीडियाविकि  कमांड-लाइन स्क्रिप्ट का इस्तेमाल करके डेटाबेस को अपडेट करें:

अगर आप का उपयोग करते हैं, इसमें एक ही कमांड है, , जो ये काम करता है।



दूसरे संस्करण में बदलना
हमारे हर संस्करण को शाखाओं और टैग्स की मदद से ट्रैक किया जाता है। दूसरे संस्करण में बदलने के लिए (उदाहरणस्वरूप  शाखा से किसी दूसरी शाखा पर), अपने मीडियाविकि क्लोन रिपॉज़िटरी में उस शाखा पर जाएँ जो आपको चाहिए।

या

इन बदलावों को अपने आप लागू कर दिया जाएगा और आप चलने के लिए तैयार होंगे।



मीडियाविकि एक्सटेंशन डाउनलोड करने के लिए गिट का उपयोग करना

 * गिट पर एक्सटेंशनों की सूची



एक एक्सटेंशन डाउनलोड करें

 * अगले कमांड्स में को उस एक्सटेंशन के नाम से बदलें जिसे आप डाउनलोड करना चाहते हैं।  के लिए यह TitleKey होगा। (यह केस संवेदनशील है!)

गिट से एक्सटेंशन को डाउनलोड करके क्लोन करें:

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

आप Gerrit के gitiles ऐप्लिकेशन में एक्सटेंशों के स्रोत कोड को देख सकते हैं, और इस URL पर भी:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master



सभी एक्सटेंशन डाउनलोड करें
अगर आपको वह हर एक्सटेंशन चाहिए जिन्हें gerrit.wikimedia.org ने आपके मशीन में डाले हैं, यह डालें:

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

किसी भी समय पर, सभी एक्सटेंशनों को डाउनलोड करने के लिए, यह डालें:

किसी दूसरे शाखा में बदलने के लिए, जैसे किसी नए प्रकाशन के बाद:

याद रखें कि आपको बस उसी संस्करण के एक्सटेंशनों का इस्तेमाल करना चाहिए जिसमें मीडियाविकि है।

master शाखा को ट्रैक करने के लिए:

कृपया ध्यान रखें कि आपको किसी भी हाल में उत्पादन के लिए master कोड का इस्तेमाल नहीं करना चाहिए क्योंकि इसे स्थिर नहीं माना जाता।

अगर आपको एक केवल-पठनीय चेकआउट चाहिए (अगर आप सिर्फ कोड को देखना चाहते हैं), आप Labs पर शेयर किए गए मीडियाविकि चेकआउट को देख सकते हैं और आपको अपने मशीन पर कुछ भी डाउनलोड करने की ज़रूरत नहीं होगी।



एक एक्सटेंशन हटाएँ

 * 1)   से " " या " " हटाएँ
 * 2) कोई भी ऐसी पंक्ति को हटाएँ जो   पर एक्सटेंशन का सन्दर्भ है (ज़्यादातर "extra → merge-plugin → include" अनुभाग में)
 * 3)   से एक्सटेंशन की डिरेक्ट्री को हटाएँ



मीडियाविकि स्किन डाउनलोड करने के लिए गिट का उपयोग करना

 * गिट पर स्किन्स की सूची

मीडियाविकि 1.24 और उसके बाद से गिट पर स्किन्स नहीं हैं।

एक्सटेंशन की ही विधि का पालन करें (जैसा पिछले अनुभाग में बताया गया है), पर हर URL और पाथ पर  की जगह   का इस्तेमाल करते हुए।

स्थापना की विस्तृत विधि यहाँ MediaWiki.org पर हर स्किन के पृष्ठ पर मौजूद है, उदाहरण के लिए स्किन:वेक्टर#स्थापना देखें। हर स्किन के स्थापना की विधि उसी पर आधारित है।



ये भी देखें

 * Intranet/Intranet Installation, जो मीडियाविकि के उपयोग के लिए गिट का इस्तेमाल करने वाले पृष्ठों का एक समूह है।

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki