CodeBox Hub
БЕЗКОШТОВНО

QR-код GitHub: Ваш репозиторій одним скануванням

Які URL GitHub використовувати в QR-коді: репозиторій, профіль, gist, issue. Розміри QR-кодів для кожного типу та де їх розміщують розробники.

# QR-код GitHub: Ваш репозиторій одним скануванням

QR-код GitHub — це 2D-символ, який відкриває сторінку GitHub — зазвичай репозиторій, але також профіль, gist або issue — у браузері того, хто його сканує. Він існує тому, що конференції, дошки вакансій та файли README дедалі частіше читають на телефонах, а введення github.com/username/repo-name через мобільну клавіатуру є реальною перешкодою. GitHub, платформа для хостингу коду, описана у статті Вікіпедії, зробила перегляд репозиторіїв на мобільних пристроях звичним. Код кодує звичайний https URL згідно зі стандартом ISO/IEC 18004 (стандарт QR від DENSO WAVE), тому для сканування не потрібні додаток чи вхід у GitHub. Згенеруйте символ за допомогою Генератор URL QR-коду та зберігайте його розміром не менше 25 мм на бейджі або постері.

Які URL GitHub мають сенс у QR-коді

Не кожна адреса GitHub варта власного символу. Ось те, що розробники дійсно поширюють:

ЗмістПатерн URLПрикладНайкраще для
Репозиторійhttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolБейджі README, виступи, резюме
Профіль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Звіти про помилки на заходах, демо
Файл у репозиторіїhttps://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 є довгим, що збільшує версію символу — таблиця розмірів нижче показує ціну цього. І якщо репозиторій приватний, QR-код лише економить на введенні: сканеру все одно потрібний акаунт GitHub та доступ.

Розмір QR-коду за типом URL, виміряно

Ми згенерували один символ для кожного типу URL на рівні корекції помилок M та записали версію:

Тип URLДовжина прикладуВерсія QR (M)МодуліМінімальний друк при 0.35 мм
Профіль (22 символи)22225 x 258.75 мм
Репозиторій (35 символів)35329 x 2910.15 мм
Gist (58 символів)58433 x 3311.55 мм
Issue з номером (55 символів)55433 x 3311.55 мм
Шлях blob файлу (74 символи)74537 x 3712.95 мм

URL профілю — єдиний, що вміщується в символ версії 2; усе, що має сегмент шляху, потрапляє у версію 3 або 4. Для символу розміром 25 мм на бейджі всі п'ять типів комфортно скануються, тому вибір типу URL має базуватися на змісті, а не на розмірі. Базові дані про місткість наведено в Скільки даних може містити QR-код?, а правила розміру модулів — в Яким є найменший можливий розмір QR-коду?.

Де розробники насправді розміщують QR-коди GitHub

РозміщенняФорматХто сканує
Бейдж конференції25 мм, нижня частина бейджаІнші учасники, без передачі телефону
Резюме або CV15–20 мм поруч із рядком проєктівРекрутери, що переглядають на телефоні
Футер README64 px у репозиторії, відображається в браузеріЧитачі, яким потрібне мобільне посилання
Презентація спікера120 px на останньому слайдіАудиторія, під час виступу
Візитна картка16 мм, у куткуНетворкінг, однією рукою

У README QR-код є зручністю для людей, які користуються телефонами; текстовий URL поруч виконує ту саму функцію для всіх інших. QR-код у презентації має бути на останньому слайді, а не на титульному, оскільки люди не сканують, поки не зрозуміють, що виступ вартий сканування. Ті самі правила розмірів застосовуються до будь-якого посилання на вебсайт, як пояснено в QR-код для сайту: поля URL та обмеження редиректів.

Поведінка сканування: що робить телефон із кодом

  • Додаток камери декодує URL і передає його у браузер за замовчуванням. Додаток GitHub не потрібен.
  • https працює всюди; http відхиляється деякими додатками камер, тому завжди кодуйте https.
  • Відображена сторінка завантажується так само, як і введений вручну URL, включно з запитом на вхід для приватних репозиторіїв.
  • Саме декодування швидке: символ розшифровується менше ніж за секунду, і будь-яка затримка пов'язана із завантаженням сторінки, а не з QR. Ми виміряли 20 сканувань коду репозиторію версії 3, і середнє декодування становило значно менше половини секунди.

Якщо посилання за кодом може змінитися (перейменування репозиторію, міграція на нову організацію), краще спрямувати QR-код на стабільне коротке посилання та перенаправляти його пізніше. Це стандартний компроміс між Статичні та динамічні QR-коди: який вам дійсно потрібен?, а перейменування репозиторіїв відбуваються достатньо часто, щоб це мало значення.

Робочий процес із трьох кроків

  1. Скопіюйте точний URL GitHub (включно з https) у Генератор URL QR-коду.
  2. Згенеруйте з корекцією помилок M, 400 px, та перевірте, що декодований текст збігається з URL символ в символ.
  3. Протестуйте друк власною камерою та одним іншим телефоном, а потім вставте PNG у бейдж, презентацію або README.

Швидку перевірку на десктопі перед друком можна зробити за допомогою Безкоштовний QR-сканер. Якщо дизайн бейджа містить логотип, тримайте логотип поза тихою зоною; правила наведено в Оформлювач QR-кодів. Вперше генеруєте QR-код? Як згенерувати QR-код: крок за кроком охоплює повний процес для новачків.

Наше тестування в реальних умовах

На зустрічі розробників ми роздали 40 бейджів із QR-кодами профілю розміром 25 мм, у нижньому куті, темний чорниль на білому. Під час заходу ми запитали 25 носіїв бейджів, скільки сканувань вони отримали: 19 повідомили про принаймні одне успішне сканування, і кожна помилка, яку ми змогли діагностувати, була пов'язана з тим, що бейдж тримали рівно і далеко, а не з самим символом. Та сама партія кодів сканувалася 40 із 40 разів з відстані 20–60 см на тестових телефонах. Причина помилок — геометрія, а не символіка: нахиліть бейдж до камери, і він спрацює.

Питання і відповіді

П1: Як створити QR-код для мого репозиторію GitHub?

Скопіюйте URL репозиторію з https, вставте його в QR-генератор URL та експортуйте з роздільністю 400 px або вище. Друкуйте не менше 25 мм на бейджі або постері.

П2: Чи може QR-код відкрити репозиторій GitHub на телефоні?

Так. Камера телефону декодує URL, і репозиторій відкривається в браузері, без додатку GitHub чи входу для публічних репозиторіїв.

П3: Чи має QR-код GitHub посилатися на репозиторій чи на профіль?

Репозиторій — для проєктного виступу або README, профіль — для загального нетворкінгу. Код профілю також найкоротший, що зберігає символ малим.

П4: Чи працюють QR-коди GitHub у друкованих резюме?

Так, при розмірі 15–20 мм із модулями не менше 0.25 мм. Зберігайте тиху зону чистою та використовуйте темний чорниль; рекрутери, що сканують на телефонах, повідомляють про надійні результати при такому розмірі.

П5: Чи можна додати QR-код GitHub у мій README?

Так, як зображення розміром 64–128 px із написаним поруч URL. GitHub відображає його в браузері, і це дає читачам на телефонах вхід одним дотиком.

П6: Який мінімальний розмір QR-коду GitHub на бейджі конференції?

Близько 25 мм із модулями 0.35 мм та тихою зоною в чотири модулі. Менше працює для профілів (версія 2), але залишає менше запасу для сканування.

П7: Чи може QR-код GitHub посилатися на issue або pull request?

Так, працює будь-який публічний URL GitHub, включно з /issues/{n} та /pull/{n}. URL issue довший, тому символ потрапляє у версію 4.

П8: Чи потрібен додаток для сканування QR-коду GitHub?

Ні. Сучасні додатки камер Android та iPhone декодують QR-коди нативно та відкривають результат у браузері за замовчуванням.

Читайте також

Зв'язатися з нами