สร้าง QR Code สำหรับโปรไฟล์หรือรีโพบน GitHub

วางที่อยู่ ปรับสไตล์โค้ดให้เข้ากับสติกเกอร์หรือสไลด์ของคุณ แล้วดาวน์โหลดแบบพร้อมพิมพ์ โดยชี้ไปยัง URL ที่จะยังเปิดได้แม้หลังการเปลี่ยนชื่อครั้งต่อไป

1 เนื้อหา
https://
ไม่ต้องสมัครสมาชิก QR Code ไม่จำกัด ไม่มีลายน้ำ Free high-resolution downloads
2 ออกแบบ
รูปทรง
ลวดลาย
ดวงตา
3 ตัวอย่าง
คัดลอกแล้ว

QR Code GitHub คืออะไร

QR Code GitHub คือ QR Code ที่เก็บที่อยู่ github.com ไม่ว่าจะเป็นโปรไฟล์ รีโพ รีลีส gist หรือไฟล์ ณ คอมมิตหนึ่ง เมื่อสแกนแล้วหน้านั้นจะเปิดในเบราว์เซอร์บนมือถือ GitHub ไม่บังคับให้ใช้แอปเพื่ออ่านรีโพ การสแกนจึงใช้ได้กับมือถือทุกเครื่อง

หน้าออกแบบของ KoloQR ที่กำลังปรับสไตล์ QR Code ทั้งรูปทรง สี และโลโก้ตรงกลาง

ควรใส่ URL แบบไหนของ GitHub ลงในโค้ด

GitHub มีที่อยู่หลายแบบสำหรับสิ่งเดียวกัน และแต่ละแบบเก่าเร็วไม่เท่ากันเลย

  • github.com/owner/repo/releases/latest - เปลี่ยนเส้นทางไปยังรีลีสล่าสุดที่เผยแพร่เสมอ ให้พิมพ์อันนี้ลงบนฮาร์ดแวร์หรือเอกสาร แทนเลขเวอร์ชันที่จะผิดภายในเดือนเดียว
  • github.com/owner/repo/blob/<คอมมิต>/path - ลิงก์ถาวรไปยังไฟล์ในสภาพ ณ คอมมิตนั้น การกด y ที่หน้าไฟล์จะเขียน URL ของ branch ใหม่ให้เป็นรูปแบบนี้ และเป็นลิงก์ไฟล์แบบเดียวที่ไม่มีวันเน่า
  • github.com/owner/repo/blob/main/README.md - ลิงก์ branch สะดวกดี แต่แสดงสิ่งที่ main มีอยู่ ณ ตอนที่สแกน ซึ่งสำหรับเอกสารอ้างอิงที่พิมพ์ไว้ อาจหมายถึงการเปลี่ยนแปลงหลายปีให้หลัง

GitHub ยังคงการเปลี่ยนเส้นทางไว้เมื่อรีโพหรือบัญชีถูกเปลี่ยนชื่อ โค้ดที่พิมพ์แล้วจึงไม่จำเป็นต้องตายทันทีเพราะการเปลี่ยนชื่อ แต่การเปลี่ยนเส้นทางนั้นขึ้นอยู่กับว่าชื่อเดิมยังไม่ถูกใครจับจอง และชื่อผู้ใช้ที่ปล่อยไปแล้วอาจถูกคนอื่นลงทะเบียนได้ สำหรับงานที่พิมพ์จำนวนมาก นี่คือเหตุผลที่ควรเข้ารหัส URL สั้นบนโดเมนที่คุณควบคุมเองแล้วชี้ไป GitHub การย้ายจะเสียแค่การแก้การเปลี่ยนเส้นทางหนึ่งครั้ง แทนที่จะต้องพิมพ์ใหม่

สแกนแล้วเปิดอะไรจริง ๆ บนมือถือ

หน้ารีโพบนมือถือคือคอลัมน์แคบ ๆ มีรายการไฟล์ แล้วต่อด้วย README ที่เรนเดอร์ไว้ด้านล่าง อ่านได้สบาย และนั่นคือเหตุผลที่โค้ดบนสติกเกอร์งานประชุมหรือบนซิลค์สกรีนของบอร์ดพัฒนาถึงใช้งานได้จริง มีสองเรื่องที่ควรรู้ก่อนพิมพ์ รีโพส่วนตัวจะแสดง 404 ให้กับคนที่ไม่ได้ล็อกอิน ไม่ใช่หน้าขอให้เข้าสู่ระบบ โค้ดที่ชี้ไปยังงานส่วนตัวจึงดูเหมือนพัง ไม่ใช่ดูเหมือนถูกป้องกันไว้ ให้ทดสอบจากมือถือที่ออกจากระบบแล้ว และอีกเรื่อง URL ไฟล์ดิบบน raw.githubusercontent.com จะดาวน์โหลดหรือแสดงเป็นข้อความล้วนแทนที่จะเปิดรีโพ ซึ่งเหมาะกับไฟล์คอนฟิก แต่ไม่เหมาะกับสิ่งที่ตั้งใจให้คนอ่าน

สร้าง QR Code
โทรศัพท์กำลังสแกน QR Code ที่พิมพ์ออกมาเพื่อทดสอบก่อนพิมพ์จริง

QR Code GitHub ถูกใช้ที่ไหนบ้าง

โค้ดบนวัตถุจริงคือทางที่สั้นที่สุดจากฮาร์ดแวร์ กระดาษ หรือเวที ไปยังซอร์สโค้ดที่อยู่เบื้องหลัง

สติกเกอร์และบัตรงานประชุม

สติกเกอร์ที่มีโค้ดชนะชื่อรีโพที่ประกาศจากเวทีแล้วจำได้ครึ่ง ๆ กลาง ๆ ระหว่างทางกลับบ้าน

ฮาร์ดแวร์และบอร์ดพัฒนา

โค้ดที่ซิลค์สกรีนบนบอร์ดหรือพิมพ์บนกล่อง ชี้ไปยังรีโพเฟิร์มแวร์และรีลีสล่าสุด ตลอดอายุการใช้งานของอุปกรณ์

เอกสารและคู่มือที่พิมพ์ออกมา

คู่มือล้าสมัยตั้งแต่วันที่พิมพ์ แต่โค้ดที่ชี้ไปยังโฟลเดอร์ docs ในรีโพคือเวอร์ชันที่ไม่ล้าสมัย

สไลด์และเอกสารเวิร์กช็อป

โค้ดหนึ่งอันบนสไลด์สุดท้าย ชี้ไปยังลิงก์ถาวร เพื่อให้ตัวอย่างที่คนคัดลอกไปคือตัวอย่างเดียวกับที่พวกเขาเห็น

นามบัตรของนักพัฒนา

โค้ดโปรไฟล์พาไปที่ตัวงานเอง ไม่ใช่คำอธิบายเกี่ยวกับงาน ซึ่งก็คือประเด็นทั้งหมดของนามบัตร

โปสเตอร์ในแฮกกาธอนและเดโมเดย์

กรรมการหรือผู้เยี่ยมชมสแกนโปสเตอร์แล้วเปิดโปรเจกต์ได้ก่อนเดินถึงโต๊ะถัดไป

วิธีสร้าง QR Code GitHub

จากรีโพถึงสติกเกอร์ที่พิมพ์แล้วในสี่ขั้นตอน

สร้าง QR Code
  1. 1

    เลือก URL ที่จะเก่าช้าที่สุด

    โปรไฟล์สำหรับนามบัตร /releases/latest สำหรับฮาร์ดแวร์และคู่มือ ลิงก์ถาวรของคอมมิตสำหรับตัวอย่างโค้ด และหลีกเลี่ยงลิงก์ branch กับเลขเวอร์ชันในทุกงานพิมพ์

  2. 2

    ตรวจว่าเปิดได้ตอนออกจากระบบ

    เปิด URL ในหน้าต่างส่วนตัว รีโพส่วนตัวจะคืน 404 แทนที่จะขอให้เข้าสู่ระบบ และนั่นคือสิ่งที่คนอ่านของคุณจะเห็นเช่นกัน

  3. 3

    วางลิงก์แล้วออกแบบโค้ด

    เลือกประเภท URL วางที่อยู่ แล้วเลือกรูปทรงกับสี โมดูลสีเข้มบนพื้นสว่างทนสติกเกอร์ผิวด้านได้ดีกว่าคู่สีที่กลับด้าน

  4. 4

    ทดสอบแล้วส่งออก

    สแกนด้วยมือถือ แล้วส่งออก SVG หรือ PDF สำหรับสติกเกอร์และซิลค์สกรีน และ PNG สำหรับสไลด์

เครื่องมือสร้าง QR Code ของ KoloQR ที่กำลังออกแบบโค้ดและพร้อมดาวน์โหลด

ควรดาวน์โหลดไฟล์รูปแบบไหน?

KoloQR ส่งออก QR Code GitHub ของคุณได้สามรูปแบบ เลือกจากที่ที่มันจะไปปรากฏ

  • PNG สำหรับสไลด์ README และเว็บไซต์เอกสาร ซึ่งโค้ดแสดงในขนาดคงที่
  • SVG สำหรับสติกเกอร์ อาร์ตเวิร์กซิลค์สกรีน และคู่มือที่พิมพ์ ทุกอย่างที่ถูกขยายโดยขอบไม่เบลอ
  • PDF สำหรับส่งโรงพิมพ์สติกเกอร์หรือผู้ผลิตบอร์ดด้วยคุณภาพพร้อมพิมพ์

สิ่งที่ต้องจับตาในหน้านี้คือความยาวของข้อมูล github.com/owner ยาวราว 25 ตัวอักษรและพิมพ์เล็กได้สบาย แต่ลิงก์ถาวรของคอมมิตที่ชี้ไปยังไฟล์ลึก ๆ ในโครงสร้างอาจเกิน 100 ตัวอักษร ซึ่งต้องใช้สัญลักษณ์ใหญ่ขึ้นหรือสติกเกอร์ใหญ่ขึ้น ถ้าลิงก์ถาวรยาว ๆ ต้องไปอยู่บนของขนาดเท่าเล็บมือ ให้วางลิงก์เปลี่ยนเส้นทางสั้น ๆ บนโดเมนของคุณเองไว้ข้างหน้ามัน

สร้าง QR Code

แนวปฏิบัติที่ดีสำหรับ QR Code GitHub

ลิงก์ที่พิมพ์ไปยังฐานโค้ดมีหน้าที่หนึ่งที่ตัวโค้ดเองทำไม่ได้ คือยังคงเป็นความจริงในภายหลัง

  • พิมพ์ /releases/latest ไม่ใช่เลขเวอร์ชัน

    ที่อยู่นั้นเปลี่ยนเส้นทางไปยังรีลีสล่าสุดที่เผยแพร่เสมอ คู่มือหรือฉลากอุปกรณ์จึงไม่มีวันระบุเวอร์ชันที่ถูกแทนที่ไปแล้ว

  • ใช้ลิงก์ถาวรของคอมมิตสำหรับตัวอย่างโค้ด

    ลิงก์ไปยังไฟล์บน branch แสดงสิ่งที่ branch นั้นมีอยู่ตอนสแกน ส่วนลิงก์ถาวรของคอมมิตแสดงสิ่งที่คุณพิมพ์ไว้ข้าง ๆ จริง ๆ

  • ตรวจว่ารีโพส่วนตัวคืนค่า 404

    GitHub ไม่เชิญให้ผู้เยี่ยมชมที่ออกจากระบบเข้าสู่ระบบสำหรับรีโพที่พวกเขาไม่มีสิทธิ์เห็น โค้ดที่ชี้ไปงานส่วนตัวจึงดูพังสำหรับทุกคนนอกองค์กร

  • อย่าพึ่งการเปลี่ยนเส้นทางจากการเปลี่ยนชื่อในงานพิมพ์อายุยาว

    การเปลี่ยนชื่อรีโพหรือบัญชีทิ้งการเปลี่ยนเส้นทางไว้ แต่เฉพาะตราบที่ชื่อเดิมยังไม่ถูกจับจอง ซิลค์สกรีนและบรรจุภัณฑ์อยู่ยาวกว่าคำรับประกันนั้น

  • ทำ URL ให้สั้นพอกับพื้นผิวที่จะไปอยู่

    URL โปรไฟล์พิมพ์ที่ 15 มม. ได้สบาย ส่วนลิงก์ถาวรที่ลึกในขนาดเท่ากันคือสัญลักษณ์ที่แน่นกว่าในพื้นที่เท่าเดิม และนั่นคือจุดที่การสแกนเริ่มล้มเหลว

  • เลือกหน้ารีโพมากกว่าไฟล์ดิบ

    ลิงก์ raw.githubusercontent.com ส่งข้อความล้วนหรือไฟล์ดาวน์โหลดให้มือถือ ส่วนหน้ารีโพเรนเดอร์ README ซึ่งคือสิ่งที่คนสแกนมาเพื่อดู

  • ระบุว่าโค้ดพาไปไหน

    “เฟิร์มแวร์และเอกสาร” หรือ “ซอร์สโค้ดของทอล์กนี้” ข้างโค้ด คือความต่างระหว่างการถูกสแกนกับการถูกยักไหล่ผ่านไป

  • ระวังคอนทราสต์บนสติกเกอร์สีเข้ม

    กล้องมือถือคาดหวังโมดูลสีเข้มบนพื้นสว่าง ถ้าสติกเกอร์ต้องเป็นสีเข้มจริง ๆ ให้ทดสอบเวอร์ชันกลับด้านบนมือถือหลายรุ่นก่อนสั่งผลิต

  • รักษาเขตเงียบรอบโค้ด

    เว้นขอบว่างสี่โมดูลทุกด้าน ซึ่งหายง่ายบนสติกเกอร์เล็ก ๆ ที่อาร์ตเวิร์กลากไปจนถึงเส้นไดคัต

  • กำหนดขนาดตามระยะอ่าน

    ประมาณหนึ่งในสิบของระยะอ่าน ราว 2 ซม. บนสติกเกอร์ติดโน้ตบุ๊ก และราว 20 ซม. บนโปสเตอร์ที่อ่านจากระยะ 2 เมตร

ทำไม QR Code GitHub ของคุณจึงไม่ทำงาน

ในหน้านี้ลวดลายแทบไม่เคยเป็นปัญหา แต่ URL ที่อยู่เบื้องหลังมักเป็น ไม่ว่าจะเพราะสิ่งที่มันชี้ไป หรือเพราะความยาวของมัน

  • สแกนแล้วเจอหน้า 404

    สาเหตุ
    รีโพเป็นแบบส่วนตัว หรือถูกเปลี่ยนชื่อหรือลบ แล้วชื่อเดิมถูกคนอื่นเอาไปใช้ ซึ่งทำให้การเปลี่ยนเส้นทางหายไป
    วิธีแก้
    เปลี่ยนรีโพเป็นสาธารณะ หรือชี้โค้ดไปยังโปรไฟล์หรือหน้าเอกสารสาธารณะแทน สำหรับงานที่พิมพ์จำนวนมาก ให้เข้ารหัสลิงก์เปลี่ยนเส้นทางบนโดเมนของคุณเองเพื่อให้แก้ปลายทางได้ภายหลัง
  • โค้ดสแกนไม่ติดบนสติกเกอร์เล็ก

    สาเหตุ
    สิ่งที่เข้ารหัสคือลิงก์ถาวรที่ลึกหรือเส้นทางไฟล์ที่ยาว สัญลักษณ์จึงมีโมดูลมากเกินกว่าที่สติกเกอร์ 15 มม. จะอ่านออกได้
    วิธีแก้
    ย่อปลายทางลง ไม่ว่าจะเป็นโปรไฟล์ รากของรีโพ หรือ /releases/latest หรือวาง URL สั้นบนโดเมนของคุณไว้หน้าลิงก์ยาว แล้วสร้างโค้ดใหม่
  • สแกนแล้วดาวน์โหลดไฟล์แทนที่จะเปิดหน้าเว็บ

    สาเหตุ
    URL เป็นที่อยู่ raw.githubusercontent.com ซึ่งส่งตัวไฟล์ออกมาแทนหน้าที่ GitHub เรนเดอร์ไว้
    วิธีแก้
    ให้เข้ารหัสที่อยู่ github.com/owner/repo/blob/... แทน เก็บลิงก์ไฟล์ดิบไว้ให้เครื่องจักรใช้ เช่น คอนฟิกที่สคริปต์ไปดึง ไม่ใช่ให้คนที่ถือกล้องใช้
  • โค้ดชี้ไปยังโปรเจกต์เวอร์ชันเก่า

    สาเหตุ
    สิ่งที่เข้ารหัสคือ URL ของรีลีสที่ติดแท็กไว้หรือลิงก์ branch แล้วโปรเจกต์เดินหน้าต่อไป โค้ดกำลังทำตามที่ถูกสั่งไว้เป๊ะ ๆ
    วิธีแก้
    พิมพ์ใหม่โดยชี้ไป /releases/latest สำหรับไฟล์ดาวน์โหลด หรือรากของรีโพสำหรับซอร์สโค้ด ทั้งสองแบบเดินตามโปรเจกต์แทนที่จะตรึงไว้ที่วันที่ทำอาร์ตเวิร์ก

ยังไม่แน่ใจว่าปัญหาอยู่ที่ไฟล์หรือที่งานพิมพ์ใช่ไหม ลองวางภาพที่ส่งออกลงในเครื่องสแกน QR Code ถ้าอ่านได้บนคอมพิวเตอร์แต่อ่านไม่ได้บนกระดาษ แสดงว่าปัญหาเกิดขึ้นหลังจากไฟล์แล้ว

Questions? Answered

QR Code GitHub เก็บที่อยู่ github.com ไม่ว่าจะเป็นโปรไฟล์ รีโพ รีลีส หรือไฟล์ ณ คอมมิตหนึ่ง เมื่อสแกนแล้วหน้านั้นจะเปิดในเบราว์เซอร์บนมือถือ การอ่านรีโพสาธารณะไม่ต้องใช้แอปหรือบัญชี

โปรไฟล์สำหรับนามบัตร github.com/owner/repo/releases/latest สำหรับฮาร์ดแวร์และคู่มือ และลิงก์ถาวรของคอมมิตสำหรับตัวอย่างโค้ด หลีกเลี่ยงลิงก์ branch และเลขเวอร์ชันตายตัวในงานพิมพ์

GitHub เปลี่ยนเส้นทางจากที่อยู่เดิมไปยังที่อยู่ใหม่ โค้ดที่พิมพ์แล้วจึงมักยังใช้ได้ แต่เฉพาะตราบที่ชื่อเดิมยังไม่ถูกจับจอง ถ้ามีคนอื่นลงทะเบียนชื่อนั้น การเปลี่ยนเส้นทางก็จบลง

ได้ แต่ผู้เยี่ยมชมที่ออกจากระบบจะเจอ 404 แทนหน้าขอเข้าสู่ระบบ โค้ดจึงดูพังสำหรับทุกคนนอกองค์กร ให้ชี้งานพิมพ์สาธารณะไปยังหน้าที่เป็นสาธารณะ

เข้ารหัส github.com/owner/repo/releases/latest แล้ว GitHub จะเปลี่ยนเส้นทางไปยังรีลีสล่าสุดที่เผยแพร่ โค้ดที่พิมพ์บนอุปกรณ์หรือคู่มือจึงไม่มีวันระบุเวอร์ชันที่ถูกแทนที่ไปแล้ว

URL โปรไฟล์หรือรีโพ ราว 25 ถึง 40 ตัวอักษร พิมพ์ได้อย่างน่าเชื่อถือตั้งแต่ประมาณ 15 มม. ส่วนลิงก์ถาวรของคอมมิตที่ยาวต้องใช้สัญลักษณ์ใหญ่กว่า ให้เพิ่มพื้นที่หรือย่อปลายทางก่อน

เพราะมันเข้ารหัส URL แบบ raw.githubusercontent.com ซึ่งส่งตัวไฟล์ออกมา ให้ใช้ที่อยู่ github.com/owner/repo/blob/... ถ้าคนคือผู้ที่จะอ่านหน้านั้น ไม่ใช่เครื่องที่มาดึงไฟล์

ได้ ส่งออกเป็น PNG แล้วคอมมิตเหมือนรูปอื่น ๆ คุ้มค่าเป็นพิเศษเมื่อ README อธิบายฮาร์ดแวร์ เพราะของที่พิมพ์กับรีโพจะมีโค้ดเดียวกัน

ใช้ได้ รีโพสาธารณะแสดงผลได้ในเบราว์เซอร์มือถือทุกตัว รวมถึง README ด้วย การมีหรือไม่มีแอปไม่เกี่ยวกับว่าการสแกนจะเปิดหน้าได้หรือไม่

จากตัวโค้ดรู้ไม่ได้ และสถิติทราฟฟิกของ GitHub ก็ครอบคลุมเฉพาะรีโพที่คุณเป็นเจ้าของ การเข้ารหัสลิงก์เปลี่ยนเส้นทางบนโดเมนของคุณเองคือวิธีเดียวที่น่าเชื่อถือในการนับการสแกนจากโปสเตอร์หรืองานพิมพ์ชุดใดชุดหนึ่ง

สำรวจต่อ

หน้าที่ต่อจากหน้านี้ - บริบทเดียวกัน โค้ดชนิดเดียวกัน หรือสิ่งที่ต้องตัดสินใจต่อไป

QR Code Google Docs

เปิดเอกสาร ใบงาน หรือเทมเพลตได้จากหน้ากระดาษที่พิมพ์ออกมา

งานแต่งงาน

โค้ดเดียวบนบัตรเชิญ พาแขกไปที่ฟอร์มตอบรับคำเชิญ กำหนดการและเส้นทาง และอัลบั้มรูปที่แชร์ร่วมกันหลังงาน

โรงเรียนและห้องเรียน

ฟอร์มขออนุญาต จดหมายข่าว ลิงก์ห้องสมุด และผลงานนักเรียน พร้อมขนาดพิมพ์และกฎความเป็นส่วนตัวที่โรงเรียนต้องใช้จริง

QR Code YouTube

พาคนไปที่ช่อง วิดีโอใดวิดีโอหนึ่ง เพลย์ลิสต์ หรือหน้ากดติดตามได้โดยตรง

QR Code LinkedIn

แชร์โปรไฟล์หรือเพจบริษัทบน LinkedIn ของคุณด้วยโค้ดที่กล้องมือถือรุ่นไหนก็อ่านได้

QR Code ฟอร์มออนไลน์

เปิดแบบสอบถาม ใบสมัคร หรือฟอร์มลงทะเบียนได้จากสิ่งพิมพ์ทุกชนิด

ทำไมต้อง KoloQR?

  • สร้าง QR Code สำหรับเว็บไซต์ เมนู Wi-Fi ไฟล์ PDF และนามบัตร
  • ปรับแต่งสี โลโก้ และรูปทรงที่ไม่เหมือนใคร
  • ดาวน์โหลดไฟล์ PNG และ SVG คุณภาพสูง
  • ออกแบบมาเพื่อทั้งงานพิมพ์และงานดิจิทัล
สร้าง QR Code
QR Code สีดำธรรมดาวางข้าง QR Code เดียวกันที่ออกแบบใหม่เป็นทรงกลมด้วยสีของแบรนด์