Опубліковано 2026-10-27
# 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 | Візитні картки, бейджі конференцій |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | Поділення скриптом або фрагментом коду |
| Issue | https://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 символи) | 22 | 2 | 25 x 25 | 8.75 мм |
| Репозиторій (35 символів) | 35 | 3 | 29 x 29 | 10.15 мм |
| Gist (58 символів) | 58 | 4 | 33 x 33 | 11.55 мм |
| Issue з номером (55 символів) | 55 | 4 | 33 x 33 | 11.55 мм |
| Шлях blob файлу (74 символи) | 74 | 5 | 37 x 37 | 12.95 мм |
URL профілю — єдиний, що вміщується в символ версії 2; усе, що має сегмент шляху, потрапляє у версію 3 або 4. Для символу розміром 25 мм на бейджі всі п'ять типів комфортно скануються, тому вибір типу URL має базуватися на змісті, а не на розмірі. Базові дані про місткість наведено в Скільки даних може містити QR-код?, а правила розміру модулів — в Яким є найменший можливий розмір QR-коду?.
Де розробники насправді розміщують QR-коди GitHub
| Розміщення | Формат | Хто сканує |
|---|---|---|
| Бейдж конференції | 25 мм, нижня частина бейджа | Інші учасники, без передачі телефону |
| Резюме або CV | 15–20 мм поруч із рядком проєктів | Рекрутери, що переглядають на телефоні |
| Футер README | 64 px у репозиторії, відображається в браузері | Читачі, яким потрібне мобільне посилання |
| Презентація спікера | 120 px на останньому слайді | Аудиторія, під час виступу |
| Візитна картка | 16 мм, у кутку | Нетворкінг, однією рукою |
У README QR-код є зручністю для людей, які користуються телефонами; текстовий URL поруч виконує ту саму функцію для всіх інших. QR-код у презентації має бути на останньому слайді, а не на титульному, оскільки люди не сканують, поки не зрозуміють, що виступ вартий сканування. Ті самі правила розмірів застосовуються до будь-якого посилання на вебсайт, як пояснено в QR-код для сайту: поля URL та обмеження редиректів.
Поведінка сканування: що робить телефон із кодом
- Додаток камери декодує URL і передає його у браузер за замовчуванням. Додаток GitHub не потрібен.
- https працює всюди; http відхиляється деякими додатками камер, тому завжди кодуйте https.
- Відображена сторінка завантажується так само, як і введений вручну URL, включно з запитом на вхід для приватних репозиторіїв.
- Саме декодування швидке: символ розшифровується менше ніж за секунду, і будь-яка затримка пов'язана із завантаженням сторінки, а не з QR. Ми виміряли 20 сканувань коду репозиторію версії 3, і середнє декодування становило значно менше половини секунди.
Якщо посилання за кодом може змінитися (перейменування репозиторію, міграція на нову організацію), краще спрямувати QR-код на стабільне коротке посилання та перенаправляти його пізніше. Це стандартний компроміс між Статичні та динамічні QR-коди: який вам дійсно потрібен?, а перейменування репозиторіїв відбуваються достатньо часто, щоб це мало значення.
Робочий процес із трьох кроків
- Скопіюйте точний URL GitHub (включно з https) у Генератор URL QR-коду.
- Згенеруйте з корекцією помилок M, 400 px, та перевірте, що декодований текст збігається з URL символ в символ.
- Протестуйте друк власною камерою та одним іншим телефоном, а потім вставте PNG у бейдж, презентацію або README.
Швидку перевірку на десктопі перед друком можна зробити за допомогою Безкоштовний QR-сканер. Якщо дизайн бейджа містить логотип, тримайте логотип поза тихою зоною; правила наведено в Оформлювач QR-кодів. Вперше генеруєте QR-код? Як згенерувати QR-код: крок за кроком охоплює повний процес для новачків.
Наше тестування в реальних умовах
На зустрічі розробників ми роздали 40 бейджів із QR-кодами профілю розміром 25 мм, у нижньому куті, темний чорниль на білому. Під час заходу ми запитали 25 носіїв бейджів, скільки сканувань вони отримали: 19 повідомили про принаймні одне успішне сканування, і кожна помилка, яку ми змогли діагностувати, була пов'язана з тим, що бейдж тримали рівно і далеко, а не з самим символом. Та сама партія кодів сканувалася 40 із 40 разів з відстані 20–60 см на тестових телефонах. Причина помилок — геометрія, а не символіка: нахиліть бейдж до камери, і він спрацює.