CodeBox Hub
အခမဲ့

GitHub အတွက် QR Code: Repo ကို စကင်တစ်ကြိမ်ဖြင့် ပြသရန်

GitHub QR code တွင် repo, profile, gist, issue link များနှင့် QR အရွယ်အစားများ၊ developer များအသုံးပြုရာနေရာများကို ရှင်းပြထားသည်။

# GitHub အတွက် QR Code: Repo ကို စကင်တစ်ကြိမ်ဖြင့် ပြသရန်

GitHub QR code သည် 2D symbol တစ်ခုဖြစ်ပြီး scan လုပ်သူ၏ browser တွင် GitHub page (အများအားဖြင့် repository ဖြစ်သော်လည်း profile, gist, issue များလည်းဖြစ်နိုင်သည်) ကို ဖွင့်ပေးသည်။ Conferences, job boards, README files များကို ဖုန်းများဖြင့် ဖတ်ရှုကြသောကြောင့် mobile keyboard တွင် github.com/username/repo-name ကို ရိုက်ထည့်ရခြင်းသည် အခက်အခဲဖြစ်စေသည်။ Wikipedia article တွင် ဖော်ပြထားသော code-hosting platform ဖြစ်သည့် GitHub သည် mobile browsing ကို ပုံမှန်အလေ့အထအဖြစ် ပြောင်းလဲစေခဲ့သည်။ ISO/IEC 18004 (DENSO WAVE ၏ QR standard) အရ https URL ပုံမှန်ကို encode လုပ်ထားသောကြောင့် scan လုပ်ရန် app သို့မဟုတ် GitHub login မလိုအပ်ပါ။ အွန်လိုင်း URL QR Code ဖန်တီးစက် ဖြင့် symbol ကို ဖန်တီးပြီး badge သို့မဟုတ် poster တွင် အနည်းဆုံး 25 mm အရွယ်အစားဖြင့် ထားရှိပါ။

မည်သည့် GitHub URL များသည် QR code တွင် အသုံးဝင်သနည်း

GitHub address များအားလုံးသည် QR code တွင် အသုံးဝင်ပါသည်မဟုတ်ပါ။ Developer များ အစစ်အမှန် မျှဝေကြသော URL များမှာ -

အကြောင်းအရာURL patternဥပမာအသုံးဝင်သည့် နေရာ
ကုဒ်ဂိုဒေါင်https://github.com/{user}/{repo}https://github.com/jdoe/cli-toolREADME badge များ၊ talk များ၊ resume များ
ပရိုဖိုင်https://github.com/{user}https://github.com/jdoeအမည်ကတ်များ၊ ညီလာခံ နာမည်ပြားများ
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cscript သို့မဟုတ် snippet ကို မျှဝေရန်
Issuehttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142ပွဲများနှင့် demo များတွင် bug report များ
ဂိုဒေါင်ထဲရှိ ဖိုင်https://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mddocs အတိအကျတစ်ခုဆီ ညွှန်ပြရန်
အဖွဲ့အစည်းhttps://github.com/orgs/{org}https://github.com/orgs/acme-devအဖွဲ့ စာမျက်နှာများ၊ ဝန်ထမ်းခေါ်ယူရေး

Pattern များနှင့် ပတ်သက်သော မှတ်ချက်အချို့ရှိသည်။ Blob path သည် syntax highlighting ဖြင့် file ကို ပြသပြီး README reference ကို scan လုပ်သောအခါ ဤအရာကို လိုအပ်သည်။ Raw link သည် machines အတွက်သာဖြစ်သည်။ Issue URLs များသည် ရှည်လျားသောကြောင့် symbol ကို version မြင့်တက်စေသည် - အောက်ပါ size table တွင် ကုန်ကျစရိတ်ကို ပြသထားသည်။ Repo သည် private ဖြစ်ပါက QR code သည် ရိုက်ထည့်ရခြင်းကိုသာ ချေဖျက်ပေးပြီး scanner သည်လည်း GitHub account နှင့် access လိုအပ်နေဆဲဖြစ်သည်။

URL type အလိုက် QR အရွယ်အစားများ - တိုင်းတာချက်များ

Error-correction level M ဖြင့် URL type တစ်ခုစီအတွက် symbol တစ်ခုစီကို ဖန်တီးပြီး version များကို မှတ်တမ်းတင်ခဲ့သည် -

URL typeဥပမာ အရှည်QR ဗားရှင်း (M)မော်ဂျူး အရေအတွက်Min print at 0.35 mm
ပရိုဖိုင် (22 အက္ခရာ)22225 x 258.75 mm
ကုဒ်ဂိုဒေါင် (35 အက္ခရာ)35329 x 2910.15 mm
Gist (58 အက္ခရာ)58433 x 3311.55 mm
Issue ဂဏန်းပါ (55 အက္ခရာ)55433 x 3311.55 mm
ဖိုင် blob path (74 အက္ခရာ)74537 x 3712.95 mm

Profile URL သည် Version 2 symbol တွင် ဝင်နေသော တစ်ခုတည်းသော URL ဖြစ်သည်။ Path segment ပါဝင်သော အရာအားလုံးသည် Version 3 သို့မဟုတ် 4 တွင် ရောက်ရှိသည်။ Badge တွင် 25 mm symbol အတွက် URL type အားလုံးသည် scan လုပ်ရန် လွယ်ကူသောကြောင့် URL type ရွေးချယ်မှုသည် content ပေါ်မူတည်သင့်ပြီး size ပေါ်မူတည်သင့်ခြင်း မဟုတ်ပါ။ အခြေခံ capacity numbers များကို QR Code တစ်ခုတွင် အချက်အလက် မည်မျှသိမ်းဆည်းနိုင်သနည်း? တွင် ရှာဖွေနိုင်ပြီး module-size rules များကို QR Code အသေးဆုံးအရွယ်အစားမှာ ဘယ်လောက်လဲ? တွင် ရှာဖွေနိုင်သည်။

Developer များသည် GitHub QR codes ကို လက်တွေ့ မည်သည့်နေရာများတွင် ထားကြသနည်း

နေရာချထားမှုပုံစံမည်သူ စကင်ဖတ်သနည်း
ညီလာခံ နာမည်ပြား25 mm၊ နာမည်ပြား၏ အောက်ခြေအတူတက်ရောက်သူများ၊ ဖုန်း လက်ဆင့်ကမ်းစရာ မလိုပါ
အလျှောက်လဲတင် သို့မဟုတ် CV15 မှ 20 mm၊ project အပိုင်း၏ ဘေးတွင်ဖုန်းပေါ်တွင် သုံးသပ်နေသော ဝန်ထမ်းရှာဖွေသူများ
README ၏ အောက်ခြေ အပိုင်းrepo အတွင်း 64 px၊ browser တွင် render လုပ်သည်ဖုန်း link ကို လိုချင်သော ဖတ်ရှုသူများ
ဟောပြောချက် slideနောက်ဆုံး slide တွင် 120 pxပရိသတ်၊ talk အလယ်တွင်
လုပ်ငန်းကတ်16 mm, cornernetworking၊ လက်တစ်ဖက်တည်းဖြင့်

README တွင် QR code သည် ဖုန်းအသုံးပြုသူများအတွက် အဆင်ပြေစေရန် ဖြစ်သည်။ ၎င်းအနားရှိ URL text သည် အခြားသူများအတွက် အလားတူ လုပ်ဆောင်ပေးသည်။ Deck QR code သည် title slide မဟုတ်ဘဲ last slide တွင် ထားရှိသင့်သည်။ အဘယ်ကြောင့်ဆိုသော် talk သည် scan လုပ်ဖို့တန်တယ်လို့ သိရှိမှသာ scan လုပ်ကြသောကြောင့် ဖြစ်သည်။ Website link များအတွက်လည်း အလားတူ sizing rules များအသုံးပြုနိုင်သည် - Website အတွက် QR Code: URL အပိုင်းများနှင့် Redirect အကန့်အသတ်များ တွင် ရှင်းပြထားသည်။

စကင်ဖတ်သည့် ပုံစံ: ဖုန်းက code ကို ဘာလုပ်သနည်း

  • Camera app သည် URL ကို decode လုပ်ပြီး default browser သို့ ပေးပို့သည်။ GitHub app မလိုအပ်ပါ။
  • https သည် အသုံးပြုနိုင်သောနေရာအားလုံးတွင် အလုပ်လုပ်သည်။ http သည် camera app အချို့တွင် ငြင်းပယ်ခံရသောကြောင့် အမြဲ https ကို encode လုပ်ပါ။
  • Rendered page သည် ရိုက်ထည့်ထားသော URL အတိုင်း အလားတူ load ဖြစ်ပြီး private repos အတွက် login prompt ပါဝင်သည်။
  • Decode လုပ်ခြင်းသည် မြန်ဆန်သည် - symbol သည် စက္ကန့်တစ်ခုထက် နည်းသောအချိန်အတွင်း resolve ဖြစ်ပြီး delay များသည် page load ကြောင့်ဖြစ်ပြီး QR ကြောင့်မဟုတ်ပါ။ Version 3 repo code အတွက် scan 20 ကြိမ်ကို တိုင်းတာခဲ့ပြီး decode ပျမ်းမျှသည် စက္ကန့်ဝက်ထက် နည်းပါးသည်။

Code နောက်ကွယ်ရှိ link သည် ပြောင်းလဲနိုင်ပါက (repo rename, new org သို့ migration) QR code ကို stable short link သို့ ညွှန်ကြားပြီး နောက်မှ redirect လုပ်ပါ။ ဤသည်မှာ Static vs Dynamic QR Code - လက်တွေ့ လိုအပ်သောအရာမှာ မည်သည်လဲ trade-off ပုံမှန်ဖြစ်ပြီး repo renames များသည် အရေးပါလောက်အောင် မကြာခဏ ဖြစ်ပွားလေ့ရှိသည်။

workflow - အဆင့် ၃ ခု

  1. https ပါဝင်သော GitHub URL အတိအကျကို အွန်လိုင်း URL QR Code ဖန်တီးစက် တွင် ကူးယူထည့်ပါ။
  2. Error-correction M, 400 px ဖြင့် ဖန်တီးပြီး decoded text သည် URL နှင့် character တစ်ခုချင်းစီ ကိုက်ညီကြောင်း စစ်ဆေးပါ။
  3. သင့် camera နှင့် ဖုန်းတစ်လုံးဖြင့် print ကို စမ်းသပ်ပြီး PNG ကို badge, deck, သို့မဟုတ် README တွင် ထည့်ပါ။

Print လုပ်မီ desktop တွင် အခမဲ့ QR Code Scanner ဖြင့် မြန်ဆန်စွာ စစ်ဆေးနိုင်သည်။ Badge design တွင် logo ပါဝင်ပါက quiet zone ထဲတွင် logo ကို မထည့်ပါနှင့်။ Rules များကို QR Code အလှဆင်ကိရိယာ တွင် ရှာဖွေနိုင်သည်။ ပထမကြိမ် QR ဖန်တီးမည်လား? QR Code ဖန်တီးနည်း - အဆင့်ဆင့် တွင် ပထမကြိမ် flow အပြည့်အစုံကို ဖော်ပြထားသည်။

ကျွန်ုပ်တို့၏ လက်တွေ့ကွင်း စမ်းသပ်မှု

Dev meetup တစ်ခုတွင် 25 mm profile QR codes (bottom corner, dark ink on white) ပါဝင်သော badges 40 ခုကို ဖြန့်ဝေခဲ့သည်။ Event အတွင်း badge-wearers 25 ဦးမှ scan များရရှိမှုကို မေးမြန်းခဲ့ရာ 19 ဦးသည် အနည်းဆုံး scan အောင်မြင်မှု တစ်ကြိမ် ရရှိကြောင်း ဖြေကြားခဲ့သည်။ Diagnose လုပ်နိုင်သော အလုပ်မလုပ်ခြင်းအားလုံးသည် symbol ကြောင့်မဟုတ်ဘဲ badge ကို ပြားပြားချောချောနှင့် ဝေးကွာစွာ ချထားခြင်းကြောင့် ဖြစ်သည်။ Test phones များဖြင့် 20 cm မှ 60 cm အကွာအဝေးတွင် code အစီအစဉ်အတိုင်း 40/40 scan အောင်မြင်ခဲ့သည်။ Failure mode သည် geometry ဖြစ်ပြီး symbology မဟုတ်ပါ - badge ကို camera သို့ ညွှန်ကြားပါက အလုပ်လုပ်သည်။

FAQ

မိမိ၏ GitHub repository အတွက် QR code ကို မည်သို့ ဖန်တီးရမည်နည်း?

Repository URL (https ပါဝင်သော) ကို ကူးယူပြီး URL QR generator တွင် ထည့်ပါ။ 400 px သို့မဟုတ် ထက်ပိုသောအရွယ်အစားဖြင့် export လုပ်ပါ။ Badge သို့မဟုတ် poster တွင် အနည်းဆုံး 25 mm အရွယ်အစားဖြင့် print လုပ်ပါ။

QR code တစ်ခုဖြင့် ဖုန်းပေါ်တွင် GitHub repo ကို ဖွင့်နိုင်သလား?

ရနိုင်သည်။ ဖုန်း camera သည် URL ကို decode လုပ်ပြီး browser တွင် repo ကို ဖွင့်ပေးသည်။ Public repositories အတွက် GitHub app သို့မဟုတ် login မလိုအပ်ပါ။

GitHub QR သည် repo သို့မဟုတ် profile သို့ ညွှန်ကြားသင့်သလား?

Project talk သို့မဟုတ် README အတွက် repo ကို၊ general networking အတွက် profile ကို အသုံးပြုပါ။ Profile code သည် အတိုဆုံးဖြစ်ပြီး symbol ကို သေးငယ်စေသည်။

ပုံနှိပ်ထားသော resume များတွင် GitHub QR codes များ အလုပ်လုပ်သလား?

ရနိုင်သည်။ 15 မှ 20 mm အရွယ်အစားဖြင့် modules အနည်းဆုံး 0.25 mm ဖြင့်။ Quiet zone ကို သန့်ရှင်းစေပြီး dark ink အသုံးပြုပါ။ ဖုန်းဖြင့် scan လုပ်သော recruiters များသည် ဤအရွယ်အစားတွင် အရည်အသွေးရှိသော ရလဒ်များကို ဖြေကြားကြသည်။

မိမိ၏ README တွင် GitHub QR code ကို ထားနိုင်သလား?

ရနိုင်သည်။ URL ကို အနားတွင် ရေးသားထားသော 64 မှ 128 px image အဖြစ်။ GitHub သည် browser တွင် render လုပ်ပေးပြီး ဖုန်းဖတ်ရှုသူများအတွက် one-tap entry ကို ပေးစေသည်။

ညီလာခံ နာမည်ပြားပေါ်ရှိ GitHub QR code ၏ အနိမ့်ဆုံး အရွယ်အစား မည်မျှနည်း?

0.35 mm modules နှင့် four-module quiet zone ဖြင့် ခန့်မှန်း 25 mm ဖြစ်သည်။ Profiles (Version 2) အတွက် သေးငယ်သောအရွယ်အစားလည်း အလုပ်လုပ်သော်လည်း scan margin နည်းပါးစေသည်။

GitHub QR code သည် issue သို့မဟုတ် pull request သို့ ညွှန်ကြားနိုင်သလား?

ရနိုင်သည်။ /issues/{n} နှင့် /pull/{n} ပါဝင်သော public GitHub URL များအားလုံး အလုပ်လုပ်သည်။ Issue URLs များသည် ရှည်လျားသောကြောင့် symbol သည် Version 4 တွင် ရောက်ရှိသည်။

GitHub QR code ကို စကင်ဖတ်ရန် app လိုအပ်သလား?

မလိုအပ်ပါ။ Modern Android နှင့် iPhone camera apps များသည် QR codes များကို native ဖြင့် decode လုပ်ပြီး default browser တွင် ရလဒ်ကို ဖွင့်ပေးသည်။

ဆက်လက်ဖတ်ရှုရန်

ကျွန်ုပ်တို့ကို ဆက်သွယ်ရန်