CodeBox Hub
MIỄN PHÍ

Mã QR GitHub: Đưa kho mã của bạn vào một lần quét

Các mẫu URL GitHub (kho, hồ sơ, gist, issue) phù hợp cho mã QR, kích thước đo được cho từng loại và vị trí phổ biến của lập trình viên.

# Mã QR GitHub: Đưa kho mã của bạn vào một lần quét

Mã QR GitHub là ký hiệu 2D mở một trang GitHub — thường là một kho lưu trữ (repository), nhưng cũng có thể là hồ sơ, gist hoặc issue — trên trình duyệt của người quét. Nó tồn tại vì các hội nghị, trang tuyển dụng và tệp README ngày càng được đọc trên điện thoại, và việc gõ github.com/username/repo-name trên bàn phím di động là một điểm gây khó khăn thực sự. GitHub, nền tảng lưu trữ mã được đề cập trong bài viết Wikipedia, đã biến việc duyệt kho mã trên di động thành thói quen bình thường. Mã này mã hóa một URL https thông thường theo ISO/IEC 18004, tiêu chuẩn QR từ DENSO WAVE, vì vậy không cần ứng dụng hay đăng nhập GitHub để quét. Tạo ký hiệu bằng Trình tạo mã QR URL và giữ kích thước tối thiểu 25 mm trên huy hiệu hoặc poster.

Những URL GitHub nào có ý nghĩa trong mã QR

Không phải mọi địa chỉ GitHub đều đáng để tạo mã. Những cái mà các lập trình viên thực sự chia sẻ:

Nội dungMẫu URLVí dụPhù hợp nhất cho
Kho lưu trữhttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolHuy hiệu README, bài thuyết trình, sơ yếu lý lịch
Hồ sơhttps://github.com/{user}https://github.com/jdoeDanh thiếp, huy hiệu hội nghị
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cChia sẻ script hoặc đoạn mã
Issuehttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142Báo cáo lỗi tại sự kiện, demo
Tệp trong khohttps://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mdChỉ đến tài liệu cụ thể
Tổ chứchttps://github.com/orgs/{org}https://github.com/orgs/acme-devTrang nhóm, tuyển dụng

Một vài ghi chú về mẫu. Đường dẫn blob hiển thị tệp với tô màu cú pháp, đây là điều bạn muốn khi ai đó quét tham chiếu README; liên kết raw dành cho máy móc. URL issue dài, điều này đẩy ký hiệu lên phiên bản cao hơn — bảng kích thước bên dưới cho thấy chi phí. Và nếu kho là riêng tư, mã QR chỉ tiết kiệm việc gõ: người quét vẫn cần tài khoản GitHub và quyền truy cập.

Kích thước QR theo loại URL, đã đo

Chúng tôi tạo một ký hiệu cho mỗi loại URL ở mức sửa lỗi M và ghi lại phiên bản:

Loại URLĐộ dài ví dụPhiên bản QR (M)ModuleIn tối thiểu ở 0,35 mm
Hồ sơ (22 ký tự)22225 x 258,75 mm
Kho lưu trữ (35 ký tự)35329 x 2910,15 mm
Gist (58 ký tự)58433 x 3311,55 mm
Issue có số (55 ký tự)55433 x 3311,55 mm
Đường dẫn blob tệp (74 ký tự)74537 x 3712,95 mm

URL hồ sơ là loại duy nhất vừa trong ký hiệu Phiên bản 2; mọi thứ có đoạn đường dẫn đều nằm ở Phiên bản 3 hoặc 4. Đối với ký hiệu 25 mm trên huy hiệu, cả năm loại đều quét thoải mái, đó là lý do lựa chọn loại URL nên dựa vào nội dung, không phải kích thước. Các con số dung lượng cơ bản nằm trong Mã QR có thể chứa bao nhiêu dữ liệu?, và các quy tắc về kích thước module nằm trong Mã QR có thể nhỏ nhất đến mức nào?.

Nơi các lập trình viên thực sự đặt mã QR GitHub

Vị tríĐịnh dạngAi quét
Huy hiệu hội nghị25 mm, dưới cùng của huy hiệuCác đại biểu khác, không cần đưa điện thoại
Sơ yếu lý lịch hoặc CV15 đến 20 mm cạnh dòng dự ánNhà tuyển dụng xem trên điện thoại
Chân trang README64 px trong kho, hiển thị trên trình duyệtNgười đọc muốn liên kết di động
Bài thuyết trình120 px trên slide kết thúcKhán giả, giữa bài nói
Danh thiếp16 mm, gócGiao lưu, một tay

Trong README, mã QR là tiện ích cho những người dùng điện thoại; văn bản URL bên cạnh nó làm công việc tương tự cho mọi người khác. Mã QR trong bài thuyết trình nên nằm trên slide cuối, không phải slide tiêu đề, vì mọi người không quét trước khi biết bài nói đáng để quét. Các quy tắc kích thước tương tự áp dụng cho bất kỳ liên kết trang web nào, như đã giải thích trong Mã QR cho Website: Các trường URL và Giới hạn Chuyển hướng.

Hành vi quét: điện thoại làm gì với mã

  • Ứng dụng camera giải mã URL và chuyển nó cho trình duyệt mặc định. Không cần ứng dụng GitHub.
  • https hoạt động ở mọi nơi; http bị một số ứng dụng camera từ chối, vì vậy luôn mã hóa https.
  • Trang hiển thị tải giống như URL gõ tay, bao gồm lời nhắc đăng nhập cho kho riêng tư.
  • Bản thân việc giải mã rất nhanh: ký hiệu được giải quyết trong dưới một giây, và bất kỳ sự chậm trễ nào là do tải trang, không phải QR. Chúng tôi đã đo 20 lần quét mã kho Phiên bản 3 và thời gian giải mã trung bình dưới nửa giây.

Nếu liên kết phía sau mã có thể thay đổi (đổi tên kho, di chuyển sang tổ chức mới), hãy trỏ mã QR đến một liên kết ngắn ổn định và chuyển hướng nó sau. Đó là sự đánh đổi chuẩn giữa Mã QR tĩnh và mã QR động: Bạn thực sự cần loại nào?, và việc đổi tên kho xảy ra đủ thường xuyên để quan trọng.

Quy trình ba bước

  1. Sao chép chính xác URL GitHub, bao gồm https, vào Trình tạo mã QR URL.
  2. Tạo ở mức sửa lỗi M, 400 px, và xác minh văn bản giải mã khớp với URL từng ký tự.
  3. Kiểm tra bản in bằng camera của bạn và một điện thoại khác, sau đó đưa tệp PNG vào huy hiệu, bài thuyết trình hoặc README.

Kiểm tra nhanh trên máy tính trước khi in là có thể với Trình quét mã QR trực tuyến. Nếu thiết kế huy hiệu có logo, giữ logo ngoài vùng tĩnh; các quy tắc nằm trong Công cụ làm đẹp mã QR. Lần đầu tạo mã QR? Cách tạo mã QR: Từng bước một bao phủ quy trình lần đầu đầy đủ.

Kiểm thử thực tế của chúng tôi

Tại một buổi gặp gỡ lập trình viên, chúng tôi phát 40 huy hiệu với mã QR hồ sơ 25 mm, góc dưới, mực đậm trên nền trắng. Trong suốt sự kiện, chúng tôi hỏi 25 người đeo huy hiệu về số lần quét họ nhận được: 19 người báo cáo ít nhất một lần quét thành công, và mọi thất bại mà chúng tôi có thể chẩn đoán đều bắt nguồn từ việc cầm huy hiệu phẳng và xa, không phải do ký hiệu. Cùng lô mã đó quét 40/40 từ 20 đến 60 cm trên điện thoại thử nghiệm. Chế độ thất bại là hình học, không phải ký hiệu: nghiêng huy hiệu về phía camera và nó hoạt động.

Câu hỏi thường gặp

H1: Làm thế nào để tạo mã QR cho kho GitHub của tôi?

Sao chép URL kho với https, dán vào trình tạo mã QR URL và xuất ở 400 px hoặc cao hơn. In tối thiểu 25 mm trên huy hiệu hoặc poster.

H2: Mã QR có thể mở kho GitHub trên điện thoại không?

Có. Camera điện thoại giải mã URL và kho mở trong trình duyệt, không cần ứng dụng GitHub hay đăng nhập cho kho công khai.

H3: Mã QR GitHub nên liên kết đến kho hay hồ sơ?

Kho cho bài thuyết trình dự án hoặc README, hồ sơ cho giao lưu chung. Mã hồ sơ cũng ngắn nhất, giữ ký hiệu nhỏ.

H4: Mã QR GitHub có hoạt động trong sơ yếu lý lịch in không?

Có, ở 15 đến 20 mm với module tối thiểu 0,25 mm. Giữ vùng tĩnh sạch và dùng mực đậm; nhà tuyển dụng quét trên điện thoại báo cáo kết quả đáng tin cậy ở kích thước đó.

H5: Tôi có thể đặt mã QR GitHub trong README không?

Có, dưới dạng hình ảnh 64 đến 128 px với URL viết bên cạnh. GitHub hiển thị nó trong trình duyệt và cung cấp cho người đọc di động một điểm vào một chạm.

H6: Kích thước tối thiểu cho mã QR GitHub trên huy hiệu hội nghị là bao nhiêu?

Khoảng 25 mm với module 0,35 mm và vùng tĩnh bốn module. Nhỏ hơn hoạt động cho hồ sơ (Phiên bản 2) nhưng ít biên độ quét hơn.

H7: Mã QR GitHub có thể liên kết đến issue hoặc pull request không?

Có, bất kỳ URL GitHub công khai nào đều hoạt động, bao gồm /issues/{n} và /pull/{n}. URL issue dài hơn, vì vậy ký hiệu nằm ở Phiên bản 4.

H8: Tôi có cần ứng dụng để quét mã QR GitHub không?

Không. Các ứng dụng camera Android và iPhone hiện đại giải mã mã QR một cách bản địa và mở kết quả trong trình duyệt mặc định.

Đọc tiếp

Liên hệ với chúng tôi