CodeBox Hub
ZA DARMO

Kod QR GitHub: Umieść swoje repozytorium w jednym skanie

Który adres URL GitHuba umieścić w kodzie QR: wzorce dla repozytoriów, profili, gistów i problemów, zmierzone rozmiary oraz miejsca ich stosowania.

# 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 URLPrzykładNajlepsze do
Repozytoriumhttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolOdznaki README, prelekcje, CV
Profilhttps://github.com/{user}https://github.com/jdoeWizytówki, odznaki konferencyjne
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cUdostępnianie skryptu lub fragmentu kodu
Problemhttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142Zgłaszanie błędów na eventach, dema
Plik w repozytoriumhttps://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mdWskazywanie na konkretne dokumenty
Organizacjahttps://github.com/orgs/{org}https://github.com/orgs/acme-devStrony 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 URLPrzykładowa długośćWersja QR (M)ModułyMin. wydruk przy 0,35 mm
Profil (22 znaki)22225 x 258,75 mm
Repozytorium (35 znaków)35329 x 2910,15 mm
Gist (58 znaków)58433 x 3311,55 mm
Problem z numerem (55 znaków)55433 x 3311,55 mm
Ścieżka blob pliku (74 znaki)74537 x 3712,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

UmiejscowienieFormatKto skanuje
Odznaka konferencyjna25 mm, dolna część odznakiInni uczestnicy, bez przekazywania telefonu
CV lub życiorys15–20 mm obok linii z projektamiRekruterzy przeglądający na telefonie
Stopka README64 px w repozytorium, renderowane w przeglądarceCzytelnicy, którzy chcą linku mobilnego
Slajdy prelegenta120 px na slajdzie końcowymPubliczność, w trakcie prelekcji
Wizytówka16 mm, w roguNetworking, 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

  1. Skopiuj dokładny adres URL GitHuba, w tym https, do Generator kodów QR dla URL.
  2. Wygeneruj z korekcją błędów M, 400 px i zweryfikuj, czy zdekodowany tekst odpowiada URL znak w znak.
  3. 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.

Najczęstsze pytania

Jak zrobić kod QR dla mojego repozytorium GitHub?

Skopiuj adres URL repozytorium z https, wklej go do generatora QR dla URL i wyeksportuj w rozdzielczości 400 px lub wyższej. Wydrukuj co najmniej 25 mm na odznace lub plakacie.

Czy kod QR może otworzyć repozytorium GitHub na telefonie?

Tak. Aparat telefonu dekoduje URL i repozytorium otwiera się w przeglądarce, bez potrzeby aplikacji GitHub lub logowania dla publicznych repozytoriów.

Czy kod QR GitHub powinien linkować do repozytorium czy profilu?

Repozytorium dla prelekcji o projekcie lub README, profil do ogólnego networkingu. Kod profilu jest również najkrótszy, co utrzymuje symbol mały.

Czy kody QR GitHub działają w wydrukowanych CV?

Tak, w rozmiarze 15–20 mm z modułami co najmniej 0,25 mm. Zachowaj strefę cichą czystą i używaj ciemnego tuszu; rekruterzy skanujący na telefonach raportują niezawodne wyniki w tym rozmiarze.

Czy mogę umieścić kod QR GitHub w moim README?

Tak, jako obraz o rozmiarze 64–128 px z URL napisanym obok. GitHub renderuje go w przeglądarce, a czytelnikom na telefonach daje wejście jednym dotknięciem.

Jaki jest minimalny rozmiar kodu QR GitHub na odznace konferencyjnej?

Około 25 mm z modułami 0,35 mm i strefą cichą o szerokości czterech modułów. Mniejszy rozmiar działa dla profili (wersja 2), ale daje mniejszy margines skanowania.

Czy kod QR GitHub może linkować do problemu lub pull requesta?

Tak, każdy publiczny adres URL GitHuba działa, w tym /issues/{n} i /pull/{n}. Adresy URL problemów są dłuższe, więc symbol ląduje w wersji 4.

Czy potrzebuję aplikacji, aby zeskanować kod QR GitHub?

Nie. Nowoczesne aplikacje aparatu na Androidzie i iPhone dekodują kody QR natywnie i otwierają wynik w domyślnej przeglądarce.

Czytaj dalej

Skontaktuj się z nami