A development workspace with notes for an open-source contribution, editorial illustration
व्यावहारिक मार्गदर्शिका

ओपन-सोर्स परियोजनाओं में बदलाव करें

ओपन-सोर्स परियोजनाओं में योगदान देने की शुरुआती मार्गदर्शिका।

पढ़ना शुरू करें
9 मिनट का पठन16 चित्रहिन्दीमूल पृष्ठ
पठन मोड

इस चित्रयुक्त गाइड में पुराने सॉफ़्टवेयर और हार्डवेयर हैं। स्क्रीनशॉट प्रक्रिया समझाते हैं, लेकिन मेनू, कीमत, आवश्यकताएँ और सेवा उपलब्धता बदल सकती हैं। अपने संस्करण के लिए लिंक किए परियोजना दस्तावेज़ पढ़ें।

ओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

ओपन-सोर्स परियोजना का फ़ोर्क कैसे बनाएँ

ओपन-सोर्स सॉफ़्टवेयर में उतरना नए व्यक्ति को गहरे पानी में छलाँग लगाने जैसा लग सकता है। चिंता न करें, हम साथ हैं! इस मार्गदर्शिका में प्रक्रिया का हर हिस्सा समझाएँगे। Bitcoiner.Guide को अभ्यास के लिए इस्तेमाल करके लेख लिखना और उसे मुख्य परियोजना में जोड़ने हेतु बदलाव प्रस्तावित करना सीखेंगे।

चरण 1: GitHub खाता और आवश्यक उपकरण स्थापित करना

आवश्यक चरण

पहले सुनिश्चित करें कि आपके कंप्यूटर पर सभी आवश्यक उपकरण इंस्टॉल हैं।

  1. GitHub खाता: परियोजना का फ़ोर्क बनाने और अपने बदलाव भेजने के लिए GitHub पर खाता चाहिए। अभी खाता न हो तो GitHub पर बनाएँ।

  2. Git: Git संस्करण नियंत्रण प्रणाली है, जिससे डेवलपर अपने कोड के बदलावों को ट्रैक और प्रबंधित करते हैं। GitHub के साथ काम करने के लिए यह आवश्यक है। कई कंप्यूटरों में Git पहले से इंस्टॉल रहता है। जाँचने के लिए टर्मिनल खोलकर git -v लिखें। इंस्टॉल होने पर Git का संस्करण दिखाई देगा। न हो तो यह मार्गदर्शिका देखें।

  3. Visual Studio Code: यह बहुउपयोगी टेक्स्ट संपादक है, जिसमें Git के साथ काम आसान बनाने वाली सुविधाएँ शामिल हैं। इसे यहाँ डाउनलोड करें।

  4. ऐतिहासिक Jekyll स्रोत के लिए रिपॉज़िटरी की निर्भरताएँ स्थापित करने से पहले समर्थित Ruby वातावरण और Bundler इंस्टॉल करें। macOS पर chruby, rbenv, asdf या किसी अन्य समर्थित संस्करण प्रबंधक से अलग Ruby चलाएँ; Apple के सिस्टम Ruby पर निर्भर न रहें। ruby -v से जाँचें, फिर नियमित रूप से sudo इस्तेमाल किए बिना उसी वातावरण में आवश्यक gems इंस्टॉल करें। Windows उपयोगकर्ताओं को समर्थित RubyInstaller और विकास टूलकिट चाहिए। ये Jekyll चरण मूल रिपॉज़िटरी के लिए हैं, स्थिर 3.0 पुनर्रचना के लिए नहीं।

अतिरिक्त जानकारी

टर्मिनल खोलने का तरीका आपके ऑपरेटिंग सिस्टम पर निर्भर है। तीन सबसे प्रचलित डेस्कटॉप ऑपरेटिंग सिस्टम में इसे ऐसे खोलें:

  1. Windows:
    • स्टार्ट मेन्यू से: Start बटन दबाएँ या Windows कुंजी दबाएँ, खोज में “cmd” या “Command Prompt” लिखें और Enter दबाएँ।
    • Run से: Windows+R दबाकर Run डायलॉग खोलें, “cmd” लिखें और Enter दबाएँ।
  2. macOS:
    • Spotlight से: Command+Space दबाकर Spotlight Search खोलें, “Terminal” लिखें और Enter दबाएँ।
    • Finder से: Finder विंडो खोलें, Applications -> Utilities पर जाएँ और Terminal पर दो बार क्लिक करें।
  3. Linux:
    • ऐप ग्रिड से: आपके डिस्ट्रीब्यूशन और वातावरण के अनुसार Terminal ऐप अक्सर ऐप ग्रिड या लॉन्चर में मिलता है।
    • कीबोर्ड शॉर्टकट से: कई डिस्ट्रीब्यूशन में Ctrl+Alt+T दबाकर टर्मिनल विंडो खोल सकते हैं।

Visual Studio Code में किसी भी ऑपरेटिंग सिस्टम पर ऊपर की सूची से View -> Terminal चुनकर टर्मिनल खोल सकते हैं।

चरण 2: Bitcoiner.Guide का फ़ोर्क बनाना

फ़ोर्क बनाने से आपके GitHub खाते में रिपॉज़िटरी की प्रति बनती है। इससे मूल परियोजना को प्रभावित किए बिना बदलाव कर सकते हैं।

  1. https://github.com/BitcoinQnA/Bitcoiner.Guide पर जाएँ।
  2. अपने खाते में परियोजना की प्रति बनाने के लिए पृष्ठ के ऊपर दाईं ओर “Fork” बटन दबाएँ।

FIG. 01चरण 2: Bitcoiner.Guide का फ़ोर्क बनानाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

चरण 3: परियोजना अपने कंप्यूटर पर क्लोन करना

अब कंप्यूटर पर परियोजना की प्रति लेनी है, जिसे “क्लोन” करना कहते हैं।

  1. परियोजना के अपने फ़ोर्क पर जाएँ। URL ऐसा होना चाहिए: https://github.com/YOUR_GITHUB_USERNAME/Bitcoiner.Guide
  2. हरा “Code” बटन दबाएँ और URL कॉपी करने के लिए क्लिपबोर्ड चिह्न दबाएँ।

FIG. 02चरण 3: परियोजना अपने कंप्यूटर पर क्लोन करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

  1. Visual Studio Code खोलें।
  2. बाईं पट्टी में “Source Control” बटन दबाएँ।
  3. “Clone Repository” दबाएँ।
  4. खुलने वाले डायलॉग में कॉपी किया URL पेस्ट करें और Enter दबाएँ।

FIG. 03चरण 3: परियोजना अपने कंप्यूटर पर क्लोन करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

  1. फ़ोल्डर चुनने को कहा जाए तो डेस्कटॉप पर जाएँ और “Select Repository Location” दबाएँ।

FIG. 04चरण 3: परियोजना अपने कंप्यूटर पर क्लोन करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

चरण 4: नई शाखा बनाना

ओपन-सोर्स सहित सहयोगी परियोजनाओं में अपने बदलावों के लिए नई शाखा बनाना अच्छी आदत है। अलग शाखा पर काम करने से बदलाव मुख्य परियोजना से अलग रहते हैं; मुख्य शाखा अक्सर “main” या “master” कहलाती है।

  1. स्क्रीन के नीचे बाईं ओर शाखा का नाम दबाएँ; यह master या main होना चाहिए।
  2. खुलने वाले डायलॉग में Create new branch चुनें।
  3. नई शाखा का नाम लिखें, जैसे “foundation-devices”, और Enter दबाएँ।

FIG. 05चरण 4: नई शाखा बनानाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

नीचे बाईं ओर शाखा का नाम दबाकर सूची से मुख्य शाखा चुनने पर किसी भी समय उसमें लौट सकते हैं।

चरण 5: परियोजना स्थानीय रूप से तैयार करना

Ruby या Bundler इंस्टॉल करने से पहले वर्तमान README, निर्भरता लॉकफ़ाइल और योगदान निर्देश पढ़ें। बदलाव फ़ीचर शाखा पर रखें, परियोजना के दस्तावेज़ में बताए स्थानीय परीक्षण चलाएँ और फिर पुल अनुरोध प्रस्तावित करें। नीचे के उदाहरण आदेश मूल Jekyll परियोजना के हैं; इस स्थानीय डिज़ाइन प्रयोग को बनाने के निर्देश नहीं।

आइए Bitcoiner.Guide अपने कंप्यूटर पर चलाएँ।

  1. Visual Studio Code में टर्मिनल खोलें: View -> Terminal।

FIG. 06चरण 5: परियोजना स्थानीय रूप से तैयार करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

  1. परियोजना के आवश्यक Ruby gems इंस्टॉल करने के लिए bundle install चलाएँ।
  2. स्थानीय सर्वर शुरू करने के लिए bundle exec jekyll serve चलाएँ।
  3. अब वेबसाइट http://localhost:4000 पर देख सकते हैं।

FIG. 07चरण 5: परियोजना स्थानीय रूप से तैयार करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

इस ऐतिहासिक Jekyll रिपॉज़िटरी को क्लोन करने के बाद उसके Gemfile वाले फ़ोल्डर में bundle install चलाएँ, फिर bundle exec jekyll serve चलाएँ। केवल Bundler प्रोग्राम इंस्टॉल करने से इस रिपॉज़िटरी की निर्भरताएँ स्थापित नहीं होतीं। निर्भरता फ़ाइलें बदलने पर bundle install फिर चलाएँ।

चरण 6: बदलाव करना और कमिट करना

अब परियोजना में बदलाव करेंगे। “Foundation Devices” नाम का नया लेख जोड़ेंगे:

  1. Visual Studio Code में इस प्रारूप की नई फ़ाइल बनाएँ: foundation-devices.md।

FIG. 08चरण 6: बदलाव करना और कमिट करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

  1. फ़ाइल के ऊपर यह मेटाडेटा जोड़ें:
---
layout: page
title: Foundation Devices
subtitle: Sovereign computing company
---
  1. मेटाडेटा के नीचे लेख लिखना शुरू करें। उदाहरण के लिए:

Foundation Devices एक हार्डवेयर कंपनी है जो बिटकॉइन-केंद्रित उपकरण बनाती है, ताकि आप अपनी डिजिटल संप्रभुता वापस पा सकें। उनका उद्देश्य ओपन-सोर्स और स्थानीय निर्माण पर ज़ोर देने वाली अलग तरह की हार्डवेयर कंपनी बनाना है। इसकी शुरुआत Passport और Envoy से होती है, लेकिन अभी तो शुरुआत ही है!

Bitcoiner.Guide के लेख Markdown फ़ॉर्मैटिंग इस्तेमाल करते हैं। Markdown, स्वरूपित पाठ बनाने की हल्की मार्कअप भाषा है। पाठ बोल्ड करना, सूचियाँ बनाना और अन्य चीज़ें सीखने के लिए यह उत्कृष्ट मार्गदर्शिका देखें।

लेख में तस्वीरें जोड़ने के लिए:

  1. पहले तस्वीर परियोजना के assets > img फ़ोल्डर में अपलोड करें।

FIG. 09चरण 6: बदलाव करना और कमिट करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

  1. फिर तस्वीर शामिल करने के लिए यह सिंटैक्स इस्तेमाल करें:
<p align="center">
  <img src="/assets/img/your-image-file-name.jpg" class="responsive" style="max-width: 100%; height: auto;" />
</p>
  1. your-image-file-name.jpg की जगह अपनी तस्वीर की फ़ाइल का नाम लिखें।
  2. CMD+S या CTRL+S से फ़ाइल सहेजें।
  3. ब्राउज़र में लौटकर http://localhost:4000/foundation-devices पर जाएँ।

हमने इसे बदला:

---
layout: page
title: Foundation Devices
subtitle: Sovereign computing company
---
Foundation Devices is a hardware company that builds Bitcoin-centric tools that empower you to reclaim your digital sovereignty. They aimed to build a different kind of hardware company with an emphasis on Open Source and local manufacturing. This starts with Passport and Envoy – but they are just getting started!

<p align="center">
  <img src="/assets/img/foundation-devices-images.jpg" class="responsive" style="max-width: 100%; height: auto;" />
</p>

इसमें:

FIG. 10चरण 6: बदलाव करना और कमिट करनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

लेख कैसे बनते हैं, यह अच्छी तरह समझने के लिए परियोजना के अन्य .md लेख देखें। एकरूपता बनाए रखने के लिए परियोजना की लेखन शैली का पालन करना महत्वपूर्ण है।

चरण 7: बदलाव GitHub पर भेजना

आइए बदलाव सहेजकर GitHub पर अपलोड करें।

  1. Visual Studio Code में बाईं ओर स्रोत नियंत्रण चिह्न दबाएँ।
  2. “Changes” अनुभाग में आपके बदलाव दिखने चाहिए। बदलाव स्टेज करने के लिए फ़ाइलों के पास “+” चिह्न दबाएँ।

FIG. 11चरण 7: बदलाव GitHub पर भेजनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

  1. ऊपर टेक्स्ट बॉक्स में कमिट संदेश लिखें, जैसे “Added Foundation Devices article”, और Ctrl+Enter या Mac पर Cmd+Enter दबाएँ।
  2. Source Control दृश्य के ऊपर तीन बिंदु दबाएँ और GitHub पर बदलाव भेजने के लिए “Push” चुनें।

FIG. 12चरण 7: बदलाव GitHub पर भेजनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

FIG. 13चरण 7: बदलाव GitHub पर भेजनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

चरण 8: पुल अनुरोध खोलना

अंत में अपने बदलाव मूल परियोजना में शामिल करने का प्रस्ताव दें:

  1. https://github.com/YOUR_GITHUB_USERNAME/Bitcoiner.Guide पर जाएँ।
  2. “Pull request” बटन दबाएँ।
  3. “New pull request” या “Compare & pull request” दबाएँ।

FIG. 14चरण 8: पुल अनुरोध खोलनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

  1. सुनिश्चित करें कि “base repository” BitcoinQnA/Bitcoiner.Guide हो और “head repository” YOUR_GITHUB_USERNAME/Bitcoiner.Guide हो।
  2. “Create pull request” दबाएँ।
  3. अपने बदलावों का शीर्षक और विवरण लिखें।
  4. फिर “Create pull request” दबाएँ।

FIG. 15चरण 8: पुल अनुरोध खोलनाओपन-सोर्स परियोजनाओं में बदलाव करने का चित्रण

बधाई हो! आपने Bitcoiner.Guide का फ़ोर्क बनाया, योगदान किया और पुल अनुरोध खोल दिया। परियोजना का रखरखाव करने वाला व्यक्ति, यहाँ QnA, आपके बदलावों की समीक्षा करेगा। वह उन्हें जस का तस स्वीकार कर सकता है, संशोधन माँग सकता है या आपके साथ चर्चा कर सकता है।

वैकल्पिक चरण

चरण 9: पुल अनुरोध बनाने के बाद और बदलाव करना

पुल अनुरोध बनाने के बाद आपको और बदलाव करने की आवश्यकता महसूस हो सकती है, या परियोजना के रखरखावकर्ता कोई संशोधन माँग सकते हैं। नया पुल अनुरोध बनाए बिना ऐसा कर सकते हैं। तरीका यह है:

  1. Visual Studio Code में सही शाखा पर रहें: वही शाखा जिस पर शुरुआती बदलाव करके पुल अनुरोध बनाया था।
  2. कोड में अतिरिक्त बदलाव करें और फ़ाइलें सहेजें।
  3. चरण 6-7 की तरह इन बदलावों को स्टेज करके कमिट करें।
  4. Source Control दृश्य के ऊपर तीन बिंदु दबाएँ और “Push” चुनें।

नए बदलाव GitHub के मौजूदा पुल अनुरोध में अपने आप जुड़ जाएँगे। नया पुल अनुरोध बनाने की ज़रूरत नहीं। बदलाव के बारे में टिप्पणी देना चाहें तो GitHub पर अपने पुल अनुरोध में जाएँ और चर्चा में टिप्पणी जोड़ें।

चरण 10: अपने फ़ोर्क को अद्यतन रखना

अपडेट प्राप्त करने से केवल उस समय उपलब्ध रिपॉज़िटरी स्थिति मिलती है। बाद के अपडेट सोच-समझकर जाँचें और लागू करें; सफल फ़ेच से तैनाती अपने आप नवीनतम रहने की गारंटी नहीं मिलती।

फ़ोर्क बनाने पर परियोजना की एक निश्चित समय की प्रति बनती है। लेकिन मूल परियोजना वहीं नहीं रुकती; अन्य योगदानकर्ताओं के बदलावों से विकसित होती रहती है। मूल परियोजना के नवीनतम बदलाव अपने फ़ोर्क में बनाए रखने के लिए ये चरण अपनाएँ:

  1. मूल परियोजना को रिमोट रिपॉज़िटरी की तरह जोड़ें: यह चरण Git को मूल परियोजना का स्थान बताता है। इसे केवल एक बार करना होता है।
    • Visual Studio Code खोलें और सुनिश्चित करें कि Bitcoiner.Guide परियोजना खुली है।
    • Visual Studio Code में View -> Terminal से टर्मिनल खोलें।
    • git remote add upstream https://github.com/BitcoinQnA/Bitcoiner.Guide.git लिखकर Enter दबाएँ। यह आदेश मूल परियोजना की नई रिमोट रिपॉज़िटरी जोड़ता है और उसे “upstream” नाम देता है।
  2. मूल परियोजना के बदलाव प्राप्त करें: यह चरण मूल परियोजना के नवीनतम बदलाव डाउनलोड करता है, लेकिन अभी उन्हें आपकी परियोजना में मिलाता नहीं।
    • टर्मिनल में git fetch upstream लिखें और Enter दबाएँ।
  3. अपनी मुख्य शाखा पर जाएँ: बदलाव मुख्य शाखा में मिलाएँ, अपनी फ़ीचर शाखा में नहीं, जिस पर आपने अपने बदलाव किए थे।
    • Visual Studio Code में नीचे बाईं ओर शाखा का नाम दबाएँ। यह आपकी फ़ीचर शाखा का नाम होना चाहिए।
    • खुलने वाले डायलॉग में मुख्य शाखा चुनें, जिसका नाम आम तौर पर main या master होता है।
  4. बदलाव मिलाएँ: यह चरण मूल परियोजना के बदलाव आपकी मुख्य शाखा में मिला देता है।
    • टर्मिनल में git merge upstream/main या git merge upstream/master लिखें, जो मूल परियोजना की मुख्य शाखा के नाम पर निर्भर है, और Enter दबाएँ।

निष्कर्ष

Bitcoiner.Guide जैसी ओपन-सोर्स परियोजना में योगदान देना, विशेष रूप से शुरुआती लोगों को, कठिन लग सकता है। हालाँकि यह विस्तृत मार्गदर्शिका आत्मविश्वास से फ़ोर्क बनाने, बदलाव करने और पुल अनुरोध भेजने के सभी आवश्यक चरण तथा उपकरण देती है।

याद रखें, ओपन-सोर्स योगदान केवल कोड लिखना नहीं, बल्कि सहयोग, सीखना, साझा करना और सुधारना भी है। पहली बार सब कुछ ठीक न हो तो हतोत्साहित न हों। अभ्यास के साथ प्रक्रिया सहज लगेगी। हर योगदान, चाहे कितना भी छोटा हो, मूल्यवान है।

लेखक के बारे में

नमस्ते, मैं Bitlevi हूँ! संप्रभुता की अपनी यात्रा में जो सीखता हूँ, उसे बिटकॉइन और FOSS साधनों के बारे में लिखकर स्पष्ट करता हूँ। मुझे Twitter पर संदेश भेजें या मेरी वेबसाइट देखें। मार्गदर्शिका पसंद आई और दान देना चाहें तो यह रहा मेरा PayNym!


एक सवाल से दूसरा सवाल निकलता है।

01अटका हुआ लेनदेन: प्रतीक्षा करें, उसे तेज़ करें या रद्द करें02स्व-अभिरक्षा में आपका पहला सप्ताहांत

Find your next answer.

Search the complete field guide · Esc to close