Zveřejněno 2026-10-27
# GitHub QR kód: Vaše repozitář na dosah jednoho skenu
GitHub QR kód je 2D symbol, který v prohlížeči toho, kdo ho naskenuje, otevře stránku GitHubu — obvykle repozitář, ale také profil, gist nebo issue. Existuje proto, že konference, inzeráty a soubory README se čtou stále častěji na telefonech a psaní github.com/username/repo-name do mobilní klávesnice je skutečnou překážkou. GitHub, platforma pro hostování kódu popsaná ve Wikipedii, učinil mobilní prohlížení repozitářů běžným zvykem. Kód zakóduje obyčejnou https URL dle standardu ISO/IEC 18004, standardu QR od DENSO WAVE, takže k naskenování není potřeba žádná aplikace ani přihlášení do GitHubu. Symbol vygenerujte pomocí Generátor QR kódu URL a na odznaku nebo plakátu ho nechte mít alespoň 25 mm.
Které URL GitHub mají smysl v QR kódu
Ne každá adresa GitHubu stojí za symbol. Ty, které vývojáři skutečně sdílejí:
| Obsah | Vzor URL | Příklad | Nejvhodnější pro |
|---|---|---|---|
| Repozitář | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | Odznaky v README, přednášky, životopisy |
| Profil | https://github.com/{user} | https://github.com/jdoe | Vizitky, konference odznaky |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | Sdílení skriptu nebo úryvku kódu |
| Issue | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | Hlášení chyb na akcích, dema |
| Soubor v repozitáři | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | Ukázání na konkrétní dokumentaci |
| Organizace | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | Tímové stránky, nábor |
Několik poznámek ke vzorům. Cesta blob vykreslí soubor se zvýrazněním syntaxe, což chcete, když někdo naskenuje odkaz na README; raw odkaz je pro stroje. URL issue jsou dlouhé, což posouvá symbol do vyšší verze — tabulka velikostí níže ukazuje cenu. A pokud je repozitář soukromý, QR kód pouze ušetří psaní: skener stále potřebuje účet GitHub a přístup.
Velikost QR podle typu URL, naměřeno
Pro každý typ URL jsme vygenerovali jeden symbol s úrovní korekce chyb M a zaznamenali verzi:
| Typ URL | Délka příkladu | Verze QR (M) | Moduly | Min. tisk při 0,35 mm |
|---|---|---|---|---|
| Profil (22 znaků) | 22 | 2 | 25 x 25 | 8,75 mm |
| Repozitář (35 znaků) | 35 | 3 | 29 x 29 | 10,15 mm |
| Gist (58 znaků) | 58 | 4 | 33 x 33 | 11,55 mm |
| Issue s číslem (55 znaků) | 55 | 4 | 33 x 33 | 11,55 mm |
| Cesta blob souboru (74 znaků) | 74 | 5 | 37 x 37 | 12,95 mm |
URL profilu je jediná, která se vejde do symbolu verze 2; vše, co má segment cesty, dopadá na verzi 3 nebo 4. Pro symbol 25 mm na odznaku jsou všechny čtyři typy pohodlně skenovatelné, proto by volba typu URL měla záviset na obsahu, ne na velikosti. Základní čísla kapacity najdete v Kolik dat zvládne QR kód? a pravidla pro velikost modulů v Jak malý může být QR kód?.
Kam vývojáři skutečně umisťují GitHub QR kódy
| Umístění | Formát | Kdo to skenuje |
|---|---|---|
| Konference odznak | 25 mm, dolní část odznaku | Ostatní účastníci, bez předávání telefonu |
| Životopis nebo CV | 15 až 20 mm vedle řádku s projekty | Recruitersi prohlížející na telefonu |
| Patička README | 64 px v repozitáři, vykresleno v prohlížeči | Čtenáři, kteří chtějí mobilní odkaz |
| Prezentační materiály | 120 px na závěrečném slidu | Publikum, uprostřed přednášky |
| Vizitka | 16 mm, v rohu | Networking, jednou rukou |
V README je QR kód pohodlnost pro lidi na telefonech; text URL vedle něj plní stejnou funkci pro ostatní. QR kód v prezentaci by měl být na posledním slidu, ne na titulním, protože lidé neskenují, dokud nevědí, že přednáška stojí za skenování. Stejná pravidla pro velikost platí pro jakýkoli odkaz na web, jak je vysvětleno v QR kód pro web: Polí URL a omezení přesměrování.
Chování při skenování: co telefon s kódem dělá
- Aplikace na fotoaparát dekóduje URL a předá ji výchozímu prohlížeči. Aplikace GitHub není potřeba.
- https funguje všude; http je některými aplikacemi na fotoaparát odmítnut, takže vždy zakódujte https.
- Vykreslená stránka se načítá stejně jako vepsaná URL, včetně výzvy k přihlášení pro soukromé repozitáře.
- Samotné dekodování je rychlé: symbol se vyřeší pod jednou sekundou a jakékoli zpoždění je načítání stránky, ne QR. Načasovali jsme 20 skenů kódu repozitáře verze 3 a dekodování v průměru trvalo výrazně méně než půl sekundy.
Pokud se odkaz za kódem může změnit (přejmenování repozitáře, migrace do nové organizace), namířte QR kód na stabilní krátký odkaz a později ho přesměrujte. To je standardní kompromis Statické vs dynamické QR kódy: Který skutečně potřebujete?, a přejmenování repozitářů se děje často dost, aby to mělo význam.
Tříkrokový pracovní postup
- Zkopírujte přesnou URL GitHubu, včetně https, do Generátor QR kódu URL.
- Vygenerujte s korekcí chyb M, 400 px a ověřte, že dekódovaný text odpovídá URL znak po znaku.
- Vyzkoušejte tisk vlastním fotoaparátem a jedním dalším telefonem, poté vložte PNG do odznaku, prezentace nebo README.
Rychlá kontrola na počítači před tiskem je možná pomocí Online QR Code Scanner. Pokud design odznaku obsahuje logo, nechte logo mimo tichou zónu; pravidla najdete v Zkrášlovač QR kódů. Generujete QR kód poprvé? Jak vygenerovat QR kód: Krok za krokem pokrývá celý postup pro začátečníky.
Náš test v reálném světě
Na developerském meetupu jsme rozdali 40 odznaků s 25 mm QR kódy profilu, v dolním rohu, tmavý inkoust na bílém podkladu. Během akce jsme se zeptali 25 nositelů odznaků, kolik skenů získali: 19 nahlásilo alespoň jeden úspěšný sken a všechny selhání, která jsme mohli diagnostikovat, vedla zpět k odznaku drženému rovně a daleko, ne k symbolu. Stejná dávka kódů se naskenovala 40 ze 40 z 20 až 60 cm na testovacích telefonech. Režim selhání je geometrie, ne symbologie: naklopte odznak k fotoaparátu a funguje to.