किसी GitHub प्रोफ़ाइल या रेपो के लिए QR कोड बनाइए

पता चिपकाइए, कोड को अपने स्टिकर या स्लाइड से मेल खाती शैली दीजिए, और उसे छपाई लायक़ डाउनलोड कीजिए - ऐसे URL की ओर मुड़ा हुआ जो अगले नाम बदलने के बाद भी खुलता रहेगा।

1 सामग्री
https://
कोई पंजीकरण नहीं असीमित QR कोड कोई वॉटरमार्क नहीं Free high-resolution downloads
2 डिज़ाइन
आकार
पैटर्न
आँखें
3 झलक
कॉपी हो गया!

GitHub QR कोड क्या है?

GitHub QR कोड ऐसा QR कोड है जो github.com का कोई पता रखता है - कोई प्रोफ़ाइल, रिपॉज़िटरी, रिलीज़, gist, या किसी ख़ास कमिट पर कोई फ़ाइल। उसे स्कैन करने पर वह पेज फ़ोन के ब्राउज़र में खुल जाता है। किसी रिपॉज़िटरी को पढ़ने के लिए GitHub को कोई ऐप नहीं चाहिए, इसलिए स्कैन किसी भी फ़ोन पर चलता है।

KoloQR डिज़ाइनर, जिसमें किसी QR कोड को आकार, रंग और बीच के लोगो के साथ ढाला जा रहा है

कोड में कौन-सा GitHub URL जाना चाहिए?

GitHub के पास एक ही चीज़ के कई पते हैं, और वे बहुत अलग-अलग रफ़्तार से पुराने पड़ते हैं:

  • github.com/owner/repo/releases/latest - हमेशा सबसे नई प्रकाशित रिलीज़ पर रीडायरेक्ट करता है। हार्डवेयर या दस्तावेज़ों पर ऐसे संस्करण नंबर के बजाय यही छापिए जो महीने भर में ग़लत हो जाएगा।
  • github.com/owner/repo/blob/<commit>/path - किसी फ़ाइल का उस रूप का स्थायी लिंक जो वह किसी एक कमिट पर थी। फ़ाइल पेज पर y दबाने से ब्रांच का URL इसी रूप में बदल जाता है, और यही इकलौता फ़ाइल लिंक है जो सड़ नहीं सकता।
  • github.com/owner/repo/blob/main/README.md - ब्रांच का लिंक। सुविधाजनक, पर वह वही दिखाता है जो स्कैन के वक़्त main में हो, और किसी छपे संदर्भ के लिए वह सालों के बदलावों के बाद वाला रूप हो सकता है।

किसी रिपॉज़िटरी या खाते का नाम बदलने पर GitHub रीडायरेक्ट बनाए रखता है, इसलिए छपा कोड नाम बदलने पर ज़रूरी नहीं कि मर ही जाए - पर वह रीडायरेक्ट इस बात पर निर्भर है कि पुराना नाम बिना लिए पड़ा रहे, और छोड़ा गया उपयोगकर्ता नाम कोई और दर्ज करा सकता है। थोक में छपने वाली किसी भी चीज़ के लिए यही वजह है कि अपने नियंत्रण वाले डोमेन का छोटा URL एनकोड कीजिए और उसे GitHub की ओर मोड़िए, ताकि जगह बदलने की क़ीमत दोबारा छपाई नहीं, एक रीडायरेक्ट संपादन रहे।

स्कैन फ़ोन पर असल में क्या खोलता है

फ़ोन पर रिपॉज़िटरी का पेज एक सँकरा स्तंभ है: फ़ाइलों की सूची, और उसके नीचे रेंडर हुआ README। वह पढ़ने लायक़ है, और इसीलिए किसी सम्मेलन स्टिकर या डेव बोर्ड की सिल्कस्क्रीन पर लगा कोड चल पाता है। छापने से पहले दो बातें जानने लायक़ हैं। निजी रिपॉज़िटरी उस हर व्यक्ति को साइन-इन के संकेत के बजाय 404 दिखाती है जो लॉग इन नहीं है, इसलिए निजी काम की ओर मुड़ा कोड सुरक्षित नहीं, टूटा हुआ लगता है - उसे किसी साइन-आउट फ़ोन से जाँचिए। और raw.githubusercontent.com वाला कच्ची फ़ाइल का URL रिपॉज़िटरी खोलने के बजाय डाउनलोड करता है या सादे टेक्स्ट के रूप में दिखाता है, जो किसी कॉन्फ़िग फ़ाइल के लिए सही है और उस हर चीज़ के लिए ग़लत जिसे कोई इंसान पढ़ने वाला है।

QR कोड बनाएँ
छपाई शुरू करने से पहले किसी छपे QR कोड को जाँचता हुआ फ़ोन

GitHub QR कोड कहाँ इस्तेमाल होते हैं

किसी भौतिक चीज़ पर लगा कोड हार्डवेयर, काग़ज़ या मंच से उसके पीछे के स्रोत तक का सबसे छोटा रास्ता है:

सम्मेलन के स्टिकर और बैज

कोड वाला स्टिकर उस रिपॉज़िटरी नाम से बेहतर है जो मंच से ज़ोर से पढ़ा गया और घर लौटते-लौटते आधा ही याद रहा।

हार्डवेयर और डेव बोर्ड

बोर्ड पर सिल्कस्क्रीन किया या डिब्बे पर छपा कोड उपकरण के पूरे जीवन भर फ़र्मवेयर रिपॉज़िटरी और उसकी नवीनतम रिलीज़ की ओर इशारा करता है।

छपे दस्तावेज़ और मैन्युअल

मैन्युअल छपने के दिन ही पुराना पड़ जाता है। रिपॉज़िटरी के docs फ़ोल्डर का कोड वह रूप है जो नहीं पड़ता।

स्लाइड और कार्यशाला के हैंडआउट

आख़िरी स्लाइड पर एक कोड, जो किसी स्थायी लिंक की ओर मुड़ा हो, ताकि लोग जो उदाहरण उतारें वही हो जो उन्होंने देखा।

डेवलपरों के विज़िटिंग कार्ड

प्रोफ़ाइल कोड काम के ब्योरे के बजाय ख़ुद काम ढोता है, और कार्ड का मक़सद यही है।

हैकाथॉन और डेमो डे के पोस्टर

कोई जज या आगंतुक पोस्टर स्कैन करता है और अगली मेज़ तक पहुँचने से पहले ही परियोजना उसके सामने खुली होती है।

GitHub QR कोड कैसे बनाएँ

रिपॉज़िटरी से छपे स्टिकर तक, चार क़दमों में:

QR कोड बनाएँ
  1. 1

    वह URL चुनिए जो सबसे अच्छा टिकेगा

    कार्ड के लिए प्रोफ़ाइल, हार्डवेयर और मैन्युअल के लिए /releases/latest, किसी कोड अंश के लिए कमिट का स्थायी लिंक। छपी किसी भी चीज़ में ब्रांच लिंक और संस्करण नंबरों से बचिए।

  2. 2

    साइन-आउट होकर जाँचिए कि वह खुलता है

    URL किसी निजी विंडो में खोलिए। निजी रिपॉज़िटरी साइन-इन के संकेत के बजाय 404 लौटाती है, और आपके पाठक को भी वही दिखेगा।

  3. 3

    लिंक चिपकाइए और कोड डिज़ाइन कीजिए

    URL क़िस्म चुनिए और पता चिपकाइए, फिर कोई आकार और रंग लीजिए। हल्की ज़मीन पर गहरे मॉड्यूल किसी मैट स्टिकर को उलटी जोड़ी से बेहतर झेलते हैं।

  4. 4

    जाँचिए और एक्सपोर्ट कीजिए

    उसे किसी फ़ोन से स्कैन कीजिए, फिर स्टिकर और सिल्कस्क्रीन के लिए SVG या PDF, और स्लाइडों के लिए PNG एक्सपोर्ट कीजिए।

KoloQR जनरेटर, जिसमें कोई QR कोड डिज़ाइन होकर डाउनलोड के लिए तैयार है

कौन-सा फ़ाइल फ़ॉर्मैट डाउनलोड करें?

KoloQR आपका GitHub QR कोड तीन फ़ॉर्मैट में एक्सपोर्ट करता है। इस हिसाब से चुनिए कि वह कहाँ दिखेगा:

  • PNG स्लाइडों, README और दस्तावेज़ साइटों के लिए, जहाँ कोड एक ही तय आकार में दिखता है।
  • SVG स्टिकरों, सिल्कस्क्रीन कलाकृति और छपे मैन्युअलों के लिए - उस हर चीज़ के लिए जिसे बिना किनारे नरम किए बड़ा किया जाता है।
  • PDF छपाई लायक़ गुणवत्ता पर किसी स्टिकर प्रिंटर या बोर्ड बनाने वाले को सौंपने के लिए।

इस पेज पर ध्यान देने लायक़ चीज़ पेलोड की लंबाई है। github.com/owner क़रीब 25 अक्षरों का है और आराम से छोटा छपता है; किसी पेड़ में गहरे बैठी फ़ाइल का कमिट स्थायी लिंक 100 के पार जा सकता है, जिसे बड़ा चिह्न या बड़ा स्टिकर चाहिए। अगर कोई लंबा स्थायी लिंक थंबनेल जितनी चीज़ पर जाना ही हो, तो उसके आगे अपने डोमेन का छोटा रीडायरेक्ट रख दीजिए।

QR कोड बनाएँ

GitHub QR कोड की बेहतरीन आदतें

किसी कोडबेस के छपे लिंक का एक काम ऐसा है जो ख़ुद कोड नहीं कर सकता: बाद में भी सच बना रहना।

  • संस्करण नंबर नहीं, /releases/latest छापिए

    वह पता हमेशा सबसे नई प्रकाशित रिलीज़ पर रीडायरेक्ट करता है, इसलिए कोई मैन्युअल या उपकरण लेबल ऐसे संस्करण का नाम कभी नहीं लेता जिसकी जगह कोई और ले चुका हो।

  • कोड अंशों के लिए कमिट स्थायी लिंक इस्तेमाल कीजिए

    किसी ब्रांच पर बैठी फ़ाइल का लिंक वही दिखाता है जो स्कैन के वक़्त उस ब्रांच में हो। कमिट का स्थायी लिंक वही दिखाता है जो आपने बग़ल में छापा था।

  • जाँचिए कि निजी रिपॉज़िटरी 404 लौटाती है

    GitHub साइन-आउट आगंतुकों से ऐसी रिपॉज़िटरी के लिए लॉग इन करने को नहीं कहता जिसे वे देख ही नहीं सकते। निजी काम का कोड संगठन के बाहर हर किसी को टूटा हुआ लगता है।

  • लंबे समय चलने वाली छपाई के लिए नाम-बदलने वाले रीडायरेक्ट पर भरोसा मत कीजिए

    किसी रिपॉज़िटरी या खाते का नाम बदलने पर रीडायरेक्ट बना रहता है, पर सिर्फ़ तब तक जब तक पुराना नाम बिना लिए पड़ा हो। सिल्कस्क्रीन और पैकेजिंग उस गारंटी से ज़्यादा जीते हैं।

  • URL को सतह के हिसाब से छोटा रखिए

    प्रोफ़ाइल URL 15 मिमी पर ख़ुशी-ख़ुशी छपता है। उसी आकार पर कोई गहरा स्थायी लिंक उन्हीं वर्ग मिलीमीटरों में सघन चिह्न है, और स्कैन वहीं से हारने लगते हैं।

  • कच्ची फ़ाइल के बजाय रिपॉज़िटरी पेज बेहतर है

    raw.githubusercontent.com वाला लिंक फ़ोन को सादा टेक्स्ट या कोई डाउनलोड थमा देता है। रिपॉज़िटरी का पेज README रेंडर करता है, और इंसान ने स्कैन इसी के लिए किया था।

  • बताइए कि कोड किस ओर ले जाता है

    कोड के बग़ल “फ़र्मवेयर और डॉक्स” या “इस बात का स्रोत” ही स्कैन और कंधे उचकाने का फ़र्क़ है।

  • गहरे स्टिकरों पर कंट्रास्ट का ध्यान रखिए

    हल्की ज़मीन पर गहरे मॉड्यूल वही हैं जिनकी फ़ोन कैमरे उम्मीद करते हैं। अगर स्टिकर को गहरा ही होना हो, तो छपाई का ऑर्डर देने से पहले उलटा रूप कई फ़ोनों पर जाँचिए।

  • क्वाइट ज़ोन बचाइए

    चारों तरफ़ चार मॉड्यूल का साफ़ हाशिया - जो ऐसे छोटे स्टिकर पर आसानी से खो जाता है जहाँ कलाकृति डाई लाइन तक चली जाती है।

  • दूरी के हिसाब से आकार रखिए

    मोटे तौर पर पढ़ने की दूरी का दसवाँ हिस्सा: लैपटॉप के स्टिकर पर क़रीब 2 सेमी, और 2 मीटर से पढ़े जाने वाले पोस्टर पर क़रीब 20 सेमी।

आपका GitHub QR कोड काम क्यों नहीं कर रहा

इस पेज पर पैटर्न शायद ही कभी दिक़्क़त होता है। आम तौर पर उसके पीछे का URL होता है - या तो इसलिए कि वह किधर इशारा करता है, या इसलिए कि वह कितना लंबा है।

  • स्कैन 404 पेज दिखाता है

    वजह
    रिपॉज़िटरी निजी है, या उसका नाम बदला या उसे हटाया गया और पुराना नाम तब से किसी और ने ले लिया, जिससे रीडायरेक्ट हट जाता है।
    समाधान
    रिपॉज़िटरी सार्वजनिक कीजिए, या कोड को उसके बजाय किसी सार्वजनिक प्रोफ़ाइल या डॉक्स पेज की ओर मोड़िए। थोक में छपने वाली किसी भी चीज़ के लिए अपने डोमेन का रीडायरेक्ट एनकोड कीजिए ताकि गंतव्य बदला जा सकने लायक़ बना रहे।
  • कोड छोटे स्टिकर पर स्कैन नहीं होता

    वजह
    कोई गहरा स्थायी लिंक या लंबा फ़ाइल रास्ता एनकोड हुआ, इसलिए चिह्न 15 मिमी के स्टिकर के हल करने लायक़ से कहीं ज़्यादा मॉड्यूल ढो रहा है।
    समाधान
    गंतव्य छोटा कीजिए - प्रोफ़ाइल, रिपॉज़िटरी की जड़, या /releases/latest - या लंबे लिंक के आगे अपने डोमेन का छोटा URL रखिए, फिर कोड दोबारा बनाइए।
  • स्कैन कोई पेज खोलने के बजाय फ़ाइल डाउनलोड कर देता है

    वजह
    URL raw.githubusercontent.com वाला पता है, जो GitHub के रेंडर किए पेज के बजाय ख़ुद फ़ाइल परोसता है।
    समाधान
    उसके बजाय github.com/owner/repo/blob/... वाला पता एनकोड कीजिए। कच्चे लिंक मशीनों के लिए रखिए - जैसे कोई कॉन्फ़िग जिसे कोई स्क्रिप्ट लाती है - कैमरा लिए किसी इंसान के लिए नहीं।
  • कोड परियोजना के पुराने रूप की ओर इशारा करता है

    वजह
    कोई टैग की गई रिलीज़ का URL या ब्रांच लिंक एनकोड हुआ था, और परियोजना आगे बढ़ गई। कोड ठीक वही कर रहा है जो उससे कहा गया था।
    समाधान
    डाउनलोड के लिए /releases/latest और स्रोत के लिए रिपॉज़िटरी की जड़ से दोबारा छापिए। दोनों परियोजना के पीछे चलते हैं, बजाय उसे कलाकृति बनने के दिन पर बाँध देने के।

अब भी तय नहीं कर पा रहे कि गड़बड़ी फ़ाइल में है या प्रिंट में? एक्सपोर्ट की गई इमेज को QR कोड स्कैनर में डालें - अगर वह डेस्कटॉप पर पढ़ी जाती है और कागज़ पर नहीं, तो गड़बड़ी फ़ाइल के बाद आई है।

Questions? Answered

GitHub QR कोड github.com का कोई पता रखता है - कोई प्रोफ़ाइल, रिपॉज़िटरी, रिलीज़, या किसी ख़ास कमिट पर कोई फ़ाइल। उसे स्कैन करने पर वह पेज फ़ोन के ब्राउज़र में खुल जाता है। किसी सार्वजनिक रिपॉज़िटरी को पढ़ने के लिए न कोई ऐप चाहिए न कोई खाता।

विज़िटिंग कार्ड के लिए प्रोफ़ाइल, हार्डवेयर तथा मैन्युअल के लिए github.com/owner/repo/releases/latest, और किसी कोड अंश के लिए कमिट का स्थायी लिंक। छपी किसी भी चीज़ में ब्रांच लिंक और तय किए संस्करण नंबरों से बचिए।

GitHub पुराने पते को नए पर रीडायरेक्ट करता है, इसलिए छपा कोड आम तौर पर चलता रहता है - पर सिर्फ़ तब तक जब तक पुराना नाम बिना लिए पड़ा हो। अगर कोई और उसे दर्ज करा ले, तो रीडायरेक्ट रुक जाता है और कोड उसकी परियोजना पर उतरता है।

बना सकते हैं, पर साइन-आउट आगंतुकों को साइन-इन के संकेत के बजाय 404 मिलता है, इसलिए संगठन के बाहर हर किसी को कोड टूटा हुआ लगता है। सार्वजनिक छपाई को सार्वजनिक पेजों की ओर मोड़िए।

github.com/owner/repo/releases/latest एनकोड कीजिए। GitHub उसे सबसे नई प्रकाशित रिलीज़ पर रीडायरेक्ट कर देता है, इसलिए किसी उपकरण या मैन्युअल पर छपा कोड ऐसे संस्करण का नाम कभी नहीं लेता जिसकी जगह कोई और ले चुका हो।

प्रोफ़ाइल या रिपॉज़िटरी का URL - क़रीब 25 से 40 अक्षर - क़रीब 15 मिमी से भरोसे से छपता है। लंबे कमिट स्थायी लिंक को बड़ा चिह्न चाहिए, इसलिए या तो उसे ज़्यादा जगह दीजिए या पहले गंतव्य छोटा कीजिए।

क्योंकि वह raw.githubusercontent.com का URL एनकोड करता है, जो ख़ुद फ़ाइल परोसता है। अगर कोई इंसान पेज पढ़ने वाला है, कोई मशीन फ़ाइल लाने वाली नहीं, तो github.com/owner/repo/blob/... वाला पता इस्तेमाल कीजिए।

हाँ - PNG एक्सपोर्ट कीजिए और उसे किसी भी दूसरी तस्वीर की तरह कमिट कीजिए। जब README किसी हार्डवेयर का ब्योरा देता हो तब यह करना काम का है, ताकि छपी चीज़ और रिपॉज़िटरी, दोनों वही कोड ढोएँ।

हाँ। सार्वजनिक रिपॉज़िटरी किसी भी मोबाइल ब्राउज़र में रेंडर होती हैं, README समेत। स्कैन खुलेगा या नहीं, इस बारे में ऐप कुछ नहीं बदलता।

कोड से नहीं, और GitHub की ट्रैफ़िक जानकारी सिर्फ़ आपकी अपनी रिपॉज़िटरी ढकती है। किसी ख़ास पोस्टर या स्टिकर छपाई से आए स्कैन गिनने का इकलौता भरोसेमंद तरीक़ा अपने डोमेन का रीडायरेक्ट एनकोड करना है।

आगे पढ़ते रहें

ऐसे पेज जो यहीं से आगे बढ़ते हैं - वही संदर्भ, वैसा ही कोड, या अगला फ़ैसला जो लेना है।

Google Docs QR कोड

कोई दस्तावेज़, हैंडआउट या टेम्पलेट सीधे छपे पन्ने से खोलिए।

शादियाँ

निमंत्रण पर एक कोड, जो मेहमानों को आपके RSVP फ़ॉर्म, कार्यक्रम व रास्ते, और बाद में साझा फ़ोटो एल्बम तक ले जाए।

स्कूल और कक्षाएँ

अनुमति फ़ॉर्म, न्यूज़लेटर, पुस्तकालय के लिंक और छात्रों का काम, उन्हीं छपाई आकारों और निजता नियमों के साथ जो स्कूल को सचमुच चाहिए।

YouTube QR कोड

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

LinkedIn QR कोड

अपनी LinkedIn प्रोफ़ाइल या कंपनी पेज ऐसे कोड से साझा कीजिए जिसे कोई भी फ़ोन कैमरा पढ़ सके।

फ़ॉर्म QR कोड

किसी भी छपी चीज़ से सर्वे, आवेदन या साइन-अप फ़ॉर्म खोलिए।

KoloQR ही क्यों?

  • वेबसाइट, मेन्यू, Wi-Fi, PDF और विज़िटिंग कार्ड के लिए QR कोड बनाएँ
  • रंग, लोगो और अनोखे आकार अपने हिसाब से चुनें
  • हाई-क्वालिटी PNG और SVG फ़ाइलें डाउनलोड करें
  • प्रिंट और डिजिटल, दोनों के लिए बना
QR कोड बनाएँ
एक सादा काला QR कोड और उसके बगल में वही कोड, ब्रांड रंगों के साथ गोल आकार में नए सिरे से डिज़ाइन किया हुआ