लोगो बनाया गया 💖 द्वारा 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 हैलो वर्ल्ड ट्यूटोरियल करें।
- यदि आपके पास Git नहीं है, इसे यहां से इंस्टॉल करें
अब जब आप पूरी तरह तैयार हो गए हैं तो आइए परियोजना में योगदान देने का काम शुरू करें।
10 आसान चरणों में ओपन सोर्स योगदानकर्ता बनें।
अनुमानित समय: 30 मिनट से कम.
- यहां उद्देश्य इस परियोजना की प्रतिलिपि बनाना और इसे अपने खाते में रखना है।
- एक रिपॉजिटरी (रेपो) यह है कि गिटहब पर एक प्रोजेक्ट कैसे कहा जाता है और एक कांटा इसकी एक प्रति है।
- सुनिश्चित करें कि आप मुख्य पृष्ठ पर हैं यह रेपो।
 |
|---|
| फोर्क बटन पर क्लिक करें |
- अब आपके पास अपने खाते में प्रोजेक्ट की पूरी प्रति है।
- अब हम परियोजना की एक स्थानीय प्रति बनाना चाहते हैं। यह आपकी अपनी मशीन पर सहेजी गई एक प्रति है।
- अब इस रेपो को अपनी मशीन पर क्लोन करें। क्लोन बटन पर क्लिक करें और फिर क्लिपबोर्ड पर कॉपी करें आइकन पर क्लिक करें।
- एक रिपोजिटरी (रेपो) यह है कि GitHub पर एक प्रोजेक्ट को कैसे कॉल किया जाता है और एक कांटा इसकी एक प्रति है। एक टर्मिनल खोलें और निम्नलिखित git कमांड चलाएँ:
git clone "url you just copied"उदाहरण के लिए:
git clone https://github.com/$Username/Contribute-To-This-Project.gitजहां $Username आपका GitHub उपयोगकर्ता नाम है। यहां आप GitHub पर प्रथम-योगदान भंडार की सामग्री को अपने कंप्यूटर पर कॉपी कर रहे हैं।
अपने कंप्यूटर पर रिपॉजिटरी निर्देशिका में बदलें (यदि आप पहले से वहां नहीं हैं):
cd Contribute-To-This-Projectअब git checkout कमांड का उपयोग करके एक नई शाखा बनाएं
git checkout -b your-new-branch-nameउदाहरण के लिए:
git checkout -b add-$Username-cardनोट: अपने GitHub खाते के उपयोगकर्ता नाम के साथ $Username बदलें।
- अब आपने मास्टर से अलग एक नई शाखा बना ली है।
- अगले चरण के लिए सुनिश्चित करें कि आप इस शाखा में काम कर रहे हैं। जिस शाखा का आप उपयोग कर रहे हैं उसके नीचे बाईं ओर आपको उस शाखा का नाम दिखाई देगा जहां आप अपनी शाखा के नाम के रूप में
$उपयोगकर्ता नाम-कार्डलिखते हैं।
master शाखा पर काम न करें
-
अब हमें वह फ़ाइल खोलने की आवश्यकता है जिसे हम आपके पसंदीदा कोड संपादक के साथ संपादित करने जा रहे हैं। हम अपने पसंदीदा कोड संपादक के रूप में VSCode का उपयोग कर रहे हैं।
-
index.htmlफ़ाइल सीधेContribute-To-This-Projectफ़ोल्डर में है। -
आप फ़ाइल को निम्न आदेश से खोल सकते हैं:
code index.htmlनोट: यह फ़ाइल खोलने के लिए एक टर्मिनल कोड है: index.html को VSCode में।
- अब आपके पास वह फ़ाइल है जिसे आप अपने संपादक में संपादित करने जा रहे हैं और आप उसमें परिवर्तन करने के लिए तैयार हैं।
- हम इस पर काम करना शुरू करने के लिए कार्ड टेम्प्लेट की एक प्रति बनाएंगे
- 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 को भेजेंगे और फिर उन्हें मुख्य परियोजना के साथ विलय करने के लिए सबमिट करेंगे।
- अब अपने प्रोजेक्ट डायरेक्टरी में टर्मिनल खोलें और
git statusचलाएँ और आप देखेंगे कि git में कोई बदलाव नहीं किया गया है। - आप
git-addकमांड का उपयोग करके अपने द्वारा किए गए परिवर्तनों को जोड़ सकते हैं
git add index.html- अब
गिट कमिटकमांड का उपयोग करके उन परिवर्तनों को प्रतिबद्ध करें
git commit -m "Add $Username card info"$Usernameको अपने Github उपयोगकर्ता नाम से बदलना।
- आपके परिवर्तन अब सहेजे गए हैं या प्रतिबद्ध हैं। लेकिन वे केवल स्थानीय रूप से सहेजे जाते हैं, यानी आपके कंप्यूटर पर।
- GitHub पर अपने रिपॉजिटरी के साथ स्थानीय परिवर्तनों को सिंक्रनाइज़ करना एक Push कहलाता है। आप अपने स्थानीय रिपॉजिटरी से दूरस्थ रिपॉजिटरी में परिवर्तनों को "पुश" कर रहे हैं
- हम जीथब में परिवर्तनों को पुश करने के लिए
गिट पुशकमांड का उपयोग करते हैं।
git push -u origin $Username-card-
$Username-cardको अपनी शाखा के नाम से बदलना। -
कुछ सेकंड के बाद ऑपरेशन पूरा हो गया है और अब आपके पास इस शाखा की ठीक वैसी ही कॉपी आपकी मशीन के साथ-साथ 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 यूरोप की कक्षा।