GitHub सिंक
डिवाइस कोड या टोकन से GitHub जोड़ें, प्रोजेक्ट को नई या मौजूदा रिपो के रूप में पब्लिश करें, मशीनों के बीच पुश और पुल करें, और जानें कि आपका टोकन कैसे सुरक्षित रहता है।
GitHub सिंक वैकल्पिक रूप से मशीन के बाहर बैकअप और बहु-कंप्यूटर हस्तांतरण देता है, और यह उस असली Git रिपो पर बना है जो हर प्रोजेक्ट पहले से ही है। लोकल कमिट GitHub के बिना काम करती हैं। जुड़ने पर भी तस्वीर में कोई Oleafly अकाउंट नहीं आता: केवल आपका GitHub।
अपना अकाउंट जोड़ना
“अपना अकाउंट जोड़ना” शीर्षक वाला अनुभागSettings, Integrations, GitHub, फिर दो में से कोई एक रास्ता:
- Connect GitHub (अनुशंसित): एक डिवाइस-कोड प्रवाह। Oleafly एक छोटा कोड दिखाता है, आपका ब्राउज़र
github.com/login/deviceखोलता है (कोड के लिए एक Copy बटन के साथ), आप मंज़ूरी देते हैं, और ऐप कुछ ही सेकंड में उसे पहचान लेता है। कनेक्शन केवलrepoऔरread:userस्कोप माँगता है। - Personal access token: अगर आप खुद का क्रेडेंशियल बनाना पसंद करते हैं, तो “Advanced: use a personal access token” खोलकर कोई PAT पेस्ट करें।
एक बार जुड़ने पर, आपका अवतार और उपयोगकर्ता नाम Settings में और ऊपरी टूलबार के GitHub मेन्यू में दिखने लगते हैं। Disconnect टोकन भूल जाता है।
आपका टोकन कैसे सुरक्षित रहता है
“आपका टोकन कैसे सुरक्षित रहता है” शीर्षक वाला अनुभागटोकन एक AES-256-GCM एन्क्रिप्टेड, स्वामी-प्रतिबंधित स्थानीय फ़ाइल में सहेजा जाता है और कभी ऐप की UI परत को नहीं सौंपा जाता; इंटरफ़ेस को केवल इतना ही पता चलता है कि “connected as @you”। जब Git को प्रमाणीकरण की ज़रूरत होती है, तो टोकन एक इन-मेमोरी क्रेडेंशियल हेल्पर से इंजेक्ट किया जाता है, इसलिए वह कभी कमांड लाइन में, .git/config में या आपके शेल इतिहास में नहीं दिखता। रिमोट URL में टोकन जोड़ने वाले पुराने बिल्ड शुरू होते ही अपने आप साफ़ हो जाते हैं।
कोई प्रोजेक्ट पब्लिश करना
“कोई प्रोजेक्ट पब्लिश करना” शीर्षक वाला अनुभागSource Control पैनल में Publish to GitHub पर क्लिक करें:
- Create new repository: कोई नाम चुनें (प्रोजेक्ट से पहले से भरा हुआ), Private (अनुशंसित) को चेक्ड रखें या हटाएँ, और Create and push करें। Oleafly रिपो बनाता है, प्रोजेक्ट की फ़ाइलें कमिट करता है,
originजोड़ता है, और पुश करता है। - Link existing: अपनी रिपॉज़िटरी की खोज योग्य सूची में से चुनें (प्राइवेट वालों पर ताला दिखता है) और Link and push करें।
पब्लिश करने के बाद, टूलबार का GitHub मेन्यू Open in GitHub और Copy repository link देता है।
जो फ़ाइलें सीक्रेट जैसी दिखती हैं वे स्थानीय रहती हैं
“जो फ़ाइलें सीक्रेट जैसी दिखती हैं वे स्थानीय रहती हैं” शीर्षक वाला अनुभागपब्लिश करते समय कभी वे फ़ाइलें कमिट नहीं होतीं जो आम तौर पर कुंजियाँ या पासवर्ड रखती हैं, जैसे .env, *.pem, SSH प्राइवेट की, या credentials.json। वे प्रोजेक्ट फ़ोल्डर में अनस्टेज्ड रहती हैं, और डायलॉग उनके नाम बताता है। फिर भी किसी एक को पब्लिश करने के लिए, उसे Source Control में खुद स्टेज करके कमिट करें। .env.example जैसे टेम्पलेट, पब्लिक की और Keynote की .key फ़ाइलें हमेशा की तरह पब्लिश होती हैं।
पुश पूरा इतिहास अपलोड करता है। अगर इनमें से किसी नाम की फ़ाइल कभी कमिट हुई हो, तो Oleafly उसकी सूची देता है और GitHub पर कुछ भी बनाने से पहले Cancel या Publish anyway की प्रतीक्षा करता है।
रोज़मर्रा का सिंक
“रोज़मर्रा का सिंक” शीर्षक वाला अनुभागSource Control पैनल के Push और Pull बटन वही करते हैं जो कहते हैं, आपकी मौजूदा ब्रांच पर origin के साथ। Fetch और Sync More Source Control actions मेन्यू में हैं, और Commit & Push तथा Commit & Sync Commit के बगल के मेन्यू में। ब्रांच पिल के बगल का ahead/behind संकेतक (↑ ↓) बताता है कब कुछ पुश या पुल करना है।
दो कंप्यूटर
“दो कंप्यूटर” शीर्षक वाला अनुभाग- मशीन A पर: प्रोजेक्ट पब्लिश करें, काम करें, Push करें।
- मशीन B पर: वही GitHub अकाउंट जोड़ें, फिर Import a project → GitHub चुनें और रिपॉज़िटरी चुनें। इंपोर्ट गाइड देखें। उसके बाद: Pull, काम करें, Push करें।
- वापस A पर: शुरू करने से पहले Pull करें। संकेतक आपको याद दिला देता है।
कवर रंग, मुख्य-डॉक्यूमेंट चुनाव और इतिहास सब साथ चलते हैं, क्योंकि वे प्रोजेक्ट फ़ोल्डर में ही रहते हैं।
अपना मन बदलना
“अपना मन बदलना” शीर्षक वाला अनुभागएक बार रिमोट सेट होने पर, More Source Control actions मेन्यू में दो और आइटम आ जाते हैं:
- Change repo पब्लिश डायलॉग दोबारा खोलता है ताकि
originकहीं और इशारा करे। - Unlink रिमोट हटा देता है; स्थानीय प्रोजेक्ट और उसका इतिहास अछूते रहते हैं।
कंफ़्लिक्ट और ब्रांच
“कंफ़्लिक्ट और ब्रांच” शीर्षक वाला अनुभागअगर किसी pull में मर्ज कंफ़्लिक्ट आए, तो Source Control कंफ़्लिक्ट वाली फ़ाइलों की सूची देता है। हर एक के लिए Use current या Use incoming चुनें, या फ़ाइल एडिट करके Mark resolved चुनें, फिर Complete merge करें। Abort merge फ़ाइलों को पहले जैसा कर देता है। Push और Pull उसी ब्रांच पर काम करते हैं जो आपने चेक आउट की है, और पैनल के शीर्ष का ब्रांच मेन्यू ब्रांच बदलता या बनाता है। Git और सोर्स कंट्रोल देखें।
सीमाएँ, साफ़-साफ़
“सीमाएँ, साफ़-साफ़” शीर्षक वाला अनुभागOleafly HTTPS रिमोट प्रमाणीकृत करता है। Publish आपके लिए एक सही रिमोट सेट कर देता है।
अगर कुछ विफल हो
“अगर कुछ विफल हो” शीर्षक वाला अनुभाग- “No remote ‘origin’”: पहले पब्लिश करें; Push और Pull को एक रिमोट चाहिए।
- रिमोट में कमिट पहले से मौजूद होने के कारण Push अस्वीकृत: पहले pull करें, फिर push करें।
- “No GitHub token set”: Settings, Integrations, GitHub में जाकर जोड़ें।
और जानकारी FAQ में।