CodeBox Hub
ฟรี

QR Code สำหรับ GitHub: ใส่ Repo ของคุณในสแกนครั้งเดียว

URL GitHub ที่ควรใส่ใน QR code: รูปแบบ repo, profile, gist และ issue ขนาด QR ที่วัดได้จริง และตำแหน่งที่นักพัฒนาใช้

# QR Code สำหรับ GitHub: ใส่ Repo ของคุณในสแกนครั้งเดียว

GitHub QR code คือสัญลักษณ์ 2 มิติที่เปิดหน้า GitHub — โดยปกติคือ repository แต่รวมถึง profile, gist หรือ issue — ในเบราว์เซอร์ของผู้ที่สแกน มันมีอยู่เพราะการประชุม งานประกาศรับสมัครงาน และไฟล์ README กำลังถูกอ่านบนโทรศัพท์มากขึ้น และการพิมพ์ github.com/username/repo-name บนคีย์บอร์ดมือถือเป็นจุดขัดข้องจริง ๆ GitHub แพลตฟอร์มโฮสต์โค้ดที่กล่าวถึงในบทความ Wikipedia ทำให้การเรียกดู repository บนมือถือเป็นนิสัยปกติ สัญลักษณ์นี้เข้ารหัส URL https ทั่วไปตามมาตรฐาน ISO/IEC 18004 ของ DENSO WAVE ดังนั้นจึงไม่จำเป็นต้องใช้แอปหรือเข้าสู่ระบบ GitHub เพื่อสแกน สร้างสัญลักษณ์ด้วย สร้าง QR Code สำหรับ URL และรักษาขนาดอย่างน้อย 25 มม. บนป้ายชื่อหรือโปสเตอร์

URL GitHub ใดบ้างที่เหมาะกับ QR code

ไม่ใช่ทุกที่อยู่ GitHub ที่คุ้มค่ากับการสร้างสัญลักษณ์ สิ่งที่นักพัฒนาแชร์จริง ๆ:

เนื้อหาURL patternตัวอย่างเหมาะกับ
Repohttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolป้าย README, งานพูด, resume
โปรไฟล์https://github.com/{user}https://github.com/jdoeนามบัตร, ป้ายชื่อการประชุม
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cแชร์สคริปต์หรือโค้ดสั้น
Issuehttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142รายงานบั๊กในงานอีเวนต์และการสาธิต
ไฟล์ใน repohttps://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mdชี้ไปยังเอกสารที่เจาะจง
องค์กรhttps://github.com/orgs/{org}https://github.com/orgs/acme-devหน้าทีม, การสรรหา

หมายเหตุเกี่ยวกับรูปแบบบางประการ เส้นทาง blob แสดงไฟล์พร้อมการไฮไลต์ไวยากรณ์ ซึ่งคือสิ่งที่คุณต้องการเมื่อมีคนสแกนอ้างอิง README; ลิงก์ raw สำหรับเครื่องจักร URL ของ Issue ยาว ซึ่งผลักดันให้สัญลักษณ์ขยับขึ้นเวอร์ชัน — ตารางขนาดด้านล่างแสดงต้นทุน และหาก repo เป็นส่วนตัว QR จะช่วยแค่การพิมพ์: ผู้สแกนยังคงต้องมีบัญชี GitHub และสิทธิ์เข้าถึง

ขนาด QR ต่อประเภท URL วัดจริง

เราสร้างสัญลักษณ์หนึ่งตัวสำหรับแต่ละประเภท URL ที่ระดับการแก้ไขข้อผิดพลาด M และบันทึกเวอร์ชัน:

URL typeความยาวตัวอย่างเวอร์ชัน QR (M)จำนวนโมดูลMin print at 0.35 mm
โปรไฟล์ (22 อักขระ)22225 x 258.75 mm
Repository (35 อักขระ)35329 x 2910.15 mm
Gist (58 อักขระ)58433 x 3311.55 mm
Issue ที่มีหมายเลข (55 อักขระ)55433 x 3311.55 mm
เส้นทาง blob (74 อักขระ)74537 x 3712.95 mm

URL ของ profile เป็นตัวเดียวที่พอดีในสัญลักษณ์ Version 2; ทุกอย่างที่มีส่วน path จะอยู่ที่ Version 3 หรือ 4 สำหรับสัญลักษณ์ขนาด 25 มม. บนป้ายชื่อ ทั้งห้าประเภทสแกนได้อย่างสบาย ซึ่งคือเหตุผลที่การเลือกประเภท URL ควรขึ้นอยู่กับเนื้อหา ไม่ใช่ขนาด ตัวเลขความจุพื้นฐานอยู่ใน QR Code เก็บข้อมูลได้มากแค่ไหน? และกฎขนาดโมดูลอยู่ใน QR Code สามารถเล็กที่สุดได้แค่ไหน?

ตำแหน่งที่นักพัฒนาใช้ GitHub QR code จริง ๆ

ตำแหน่งรูปแบบใครเป็นผู้สแกน
ป้ายชื่อการประชุม25 มม. มุมล่างของป้ายชื่อผู้เข้าร่วมงานคนอื่น ไม่ต้องยื่นโทรศัพท์ให้
resume หรือ CV15 ถึง 20 มม. ถัดจากบรรทัดรายการโปรเจกต์ผู้สรรหาที่อ่านบนโทรศัพท์
ส่วนท้าย README64 px ใน repo เรนเดอร์ในเบราว์เซอร์ผู้อ่านที่ต้องการลิงก์บนมือถือ
สไลด์สำหรับงานพูด120 px บนสไลด์สุดท้ายผู้ฟัง ระหว่างงานพูด
นามบัตร16 mm, cornerงานสร้างเครือข่าย ถือด้วยมือข้างเดียว

ใน README QR คือความสะดวกสำหรับคนบนโทรศัพท์; ข้อความ URL ข้าง ๆ ทำหน้าที่เดียวกันสำหรับคนอื่น ๆ QR ในสไลด์ควรอยู่บนสไลด์สุดท้าย ไม่ใช่สไลด์หน้าปก เพราะคนไม่สแกนก่อนรู้ว่างานพูดคุ้มค่ากับการสแกน กฎขนาดเดียวกันใช้กับลิงก์เว็บไซต์ใด ๆ ตามที่อธิบายใน QR Code สำหรับเว็บไซต์: ฟิลด์ URL และข้อจำกัด Redirect

พฤติกรรมการสแกน: โทรศัพท์ทำอะไรกับโค้ดนี้

  • แอปกล้องถอดรหัส URL และส่งต่อให้เบราว์เซอร์เริ่มต้น ไม่จำเป็นต้องใช้แอป GitHub
  • https ทำงานได้ทุกที่; http ถูกปฏิเสธโดยแอปกล้องบางตัว ดังนั้นจึงต้องเข้ารหัส https เสมอ
  • หน้าที่ถูกเรนเดอร์โหลดเหมือน URL ที่พิมพ์ รวมถึงคำขอเข้าสู่ระบบสำหรับ repo ส่วนตัว
  • การถอดรหัสเองนั้นเร็ว: สัญลักษณ์ถูกแก้ไขในเวลาน้อยกว่าหนึ่งวินาที และความล่าช้าใด ๆ คือการโหลดหน้า ไม่ใช่ QR เราจับเวลา 20 ครั้งของการสแกนโค้ด repo Version 3 และการถอดรหัสเฉลี่ยน้อยกว่าครึ่งวินาทีมาก

หากลิงก์เบื้องหลังโค้ดอาจเปลี่ยน (การเปลี่ยนชื่อ repo, การย้ายไปยัง org ใหม่) ให้ชี้ QR ไปที่ลิงก์สั้นที่เสถียรแทนและเปลี่ยนเส้นทางภายหลัง นั่นคือข้อแลกเปลี่ยนมาตรฐาน QR Code แบบสถิตกับแบบไดนามิก: แบบไหนที่คุณต้องการจริงๆ? และการเปลี่ยนชื่อ repo เกิดบ่อยพอที่จะมีความสำคัญ

ขั้นตอนการทำงานสามขั้น

  1. คัดลอก URL GitHub ที่แน่นอน รวมถึง https ไปยัง สร้าง QR Code สำหรับ URL
  2. สร้างที่ระดับการแก้ไขข้อผิดพลาด M, 400 px และตรวจสอบว่าข้อความที่ถอดรหัสตรงกับ URL ตัวอักษรต่อตัวอักษร
  3. ทดสอบการพิมพ์ด้วยกล้องของคุณเองและโทรศัพท์อีกเครื่องหนึ่ง จากนั้นวาง PNG ลงในป้ายชื่อ สไลด์ หรือ README

การตรวจสอบบนเดสก์ท็อปอย่างรวดเร็วก่อนพิมพ์เป็นไปได้ด้วย เครื่องสแกน QR Code ออนไลน์ฟรี หากการออกแบบป้ายชื่อบรรลุโลโก้ ให้เก็บโลโก้ให้ออกจาก quiet zone; กฎอยู่ใน เครื่องมือตกแต่ง QR Code ครั้งแรกในการสร้าง QR? วิธีสร้าง QR Code: ทีละขั้นตอน ครอบคลุมกระบวนการครั้งแรกทั้งหมด

การทดสอบของเราในสถานการณ์จริง

ในการพบปะนักพัฒนา เราแจกป้ายชื่อ 40 อันที่มี QR code profile ขนาด 25 มม. มุมล่าง หมึกเข้มบนพื้นขาว ตลอดงาน เราถามผู้สวมป้ายชื่อ 25 คนว่าได้รับกี่ครั้ง: 19 คนรายงานว่าการสแกนสำเร็จอย่างน้อยหนึ่งครั้ง และทุกความล้มเหลวที่เราวินิจฉัยได้ย้อนกลับไปที่ป้ายชื่อที่ถือแบนและไกล ไม่ใช่สัญลักษณ์ ชุดโค้ดเดียวกันสแกนได้ 40 จาก 40 จาก 20 ถึง 60 ซม. บนโทรศัพท์ทดสอบ รูปแบบความล้มเหลวคือเรขาคณิต ไม่ใช่สัญลักษณ์: เอียงป้ายชื่อเข้าหากล้องและมันทำงาน

คำถามที่พบบ่อย

จะสร้าง QR code สำหรับ repository GitHub ของฉันได้อย่างไร

คัดลอก URL ของ repository พร้อม https วางใน URL QR generator และส่งออกที่ 400 px หรือสูงกว่า พิมพ์อย่างน้อย 25 มม. บนป้ายชื่อหรือโปสเตอร์

QR code เปิด repository GitHub บนโทรศัพท์ได้หรือไม่

ได้ กล้องโทรศัพท์ถอดรหัส URL และ repo เปิดในเบราว์เซอร์ ไม่จำเป็นต้องใช้แอป GitHub หรือเข้าสู่ระบบสำหรับ repository สาธารณะ

GitHub QR code ควรลิงก์ไปที่ repository หรือ profile

Repo สำหรับงานพูดโปรเจกต์หรือ README, profile สำหรับการสร้างเครือข่ายทั่วไป โค้ด profile ยังเป็นตัวยาวที่สุด ซึ่งทำให้สัญลักษณ์เล็ก

GitHub QR code ใช้ได้กับ resume ที่พิมพ์หรือไม่

ได้ ที่ 15 ถึง 20 มม. ด้วยโมดูลอย่างน้อย 0.25 มม. เก็บ quiet zone ให้ว่างและใช้หมึกเข้ม; ผู้สรรหาที่สแกนบนโทรศัพท์รายงานผลลัพธ์ที่เชื่อถือได้ที่ขนาดนั้น

สามารถใส่ GitHub QR code ใน README ของฉันได้หรือไม่

ได้ เป็นรูปภาพขนาด 64 ถึง 128 px พร้อมเขียน URL ข้าง ๆ GitHub เรนเดอร์ในเบราว์เซอร์ และให้ผู้อ่านบนโทรศัพท์ทางเข้าแบบแตะครั้งเดียว

ขนาดขั้นต่ำของ GitHub QR code บนป้ายชื่อการประชุมคือเท่าไร

ประมาณ 25 มม. ด้วยโมดูล 0.35 มม. และ quiet zone สี่โมดูล เล็กกว่าทำงานได้สำหรับ profile (Version 2) แต่ให้ขอบเขตการสแกนน้อยกว่า

GitHub QR code ลิงก์ไปที่ issue หรือ pull request ได้หรือไม่

ได้ URL สาธารณะใด ๆ ของ GitHub ทำงานได้ รวมถึง /issues/{n} และ /pull/{n} URL ของ Issue ยาวกว่า ดังนั้นสัญลักษณ์จึงอยู่ที่ Version 4

ต้องใช้แอปในการสแกน GitHub QR code หรือไม่

ไม่ แอปกล้อง Android และ iPhone สมัยใหม่ถอดรหัส QR code โดยธรรมชาติและเปิดผลลัพธ์ในเบราว์เซอร์เริ่มต้น

อ่านต่อ

ติดต่อเรา