CodeBox Hub
INGYENES

GitHub QR kód: Hozzákösd a repódet egyetlen beolvasással

Melyik GitHub URL illik QR kódba: repo, profil, gist és issue minták, a méreteink, és hol használják a fejlesztők.

# GitHub QR kód: Hozzákösd a repódet egyetlen beolvasással

A GitHub QR kód egy 2D szimbólum, amely megnyit egy GitHub oldalt – általában egy repozitóriumot, de lehet profil, gist vagy issue is – a beolvasó böngészőjében. Annak létezik, hogy a konferenciákon, álláshirdetéseken és a README fájlokat egyre inkább telefonon olvassák, és a github.com/username/repo-name beütése mobil billentyűzeten valódi akadályt jelent. A GitHub, a Wikipédia szócikkben ismertetett kódmegosztó platform, a repozitóriumok mobil böngészését megszokott gyakorlattá tette. A kód egy szokványos https URL-t kódol az ISO/IEC 18004 szerint, a DENSO WAVE QR szabványa szerint, így a beolvasáshoz nem szükséges alkalmazás, sem GitHub bejelentkezés. A szimbólumot a Online URL QR kód generátor állíthatod elő, és legalább 25 mm-es méretben tartsd meg egy jelvényen vagy plakáton.

Melyik GitHub URL-ek éri meg QR kód formában

Nem minden GitHub cím éri meg egy szimbólumot. Azok, amelyeket a fejlesztők valójában megosztanak:

TartalomURL mintaPéldaLegjobb erre
Repozitóriumhttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolREADME jelvények, előadások, önéletrajzok
Profilhttps://github.com/{user}https://github.com/jdoeNévjegyek, konferencia jelvények
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cSzkript vagy kódrészlet megosztása
Issuehttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142Hibajelentések eseményeken, demók
Fájl a repóbanhttps://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mdKonkrét dokumentumokra mutató link
Szervezethttps://github.com/orgs/{org}https://github.com/orgs/acme-devCsapatoldalak, toborzás

Néhány megjegyzés a mintákról. A blob útvonal a fájlt szintaktikai kiemeléssel jeleníti meg, ami az, amit akarsz, ha valaki beolvas egy README hivatkozást; a nyers link gépeknek szól. Az issue URL-ek hosszúak, ami magasabb verzióra emeli a szimbólumot – az alábbi mérettáblázat mutatja a költséget. És ha a repo privát, a QR csak a gépelést spórolja meg: a beolvasóhoz továbbra is GitHub fiók és hozzáférés szükséges.

QR méret URL típusonként, mérve

Egy szimbólumot generáltunk minden URL típusra M hibajavítási szinten, és rögzítettük a verziót:

URL típusPélda hosszaQR verzió (M)ModulokMin. nyomtatás 0,35 mm-en
Profil (22 karakter)22225 x 258,75 mm
Repozitórium (35 karakter)35329 x 2910,15 mm
Gist (58 karakter)58433 x 3311,55 mm
Issue számmal (55 karakter)55433 x 3311,55 mm
Fájl blob útvonal (74 karakter)74537 x 3712,95 mm

A profil URL az egyetlen, amely illeszkedik egy 2. verziójú szimbólumba; minden, ami útvonali szegmennyel rendelkezik, 3. vagy 4. verzióra kerül. Egy 25 mm-es jelvényen lévő szimbólumnál mind az öt típus kényelmesen beolvasható, ezért az URL típus választásának a tartalomról kell szólnia, nem a méretről. Az alapvető kapacitás számok a Mennyi adat fér egy QR kódba? oldalon találhatók, a modulméret szabályok pedig a Mekkora lehet a legkisebb QR-kód? oldalon.

Hol használják a fejlesztők valójában a GitHub QR kódokat

ElhelyezésFormátumKi olvassa be
Konferencia jelvény25 mm, a jelvény aljánEgyéb résztvevők, telefon átkötés nélkül
Önéletrajz vagy CV15–20 mm a projektek sor mellettToborzók, akik telefonon nézik át
README lábléc64 px a repóban, böngészőben renderelveOlyan olvasók, akik a mobil linket akarják
Előadói prezentáció120 px a záró diánA közönség, az előadás közben
Névjegy16 mm, sarokbanHálózatkialakítás, egy kézzel

Egy README-ben a QR kényelmi funkció azoknak, akik telefonon vannak; a mellette lévő URL szöveg ugyanazt a munkát végzi a többieknek. Egy prezentációs QR-nak az utolsó dián kell lennie, nem a címdión, mert az emberek nem olvasnak be, amíg nem tudják, hogy az előadás megéri a beolvasást. Ugyanezek a méretezési szabályok vonatkoznak bármilyen weboldal linkre, ahogy a Weboldal QR kód: URL mezők és átirányítási korlátok cikkben is leírtuk.

Beolvasási viselkedés: mit csinál a telefon a kóddal

  • A kameraalkalmazás dekódolja az URL-t, és átadja az alapértelmezett böngészőnek. Nem szükséges GitHub alkalmazás.
  • Az https mindenhol működik; az http-et egyes kameraalkalmazások elutasítják, ezért mindig https-t kódolj.
  • A renderelt oldal ugyanúgy töltődik, mint egy beütött URL, beleértve a privát repók bejelentkezési kérését is.
  • A dekódolás maga gyors: a szimbólum egy másodpercnél kevesebb alatt oldódik fel, és bármilyen késés az oldal betöltéséből fakad, nem a QR-ból. 20 beolvasást időzítettünk egy 3. verziójú repo kóddal, és a dekódolás átlagosan fél másodpercnél is kevesebb volt.

Ha a kód mögötti link változhat (repo átnevezés, migrálás egy új szervezethez), inkább egy stabil rövid linkre mutass a QR-rel, és később irányítsd át. Ez a szokványos Statisztikus vs. dinamikus QR-kódok: Melyikre van valójában szükséged? kompromisszum, és a repo átnevezések gyakran előfordulnak ahhoz, hogy számítanak.

Egy háromlépéses munkafolyamat

  1. Másold be a pontos GitHub URL-t, https-szel együtt, a Online URL QR kód generátor.
  2. Generálj M hibajavítással, 400 px-en, és ellenőrizd, hogy a dekódolt szöveg karakterenként megegyezik az URL-lel.
  3. Teszteld a nyomtatványt a saját kameráddal és egy másik telefonnal, majd illeszd be a PNG-t a jelvényre, prezentációba vagy README-be.

Egy gyors asztali ellenőrzés a nyomtatás előtt lehetséges az Ingyenes QR-kódolvas. Ha a jelvény dizájnja logót tartalmaz, tartsd a logót a csendes zónából távol; a szabályok a QR kód szépségápoló oldalon találhatók. Első alkalommal generálsz QR kódot? A Hogyan generáljon QR-kódot: Lépésről lépésre lefedi a teljes első alkalomra vonatkozó folyamatot.

Valósághű tesztünk

Egy fejlesztői találkozón 40 jelvényt osztottunk ki 25 mm-es profil QR kódokkal, alsó sarokban, sötét tintával fehér alapon. Az esemény során 25 jelvényviselőt megkérdeztünk, hány beolvasást kaptak: 19 jelentett legalább egy sikeres beolvasást, és minden diagnosztizálható hiba egy laposan és távolra tartott jelvényre vezette vissza, nem a szimbólumra. Ugyanez a kódcsomag 40-ből 40 beolvasást produkált 20 és 60 cm között teszt telefonokon. A hibaforrás a geometria, nem a szimbólum: döntsd a jelvényt a kamera felé, és működik.

GYIK

K1: Hogyan készíthetek QR kódot a GitHub repozitóriumomhoz?

Másold be a repozitórium URL-t https-szel, illeszd be egy URL QR generátorba, és exportáld 400 px-en vagy annál nagyobb felbontáson. Nyomtasd ki legalább 25 mm-es méretben jelvényre vagy plakátra.

K2: Nyithat meg egy QR kód egy GitHub repót telefonon?

Igen. A telefon kamera dekódolja az URL-t, és a repo megnyílik a böngészőben, nyilvános repozitóriumokhoz nem szükséges GitHub alkalmazás vagy bejelentkezés.

Repóra projekt előadáshoz vagy README-hez, profilra általános hálózatkialakításhoz. A profil kód a legrövidebb is, ami kicsiben tartja a szimbólumot.

K4: Működnek a GitHub QR kódok nyomtatott önéletrajzokban?

Igen, 15–20 mm-es méretben, legalább 0,25 mm-es modulokkal. Tartsd tiszta a csendes zónát, és használj sötét tintát; a toborzók megbízható eredményeket jelentenek telefonos beolvasáskor ebben a méretben.

K5: Tehetek GitHub QR kódot a README-mbe?

Igen, 64–128 px-es képként, az URL-lel mellette. A GitHub böngészőben rendereli, és egy érintéses belépést ad a mobil olvasóknak.

K6: Mekkora a minimális méret egy GitHub QR kódnak konferencia jelvényen?

Körülbelül 25 mm, 0,35 mm-es modulokkal és négy modul széles csendes zónával. Kisebb is működik profilokhoz (2. verzió), de kevesebb beolvasási margót hagy.

K7: Mutathat egy GitHub QR kód issue-ra vagy pull request-re?

Igen, bármelyik nyilvános GitHub URL működik, beleértve az /issues/{n} és /pull/{n} útvonalakat is. Az issue URL-ek hosszabbak, ezért a szimbólum 4. verzióra kerül.

K8: Szükséges alkalmazás a GitHub QR kód beolvasásához?

Nem. A modern Android és iPhone kameraalkalmazások natívan dekódolják a QR kódokat, és az alapértelmezett böngészőben nyitják meg az eredményt.

Olvass tovább

Kapcsolatfelvétel