लोगो बनाया गया 💖 द्वारा CandidDeer
क्या आप इस परियोजना के अनुरक्षक बनना चाहेंगे और इसे जारी रखने में मदद करना चाहेंगे? यदि आप रुचि रखते हैं, तो मेंटेनर गाइड पढ़ें और मुझे ट्विटर पर एक DM भेजें।
- घोषणा:
- परिचय
- ये किसके लिए है?
- मुझे ऐसा करने की आवश्यकता क्यों है?
- मैं इसमें क्या योगदान देने जा रहा हूँ?
- अनुवाद
- सेटअप
- अगले चरण
- स्वीकृतियाँ
- योगदान करें
- चरण 1 - इस भंडार को फोर्क करें
- चरण 2 - रिपॉजिटरी को क्लोन करें
- चरण 3 - एक नई शाखा बनाएं
- चरण 4 - index.html फ़ाइल खोलें
- चरण 5 - कार्ड टेम्पलेट कॉपी करें
- चरण 6 - अपने परिवर्तन लागू करें
- चरण 7 - अपने परिवर्तन करें
- चरण 8 - अपने परिवर्तनों को GitHub पर Push करें
- चरण 9 - पुल अनुरोध सबमिट करें
- चरण 10 - जश्न मनाएं
यह पहली बार योगदान देने वालों को एक सरल और आसान परियोजना में भाग लेने में मदद करने के लिए एक ट्यूटोरियल है।
- ओपन सोर्स प्रोजेक्ट में योगदान दें।
- GitHub का उपयोग करने में अधिक सहजता प्राप्त करें।
- यह बिल्कुल शुरुआती लोगों के लिए है। यदि आप एंकर टैग
<a href="" target=""></a>लिखना और संपादित करना जानते हैं तो आप इसे करने में सक्षम होंगे। - यह उन लोगों के लिए भी है जिनके पास थोड़ा अधिक अनुभव है लेकिन जो अपना पहला ओपन सोर्स योगदान देना चाहते हैं, या अधिक अनुभव और आत्मविश्वास के लिए अधिक योगदान प्राप्त करना चाहते हैं।
किसी भी वेब डेवलपर, आकांक्षी या अनुभवी को Git संस्करण नियंत्रण का उपयोग करने की आवश्यकता है, और GitHub सभी के द्वारा उपयोग की जाने वाली सबसे लोकप्रिय Git होस्टिंग सेवा है। यह ओपन सोर्स कम्युनिटी का दिल भी है। GitHub का उपयोग करके सहज होना एक आवश्यक कौशल है। किसी प्रोजेक्ट में योगदान देने से आपका आत्मविश्वास बढ़ता है और आपको अपने GitHub प्रोफ़ाइल पर दिखाने के लिए कुछ मिलता है।
यदि आप एक नए डेवलपर हैं और आप सोच रहे हैं कि क्या आपको गिट और गिटहब सीखने की आवश्यकता है तो इसका उत्तर यहां दिया गया है: आपको कल गिट सीखना चाहिए था।
आप इस प्रोजेक्ट के वेब पेज। इसमें आपका नाम, आपका ट्विटर हैंडल, एक संक्षिप्त विवरण और आपके द्वारा अनुशंसित वेब डेवलपर्स के लिए उपयोगी संसाधनों के 3 लिंक शामिल होंगे।
आप HTML फ़ाइल के अंदर कार्ड टेम्प्लेट की एक प्रति बनाएंगे और इसे अपनी जानकारी के साथ अद्यतन करेंगे।
यह ट्यूटोरियल अन्य भाषाओं में भी उपलब्ध है
| अरबी | बांग्ला | चीनी (पारंपरिक) | अंग्रेजी | फ़्रेंच |
|---|---|---|---|---|
| जर्मन | हिन्दी | इतालवी | जापानी | कोरियाई |
| पोलिश | पुर्तगाली | रूसी | सर्बियाई | स्पेनिश |
| तुर्की | यूक्रेनी |
प्रोजेक्ट दस्तावेज़ों के अनुवाद का स्वागत है। योगदान देने के लिए
अनुवाद गाइडपढ़ें।
नोट: यह ट्यूटोरियल GitHub PC पर आधारित है। यदि आप टर्मिनल के साथ सहज हैं तो इस ट्यूटोरियल पर जाएं (यहां क्लिक करें)
आइए पहले काम करने के लिए सेटअप करें
- अपने GitHub खाते में लॉग इन करें। यदि आपके पास अभी तक कोई खाता नहीं है तो GitHub से जुड़ें। मेरा सुझाव है कि आप जारी रखने से पहले GitHub हैलो वर्ल्ड ट्यूटोरियल करें।
- गिटहब डेस्कटॉप ऐप डाउनलोड करें।
- वैकल्पिक रूप से यदि आप कमांड लाइन पर गिट का उपयोग करने में सहज हैं तो आप ऐसा कर सकते हैं [यहां सीएलआई ट्यूटोरियल का लिंक दिया गया है] (/terminal-tutorial.md)।
- यदि आप वीएस कोड का उपयोग करते हैं, तो यह एकीकृत गिट के साथ आता है और आपको वह करने की अनुमति देता है जो हमें सीधे संपादक से चाहिए।
- हालांकि इस ट्यूटोरियल का पालन करने का सबसे सरल और आसान तरीका है GitHub Desktop का उपयोग करना।
अब जब आप पूरी तरह तैयार हो गए हैं तो आइए परियोजना में योगदान देने का काम शुरू करें।
10 आसान चरणों में ओपन सोर्स योगदानकर्ता बनें।
अनुमानित समय: 30 मिनट से कम.
- यहां उद्देश्य इस परियोजना की प्रतिलिपि बनाना और इसे अपने खाते में रखना है।
- एक रिपॉजिटरी (रेपो) यह है कि गिटहब पर एक प्रोजेक्ट कैसे कहा जाता है और एक कांटा इसकी एक प्रति है।
- सुनिश्चित करें कि आप मुख्य पृष्ठ पर हैं यह रेपो।
 |
|---|
| फोर्क बटन पर क्लिक करें |
- अब आपके पास अपने खाते में प्रोजेक्ट की पूरी प्रति है।
- अब हम परियोजना की एक स्थानीय प्रति बनाना चाहते हैं। यह आपकी अपनी मशीन पर सहेजी गई एक प्रति है।
- GitHub डेस्कटॉप ऐप खोलें। ऐप में:
 |
|---|
| फ़ाइल और फिर क्लोन रिपॉजिटरी पर क्लिक करें |
- आप GitHub पर अपने प्रोजेक्ट्स और फोर्क्स की एक सूची देखेंगे।
<your-github-username>/Contribute-To-This-Projectचुनें।- Clone पर क्लिक करें
 |
|---|
| ↪️ एक फोर्क्ड प्रोजेक्ट में बायीं ओर कांटा चिन्ह होगा। आपके फोर्क में आपका अपना GitHub उपयोगकर्ता होगा |  |
|---|
- इसमें कुछ समय लगेगा क्योंकि प्रोजेक्ट आपकी हार्ड डिस्क पर कॉपी हो जाएगा। मेरा सुझाव है कि आप डिफ़ॉल्ट पथ रखें जो आमतौर पर
..\Documents\GitHubहोता है। - अब आपके पास प्रोजेक्ट की एक स्थानीय प्रति है।
- रेपो का क्लोन बन जाने के बाद और आपने इसे GitHub डेस्कटॉप में खोल दिया है, यह एक नई शाखा बनाने का समय है।
- शाखा आपके परिवर्तनों को
masterनामक परियोजना के मुख्य भाग से अलग रखने का एक तरीका है। उदाहरण के लिए यदि चीजें गलत हो जाती हैं और आप अपने बदलावों से खुश नहीं हैं तो आप केवल शाखा को हटा सकते हैं और मुख्य परियोजना प्रभावित नहीं होगी।
↪️ वर्तमान शाखा पर क्लिक करें, फिर _`नया'' पर क्लिक करें |
 |
|---|---|
| ↪️ अपनी शाखा को एक नाम दें, फिर 'शाखा बनाएं' पर क्लिक करें |  |
| ↪️ Publish your new branch to GitHub |  |
- आप इसे जो चाहें नाम दे सकते हैं, लेकिन चूंकि यह प्रोजेक्ट में आपके नाम के साथ एक कार्ड जोड़ने के लिए एक शाखा है, इसे
आपका-नाम-कार्डकहना अच्छा अभ्यास है क्योंकि यह इस शाखा के इरादे को स्पष्ट रखता है। - अब आपने मास्टर से अलग एक नई शाखा बना ली है।
- अगले चरणों के लिए सुनिश्चित करें कि आप इस शाखा में काम कर रहे हैं। आपको उस शाखा का नाम दिखाई देगा जिस पर आप हैं
गिटहब डेस्कटॉप ऐप का टेर जहां यह Current Branch कहता है।
master शाखा पर काम न करें
- अब हमें वह फ़ाइल खोलने की आवश्यकता है जिसे हम आपके पसंदीदा कोड संपादक के साथ संपादित करने जा रहे हैं।
- अपने कंप्यूटर पर प्रोजेक्ट फोल्डर खोजें। यदि आपने डिफ़ॉल्ट रखा है तो यह 'आपका-कंप्यूटर> दस्तावेज़> GitHub> योगदान-टू-दिस-प्रोजेक्ट' जैसा कुछ होना चाहिए
index.htmlफ़ाइल सीधेयोगदान-टू-दिस-प्रोजेक्टफ़ोल्डर में है।- अपना कोड एडिटर (सबलाइम, वीएस कोड, एटम..आदि) खोलें और
ओपन फाइलकमांड का उपयोग करें और प्रोजेक्ट की मुख्य निर्देशिका में Index.html फ़ाइल का पता लगाएं।
 |
|---|
| ↪️ वैकल्पिक रूप से आप अपनी हार्ड ड्राइव पर फ़ाइल का पता लगा सकते हैं, राइट क्लिक कर सकते हैं और अपने संपादक के साथ खोल सकते हैं |
- अब आपके पास वह फ़ाइल है जिसे आप अपने संपादक में संपादित करने जा रहे हैं और आप उसमें परिवर्तन करने के लिए तैयार हैं।
- हम इस पर काम करना शुरू करने के लिए कार्ड टेम्प्लेट की एक प्रति बनाएंगे
- HTML फ़ाइल के शीर्ष पर,
<head>और<header>अनुभागों के अंतर्गत आपको== TEMPLATE ==लेबल वाला अनुभाग मिलेगा - छवि में लाल वर्ग के भीतर
Contributor Card STARTटिप्पणी सेContributor Card ENDटिप्पणी तक सब कुछ कॉपी करें
 |
|---|
- पूरी बात को सीधे टिप्पणी के नीचे इंगित करते हुए चिपका दें
- सुनिश्चित करें कि आपके कार्ड के प्रारंभ और अंतिम कार्ड के अंत के बीच एक ही पंक्ति में जगह हो। अपने कोड को यथासंभव स्पष्ट रखना अच्छा अभ्यास है
- कभी भी लिंटर या स्टाइल फ़ॉर्मेटर का उपयोग न करें। प्रोजेक्ट में प्रीटीयर सेटअप है
 |
|---|
- अब यह आपका कार्ड है जिसे आप अनुकूलित और संपादित कर सकते हैं।
- अब हम अपने कार्ड में अनुकूलन योग्य फ़ील्ड को बदलते हुए html का संपादन शुरू करेंगे।
| ↪️ 'Name' को अपने नाम से बदलें |  |
|---|
- ध्यान दें:
class=name'न बदलें
↪️ अपने ट्विटर अकाउंट का यूआरएल डालें href="यहां यूआरएल डालें", टेक्स्ट फील्ड में अपना हैंडल टाइप करें |
 |
|---|
|  |
-
यदि आप ट्विटर के अलावा किसी अन्य संपर्क का उपयोग करना पसंद करते हैं, तो आपको फ़ॉन्ट विस्मयकारी आइकन पर जाकर ट्विटर आइकन
<i class="fa fa-twitter"></i>को बदलना होगा .io/icons/) सही आइकन की खोज करना और उदाहरण के लिएfa-facebookजैसे नए आइकन के साथ केवलfa-twitterभाग को बदलना। फिर ऊपर दिए गए समान चरणों का पालन करें। -
यदि आप ट्विटर के अलावा किसी अन्य संपर्क का उपयोग करना पसंद करते हैं तो आपको ट्विटर आइकन को बदलना होगा
<i class="fa fa-twitter"></i>पर जाकर Font Awesome Icons सही आइकन की खोज करना और केवल उसे बदलनाfa-twitterजैसे नए आइकन के साथ भागfa-facebookउदाहरण के लिए। फिर ऊपर दिए गए समान चरणों का पालन करें।
 |
|---|
| ↪️ हमें अपने बारे में कुछ बताएं। इसे छोटा और मीठा रखें। इसे एक ब्लॉग पोस्ट की तुलना में एक ट्वीट की तरह अधिक समझेंt |
 |
| ↪️ समुदाय के साथ संसाधनों के 3 लिंक साझा करें जो वेब विकास के लिए उपयोगी हैं। यह कुछ भी हो सकता है, एक वीडियो, एक वार्ता, एक पॉडकास्ट, एक लेख, एक संदर्भ या एक उपकरण। यदि आप नौसिखिया हैं तो इससे भयभीत न हों, जो कुछ भी आप जानते हैं उसे साझा करें, भले ही आपको लगता है कि यह बुनियादी है। आपको आश्चर्य होगा कि कितने लोगों को लाभ होगा। |
- लिंक:
#की जगहhref="यहां"लिंक डालें. कृपया यूआरएल शॉर्टनर या यूआरएल का उपयोग करने से बचें जो उस साइट से नहीं हैं जिसे आप पोस्ट कर रहे हैं! - शीर्षक: एक संक्षिप्त विवरण
title='यहां'लिखें। - नाम: टेक्स्ट फ़ील्ड
>यहां</a>में संसाधन का नाम लिखें। - सुनिश्चित करें कि आपने अपने सभी परिवर्तनों को सहेज लिया है।
- अपने परिवर्तनों का परीक्षण करें। यह महत्वपूर्ण है! अपने ब्राउज़र में html फ़ाइल खोलें (उदाहरण के लिए उस पर डबल क्लिक करके) और देखें कि साइट पर आपका कार्ड कैसा दिखेगा। देखें कि पूरा पृष्ठ अभी भी वही दिखता है और कुछ भी टूटा हुआ नहीं है। अपने लिंक पर क्लिक करें और सुनिश्चित करें कि वे काम कर रहे हैं। कंसोल खोलें (Ctrl + Shift + J (Windows / Linux) या Cmd + Opt + J (Mac)) और जांचें कि कोई त्रुटि संदेश तो नहीं है।
- बढ़िया, आपने अपना कोड संपादित करना समाप्त कर लिया है! अगले चरण आपके परिवर्तन GitHub को भेजेंगे और फिर उन्हें मुख्य परियोजना के साथ विलय करने के लिए सबमिट करेंगे।
- GitHub डेस्कटॉप ऐप पर वापस जाएं।
- आपके बदलाव स्टेजिंग एरिया में अपने आप जुड़ जाएंगे।
- इसका अर्थ है कि Git ने सभी सहेजे परिवर्तनों को रिकॉर्ड कर लिया है।
- आप इसे ऐप में परिलक्षित देख सकते हैं। आपने जो कुछ भी फ़ाइल में जोड़ा है वह हरे रंग में होगा, और विलोपन लाल रंग में दिखाई देगा।
 |
|---|
| ↪️ अगले चरण को Commit कहा जाता है इसका मोटे तौर पर मतलब है 'परिवर्तनों की पुष्टि करें` |
 |
| ↪️ आपका GitHub डेस्कटॉप हेडर इस तरह दिखना चाहिए। 'वर्तमान भंडार' में प्रोजेक्ट नाम के आगे कांटा प्रतीक पर ध्यान दें, आपकी 'वर्तमान शाखा' में वही नाम होगा जो आपने चरण 3 में दिया था |
 |
↪️ प्रतिबद्ध करने के लिए आपको _सारांश'_ फ़ील्ड भरना होगा। यह प्रतिबद्ध संदेश है जो बताता है कि आपने क्या बदला है। इस मामले में ''मेरे कार्ड की जानकारी जोड़ें'' एक उचित संदेश होगा। वैकल्पिक रूप से आप अधिक विस्तृत _विवरण_ जोड़ सकते हैं। _प्रतिबद्ध_ बटन पर क्लिक करें। आपका बटन कुछ इस तरह कहेगा ``अपनी शाखा-नाम के प्रति प्रतिबद्ध रहें'' |
- आपके परिवर्तन अब सहेजे गए हैं या प्रतिबद्ध हैं। लेकिन वे केवल स्थानीय रूप से सहेजे जाते हैं, यानी आपके कंप्यूटर पर।
- GitHub पर अपने रिपॉजिटरी के साथ स्थानीय परिवर्तनों को सिंक्रनाइज़ करना एक Push कहलाता है। आप अपने स्थानीय रिपॉजिटरी से दूरस्थ रिपॉजिटरी में परिवर्तनों को "पुश" कर रहे हैं
| ↪️ पुश बटन क्लिक करें |  |
|---|
- कुछ सेकंड के बाद ऑपरेशन पूरा हो गया है और अब आपके पास इस शाखा की ठीक वैसी ही कॉपी आपकी मशीन के साथ-साथ GitHub पर भी है।
- यही वह क्षण है जिसका आप इंतजार कर रहे हैं; एक पुल अनुरोध (PR) जमा करना।
- अब तक आपने जो भी काम किया है, वह प्रोजेक्ट के दोराहे पर किया गया है, जो कि आपको याद है कि आपके अपने गिटहब खाते में रहता है।
- अब समय आ गया है कि आप अपने परिवर्तनों को मुख्य परियोजना में विलय के लिए भेजें।
- इसे पुल अनुरोध कहा जाता है क्योंकि आप मूल परियोजना अनुरक्षक को अपने "खींचने" के लिए कह रहे हैं उनकी परियोजना में परिवर्तन।
- GitHub पर your fork के मुख्य पृष्ठ पर जाएं (इसमें सबसे ऊपर fork आइकन और आपका अपना उपयोगकर्ता नाम होगा)।
- रेपो के शीर्ष की ओर आपको हरे बटन के साथ हाइलाइट किया गया पुल अनुरोध संदेश दिखाई देगा।
 |
|---|
↪️ तुलना करें और अनुरोध खींचें पर क्लिक करें |
 |
↪️ ओपन ए पुल रिक्वेस्ट पेज इस तरह दिखता है। |
- याद रखें आप अपनी शाखा को मूल परियोजना के साथ मर्ज करने का प्रयास कर रहे हैं न कि आपके फोर्क पर
मास्टरशाखा के साथ। - नीचे दी गई छवि आपको एक अनुमान देती है कि आपके पुल अनुरोध का शीर्षलेख कैसा दिखना चाहिए।
- बाईं ओर मूल परियोजना है, जिसके बाद मास्टर शाखा है। दाईं ओर आपका कांटा और आपके द्वारा बनाई गई शाखा है।
 |
|---|
↪️ एक पुल अनुरोध बनाएं: एक शीर्षक लिखें, विवरण में वैकल्पिक जानकारी जोड़ें और पुल अनुरोध बनाएं पर क्लिक करें |
- सभी विकल्पों से घबराएं नहीं। अभी के लिए आपको केवल ये तीन चरण करने होंगे।
- 'अनुरक्षकों से संपादन की अनुमति दें' विकल्प को चेक किया हुआ छोड़ दें।
- अब, प्रोजेक्ट मेंटेनर को एक पुल अनुरोध भेजा जाएगा। जैसे ही इसकी समीक्षा की जाएगी और इसे स्वीकार कर लिया जाएगा, आपके बदलाव प्रोजेक्ट वेब पेज पर दिखाई देंगे।
इतना ही। आपने इसे किया है! आपने अब GitHub पर ओपन सोर्स में योगदान दिया है।
आपने एक लाइव वेब पेज में कोड जोड़ा है: https://syknapse.github.io/Contribute-To-This-Project
आपके बदलाव तत्काल दिखाई नहीं देंगे; पहले उन्हें प्रोजेक्ट मेंटेनर द्वारा समीक्षा, स्वीकार और विलय करना होगा। एक बार उनका विलय हो जाने के बाद आपका कार्ड दिखाई देना चाहिए और पृष्ठ पर लाइव होना चाहिए।
एक समीक्षक के लिए PR में बदलाव के लिए पूछना बहुत सामान्य है। अगर आपके साथ ऐसा होता है तो इसे अच्छा अभ्यास समझें। टिप्पणियों और अनुरोधित परिवर्तनों पर नज़र रखें। एक बार जब आप अनुरोधित परिवर्तन (अपनी शाखा में वापस) कर लेते हैं, तो आपको केवल अपने परिवर्तनों को कमिट और पुश करना होता है। नए बदलावों के साथ PR अपने आप अपडेट हो जाएगा।
मैं वादा करता हूं कि मैं जितनी जल्दी हो सके समीक्षा और विलय करने की कोशिश करूंगा लेकिन मैं इसे अपने खाली समय में करता हूं, इसलिए कुछ दिनों की देरी अनिवार्य है।
- अपने मर्ज किए गए पुल अनुरोध की जांच के लिए थोड़ी देर में वापस आएं।- जब आपके परिवर्तन स्वीकृत हो जाएं, या यदि अतिरिक्त परिवर्तनों का अनुरोध किया गया हो तो आपको GitHub से एक ईमेल प्राप्त होना चाहिए। और जब पीआर अंततः मास्टर के साथ विलय हो जाता है और आपका कार्ड जोड़ दिया जाता है।
- आप इस निःशुल्क श्रृंखला से यह भी सीख सकते हैं कि योगदान कैसे करें: How to Contribute to an Open Source Project on GitHub
- यदि आपको यह प्रोजेक्ट उपयोगी लगता है तो कृपया इसे पेज के शीर्ष पर :स्टार: स्टार:स्टार: दें और इसके बारे में ट्वीट करें ताकि इस बात को फैलाने में मदद मिल सके।
- आप मुझे फ़ॉलो करें और संपर्क कर सकते हैं Twitter or using any of these other options
- यह एक ओपन सोर्स प्रोजेक्ट है इसलिए अपने कार्ड में योगदान देने के अलावा बग, सुधार या नई सुविधाओं को ठीक करने में मदद के लिए आपका स्वागत है। एक खोलें issue या नया भेजें pull request
- हमारे समुदाय को बेहतर बनाने में मदद के लिए GitHub पर एक नज़र डालें Discussionsटैब पुल अनुरोध के बगल में स्थित है। यह क्षेत्र अपना परिचय देने, ओपन सोर्स पर गहन चर्चा करने और परियोजना अनुरक्षकों के साथ संवाद करने का स्थान है। क्या आप इस सुविधा को बनाने और हमारे समुदाय को बढ़ाने में हमारी मदद करेंगे?
-इस परियोजना में योगदान देने के लिए धन्यवाद। अब आप आगे बढ़ सकते हैं और अन्य परियोजनाओं में योगदान देने का प्रयास कर सकते हैं; की तलाश करें
शुरुआती-अनुकूल योगदान विकल्पों के लिए लेबल। - मैं पीआर की समीक्षा और विलय में मदद करने के लिए सहयोगियों की भी तलाश कर रहा हूं। यदि आप अधिक उन्नत Git अभ्यास प्राप्त करना चाहते हैं तो कृपया मुझे ट्विटर पर एक DM भेजें और पढ़ें maintainer's guide
यह प्रोजेक्ट काफी हद तक प्रभावित है Roshan Jossey's महान first-contributions अपने उत्कृष्ट ट्यूटोरियल के साथ प्रोजेक्ट करें।
यह विशेष रूप से आसपास के महान समुदाय से भी प्रेरित है#GoogleUdacityScholars Google चैलेंज स्कॉलरशिप: फ्रंट-एंड वेब डेव, 2017 यूरोप की कक्षा।