Opublikowano 2026-10-28
# Kod QR GitHub: Umieść swoje repozytorium w jednym skanie
Kod QR GitHub to symbol 2D, który otwiera stronę GitHuba — zwykle repozytorium, ale także profil, gist lub problem — w przeglądarce osoby, która go zeskanuje. Istnieje, ponieważ konferencje, tablice z ofertami pracy i pliki README są coraz częściej czytane na telefonach, a wpisywanie github.com/username/repo-name na klawiaturze mobilnej to realna bariera. GitHub, platforma do hostowania kodu opisana w artykule Wikipedii, uczynił przeglądanie repozytoriów na urządzeniach mobilnych normalnym nawykiem. Kod zakodowuje zwykły adres URL https zgodnie z ISO/IEC 18004, standardem QR od DENSO WAVE, więc do jego zeskanowania nie jest wymagana żadna aplikacja ani logowanie do GitHuba. Wygeneruj symbol za pomocą Generator kodów QR dla URL i utrzymaj go w rozmiarze co najmniej 25 mm na odznace lub plakacie.
Które adresy URL GitHuba mają sens w kodzie QR
Nie każdy adres GitHuba jest wart symbolu. Te, które programiści faktycznie udostępniają:
| Zawartość | Wzorzec URL | Przykład | Najlepsze do |
|---|---|---|---|
| Repozytorium | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | Odznaki README, prelekcje, CV |
| Profil | https://github.com/{user} | https://github.com/jdoe | Wizytówki, odznaki konferencyjne |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | Udostępnianie skryptu lub fragmentu kodu |
| Problem | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | Zgłaszanie błędów na eventach, dema |
| Plik w repozytorium | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | Wskazywanie na konkretne dokumenty |
| Organizacja | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | Strony zespołów, rekrutacja |
Kilka uwag dotyczących wzorców. Ścieżka blob renderuje plik z podświetlaniem składni, co jest pożądane, gdy ktoś skanuje odniesienie do README; link raw jest przeznaczony dla maszyn. Adresy URL problemów są długie, co podnosi wersję symbolu — poniższa tabela rozmiarów pokazuje koszt. A jeśli repozytorium jest prywatne, kod QR oszczędza jedynie wpisywanie: skaner nadal wymaga konta GitHuba i dostępu.
Rozmiar QR dla każdego typu URL, zmierzony
Wygenerowaliśmy jeden symbol dla każdego typu URL przy poziomie korekcji błędów M i zarejestrowaliśmy wersję:
| Typ URL | Przykładowa długość | Wersja QR (M) | Moduły | Min. wydruk przy 0,35 mm |
|---|---|---|---|---|
| Profil (22 znaki) | 22 | 2 | 25 x 25 | 8,75 mm |
| Repozytorium (35 znaków) | 35 | 3 | 29 x 29 | 10,15 mm |
| Gist (58 znaków) | 58 | 4 | 33 x 33 | 11,55 mm |
| Problem z numerem (55 znaków) | 55 | 4 | 33 x 33 | 11,55 mm |
| Ścieżka blob pliku (74 znaki) | 74 | 5 | 37 x 37 | 12,95 mm |
Adres URL profilu to jedyny, który mieści się w symbolu wersji 2; wszystko, co ma segment ścieżki, ląduje w wersji 3 lub 4. Dla symbolu o rozmiarze 25 mm na odznace, wszystkie pięć typów jest wygodnie skanowalnych, dlatego wybór typu URL powinien dotyczyć zawartości, a nie rozmiaru. Podstawowe dane dotyczące pojemności znajdują się w Ile danych może pomieścić kod QR?, a zasady dotyczące rozmiaru modułów w Jaki jest najmniejszy możliwy rozmiar kodu QR?.
Gdzie programiści faktycznie umieszczają kody QR GitHub
| Umiejscowienie | Format | Kto skanuje |
|---|---|---|
| Odznaka konferencyjna | 25 mm, dolna część odznaki | Inni uczestnicy, bez przekazywania telefonu |
| CV lub życiorys | 15–20 mm obok linii z projektami | Rekruterzy przeglądający na telefonie |
| Stopka README | 64 px w repozytorium, renderowane w przeglądarce | Czytelnicy, którzy chcą linku mobilnego |
| Slajdy prelegenta | 120 px na slajdzie końcowym | Publiczność, w trakcie prelekcji |
| Wizytówka | 16 mm, w rogu | Networking, jedną ręką |
W pliku README kod QR to wygoda dla osób korzystających z telefonów; tekst URL obok niego wykonuje tę samą pracę dla wszystkich pozostałych. Kod QR w prezentacji powinien znajdować się na ostatnim slajdzie, a nie na slajdzie tytułowym, ponieważ ludzie nie skanują, zanim nie wiedzą, że prelekcja jest warta skanowania. Te same zasady dotyczące rozmiaru dotyczą dowolnego linku do strony internetowej, jak wyjaśniono w Kod QR dla strony internetowej: Pola URL i limity przekierowań.
Zachowanie przy skanowaniu: co telefon robi z kodem
- Aplikacja aparatu dekoduje URL i przekazuje go do domyślnej przeglądarki. Nie jest wymagana aplikacja GitHub.
- https działa wszędzie; http jest odrzucany przez niektóre aplikacje aparatu, więc zawsze koduj https.
- Wyrenderowana strona ładuje się tak samo jak wpisany URL, w tym z promptem logowania dla prywatnych repozytoriów.
- Samo dekodowanie jest szybkie: symbol rozwiązuje się w mniej niż sekundę, a wszelkie opóźnienie to ładowanie strony, nie QR. Zmierzyliśmy 20 skanów kodu repozytorium wersji 3 i średni czas dekodowania wynosił znacznie mniej niż pół sekundy.
Jeśli link za kodem może się zmienić (zmiana nazwy repozytorium, migracja do nowej organizacji), skieruj QR na stabilny krótki link i przekieruj go później. To standardowy kompromis Statyczne a dynamiczne kody QR: Który naprawdę potrzebujesz?, a zmiany nazw repozytoriów występują często na tyle, by miały znaczenie.
Trzyetapowy proces
- Skopiuj dokładny adres URL GitHuba, w tym https, do Generator kodów QR dla URL.
- Wygeneruj z korekcją błędów M, 400 px i zweryfikuj, czy zdekodowany tekst odpowiada URL znak w znak.
- Przetestuj wydruk własnym aparatem i jednym innym telefonem, a następnie wstaw plik PNG do odznaki, prezentacji lub README.
Szybka weryfikacja na komputerze przed wydrukiem jest możliwa za pomocą Darmowy skaner kodów QR. Jeśli projekt odznaki zawiera logo, trzymaj logo z dala od strefy cichej; zasady znajdują się w Piękniarka kodów QR. Pierwszy raz generujesz QR? Jak wygenerować kod QR: Krok po kroku obejmuje pełny proces dla początkujących.
Nasz test w warunkach rzeczywistych
Na spotkaniu deweloperskim rozdaliśmy 40 odznak z 25 mm kodami QR profilu, w dolnym rogu, ciemny tusz na białym tle. W trakcie eventu zapytaliśmy 25 nosicieli odznak, ile skanów otrzymali: 19 zgłosiło co najmniej jeden udany skan, a każda awaria, którą mogliśmy zdiagnozować, wynikała z trzymania odznaki płasko i daleko, a nie z samego symbolu. Ta sama partia kodów została zeskanowana 40 z 40 razy w odległości od 20 do 60 cm na testowych telefonach. Tryb awarii to geometria, nie symbologia: pochyl odznakę w stronę aparatu i zadziała.