CodeBox Hub
ZDARMA

GitHub QR kód: Vaše repozitář na dosah jednoho skenu

Které URL GitHub patří do QR kódu: vzory pro repozitář, profil, gist a issue, naměřené velikosti a místa, kam je vývojáři umisťují.

# 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í:

ObsahVzor URLPříkladNejvhodnější pro
Repozitářhttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolOdznaky v README, přednášky, životopisy
Profilhttps://github.com/{user}https://github.com/jdoeVizitky, konference odznaky
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cSdílení skriptu nebo úryvku kódu
Issuehttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142Hlášení chyb na akcích, dema
Soubor v repozitářihttps://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mdUkázání na konkrétní dokumentaci
Organizacehttps://github.com/orgs/{org}https://github.com/orgs/acme-devTí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 URLDélka příkladuVerze QR (M)ModulyMin. tisk při 0,35 mm
Profil (22 znaků)22225 x 258,75 mm
Repozitář (35 znaků)35329 x 2910,15 mm
Gist (58 znaků)58433 x 3311,55 mm
Issue s číslem (55 znaků)55433 x 3311,55 mm
Cesta blob souboru (74 znaků)74537 x 3712,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átKdo to skenuje
Konference odznak25 mm, dolní část odznakuOstatní účastníci, bez předávání telefonu
Životopis nebo CV15 až 20 mm vedle řádku s projektyRecruitersi prohlížející na telefonu
Patička README64 px v repozitáři, vykresleno v prohlížečiČtenáři, kteří chtějí mobilní odkaz
Prezentační materiály120 px na závěrečném sliduPublikum, uprostřed přednášky
Vizitka16 mm, v rohuNetworking, 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

  1. Zkopírujte přesnou URL GitHubu, včetně https, do Generátor QR kódu URL.
  2. Vygenerujte s korekcí chyb M, 400 px a ověřte, že dekódovaný text odpovídá URL znak po znaku.
  3. 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.

Časté otázky

Jak vytvořím QR kód pro svůj GitHub repozitář?

Zkopírujte URL repozitáře s https, vložte ji do QR generátoru URL a exportujte ve 400 px nebo vyšším rozlišení. Tiskněte alespoň 25 mm na odznak nebo plakát.

Může QR kód otevřít GitHub repozitář na telefonu?

Ano. Fotoaparát telefonu dekóduje URL a repozitář se otevře v prohlížeči, pro veřejné repozitáře není potřeba aplikace GitHub ani přihlášení.

Měl by GitHub QR odkazovat na repozitář nebo na profil?

Repozitář pro projektovou přednášku nebo README, profil pro obecný networking. Kód profilu je také nejkratší, což drží symbol malý.

Fungují GitHub QR kódy v tištěných životopisech?

Ano, při 15 až 20 mm s moduly alespoň 0,25 mm. Nechte tichou zónu volnou a použijte tmavý inkoust; recruitersi skenující na telefonech hlásí spolehlivé výsledky při této velikosti.

Mohu dát GitHub QR kód do svého README?

Ano, jako obrázek 64 až 128 px s URL napsanou vedle. GitHub ho vykreslí v prohlížeči a poskytne čtenářům na telefonech vstup jedním dotykem.

Jaká je minimální velikost GitHub QR kódu na konference odznak?

Přibližně 25 mm s moduly 0,35 mm a tichou zónou čtyř modulů. Menší funguje pro profily (verze 2), ale nabízí menší rezervu pro skenování.

Může GitHub QR kód odkazovat na issue nebo pull request?

Ano, funguje jakákoli veřejná URL GitHubu, včetně /issues/{n} a /pull/{n}. URL issue jsou delší, takže symbol dopadá na verzi 4.

Potřebuji aplikaci ke skenování GitHub QR kódu?

Ne. Moderní aplikace na fotoaparát pro Android a iPhone dekódují QR kódy nativně a otevřou výsledek ve výchozím prohlížeči.

Čtěte také

Kontaktujte nás