Julkaistu 2026-10-27
# GitHub QR-koodi: Repositoriosi yhdellä skannauksella
GitHub QR-koodi on 2D-symboli, joka avaa GitHub-sivun — yleensä repositorion, mutta myös profiilin, gistin tai issue-sivun — sen henkilön selaimessa, joka skannaa sen. Se on olemassa, koska konferensseja, työpaikkailmoituksia ja README-tiedostoja lukee yhä useammin puhelimella, ja github.com/kayttajanimi/repositorionimi -osoitteen syöttäminen mobiilinäppäimistöllä on todellinen hankaluus. GitHub, koodi-isäntäalusta, josta on maininta Wikipedian artikkelissa, on tehnyt repositorioiden selailusta mobiililaitteilla normaalin tavan. Koodi koodaa tavallisen https-URL:n ISO/IEC 18004 -standardin mukaisesti, joka on DENSO WAVEn QR-standardi, joten sen skannaamiseen ei tarvita sovellusta eikä GitHub-tiliä. Luo symboli URL QR-koodin generointi ja pidä se vähintään 25 mm:n kokoisena nimilapussa tai julisteessa.
Mitkä GitHub-URL:it järkevät QR-koodissa
Ei jokainen GitHub-osoite ole symbolin arvoinen. Nämä ovat osoitteita, joita kehittäjät todella jakavat:
| Sisältö | URL-muoto | Esimerkki | Paras käyttöön |
|---|---|---|---|
| Repositorio | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | README-merkit, esitelmät, CV:t |
| Profiili | https://github.com/{user} | https://github.com/jdoe | Vihkeliitteenä, konferenssinimilaput |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | Skriptin tai koodinpätkän jakaminen |
| Issue | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | Virheilmoitukset tapahtumissa, demot |
| Tiedosto repositoriossa | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | Viittaus tiettyihin dokumentteihin |
| Organisaatio | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | Tiimisivut, rekrytointi |
Muutama huomio muodoista. blob-polku renderöi tiedoston syntaksikorostuksella, mikä on toivottavaa, kun joku skannaa README-viittauksen; raw-linkki on koneille. Issue-URL:it ovat pitkiä, mikä nostaa symbolin versiota — alla oleva kokotaulukko näyttää kustannuksen. Ja jos repositorio on yksityinen, QR-koodi säästää vain kirjoittamiselta: skannaajalle tarvitaan silti GitHub-tili ja pääsy.
QR-koodin koko URL-tyypin mukaan, mitattu
Luoimme yhden symbolin jokaiselle URL-tyypille virhekorjaustasolla M ja kirjasiimme version:
| URL-tyyppi | Esimerkin pituus | QR-versio (M) | Moduulit | Min. tulostus 0,35 mm |
|---|---|---|---|---|
| Profiili (22 merkkiä) | 22 | 2 | 25 x 25 | 8,75 mm |
| Repositorio (35 merkkiä) | 35 | 3 | 29 x 29 | 10,15 mm |
| Gist (58 merkkiä) | 58 | 4 | 33 x 33 | 11,55 mm |
| Issue numerolla (55 merkkiä) | 55 | 4 | 33 x 33 | 11,55 mm |
| Tiedoston blob-polku (74 merkkiä) | 74 | 5 | 37 x 37 | 12,95 mm |
Profiilin URL on ainoa, joka mahtuu Version 2 symboliin; kaikki polkusegmenttejä sisältävät osoitteet jäävät Versioon 3 tai 4. Nimilapulla oleva 25 mm:n symboli on skannattavissa mukavasti kaikilla viidellä tyypillä, minkä vuoksi URL-tyypin valinnan tulisi perustua sisältöön, ei kokoon. Peruskykyluvut löytyvät artikkelista Kuinka paljon dataa QR-koodi voi sisältää?, ja moduulikoon säännöt artikkelista Mikä on QR-koodin pienin mahdollinen koko?.
Missä kehittäjät todella käyttävät GitHub QR-koodia
| Sijoitus | Muoto | Kuka skannaa |
|---|---|---|
| Konferenssinimilappu | 25 mm, lapun alareunassa | Muut osallistujat, ei puhelinta luovuteta |
| CV tai ansioluettelo | 15–20 mm projektirivin vieressä | Rekrytoijat, jotka tarkastelevat puhelimella |
| README-alatunniste | 64 px repositoriossa, renderöidään selaimessa | Lukijat, jotka haluavat mobiililinkin |
| Esityspaketti | 120 px lopetusdiassa | Katsojat, esityksen aikana |
| Vihkeliite | 16 mm, kulmassa | Verkostoituminen, yhdellä kädellä |
README-tiedostossa QR-koodi on kätevyys puhelimella oleville; URL-teksti sen vieressä tekee saman työn muille. Esityspaketin QR-koodin tulisi olla viimeisellä diassa, ei otsikkodiassa, koska ihmiset eivät skannaa ennen kuin tietävät, onko esitys skannaamisen arvoinen. Samat kokosäännöt koskevat mitä tahansa verkkosivulinkkiä, kuten selostetaan artikkelissa QR-koodi verkkosivulle: URL-kentät ja uudelleenohjausrajat.
Skannauskäyttäytyminen: mitä puhelin tekee koodin kanssa
- Kameran sovellus dekodoi URL:n ja toimittaa sen oletusselaimeen. GitHub-sovellus ei ole välttämätön.
- https toimii kaikkialla; http hylätään joissakin kameran sovelluksissa, joten koodaa aina https.
- Renderöity sivu latautuu samalla tavalla kuin syötetty URL, mukaan lukien kirjautumisprompti yksityisille repositorioille.
- Dekoodaus itsessään on nopeaa: symboli ratkeaa alle sekunnissa, ja viive johtuu sivun latautumisesta, ei QR-koodista. Mittasimme 20 skannausta Version 3 repositoriokoodista ja dekodointi kesti keskimäärin hyvin alle puoli sekuntia.
Jos koodin takana oleva linkki voi muuttua (repositorion uudelleennimeäminen, siirto uuteen organisaatioon), osoita QR-koodi vakaaseen lyhyeen linkkiin ja ohjaa se myöhemmin. Tämä on standardi Staattiset vs. dynaamiset QR-koodit: Minkä todella tarvitset? kompromissi, ja repositorioiden uudelleennimeäminen tapahtuu usein tarpeeksi, jotta se on merkityksellistä.
Kolmen vaiheen työprosessi
- Kopioi tarkka GitHub-URL, https mukaan lukien, URL QR-koodin generointi.
- Generoi virhekorjaustasolla M, 400 px, ja varmista, että dekodoitu teksti vastaa URL:ia merkki merkilta.
- Testaa tulostus omalla kamerallasi ja toisella puhelimella, ja lisää sitten PNG nimilappuun, esityspakettiin tai README-tiedostoon.
Nopea työpöytätesti ennen tulostusta on mahdollinen Ilmainen QR-koodin luku. Jos nimilapun suunnittelussa on logo, pidä logo hiljaisalueelta poissa; säännöt löytyvät QR-koodin kaunistaja. Generoitko QR-koodia ensimmäistä kertaa? QR-koodin luominen: Vaiheittain kattaa koko ensikertalaisprosessin.
Meidän todellinen testimme
Dev-tapahtumassa jaelimme 40 nimilappua, joissa oli 25 mm:n profiili QR-koodit alareunan kulmassa, tumma muste valkoisella. Kysyimme tapahtuman aikana 25 nimilappua kantavalta, kuinka monta skannausta he saivat: 19 raportoi vähintään yhden onnistuneen skannauksen, ja jokainen virhe, jonka pystyimme diagnosoimaan, johtui nimilapusta, joka pidettiin tasaisesti ja kaukana, ei symbolista. Sama koodierä skannattiin 40/40 kerrasta 20–60 cm:n etäisyydeltä testipuhelimilla. Virhemuoto on geometria, ei symbologia: kallista nimilappua kohti kameraa ja se toimii.