Crea un codice QR per un profilo o un repo GitHub
Incolla l'indirizzo, dai al codice lo stile del tuo adesivo o della tua slide e scaricalo pronto per la stampa - puntato su un URL che risolverà anche dopo la prossima rinomina.
Si apre in Google Maps. Funzionano anche le coordinate: 37.4224, -122.0841.
Il codice apre il modulo "Scrivi una recensione" della tua attività. Incolla il Place ID, o un link di Google Maps che lo contiene.
Un link UPI non ha checksum: un ID sbagliato produce un codice che si scansiona perfettamente e paga qualcun altro. Incolla l'ID dalla tua app di pagamento invece di digitarlo, e mandati una rupia prima di stampare.
Incollala esattamente come l'hai copiata. KoloQR non costruisce il payload: codifica quello emesso dalla tua banca e lo verifica prima che tu lo stampi.
SVG, PNG, JPG • Max 2 MB
Che cos'è un codice QR GitHub?
Un codice QR GitHub è un codice QR che contiene un indirizzo github.com: un profilo, un repository, una release, un gist o un file a un commit preciso. Scansionandolo si apre quella pagina nel browser del telefono. GitHub non richiede un'app per leggere un repository, quindi la scansione funziona su qualsiasi telefono.
Quale URL GitHub va nel codice?
GitHub ha più indirizzi per la stessa cosa, e invecchiano a velocità molto diverse:
- github.com/owner/repo/releases/latest - reindirizza sempre alla release pubblicata più recente. Stampa questo su hardware e manuali invece di un numero di versione che sarà sbagliato entro un mese.
- github.com/owner/repo/blob/<commit>/percorso - un permalink a un file com'era a un commit. Premere y sulla pagina di un file riscrive l'URL di ramo in questa forma, ed è l'unico link a file che non può marcire.
- github.com/owner/repo/blob/main/README.md - un link a ramo. Comodo, ma mostra ciò che main contiene al momento della scansione, che per un riferimento stampato può essere anni di modifiche più tardi.
GitHub mantiene i reindirizzamenti quando un repository o un account viene rinominato, quindi un codice stampato non muore necessariamente con una rinomina - ma quel reindirizzamento dipende dal fatto che il vecchio nome resti non reclamato, e un nome utente liberato può essere registrato da qualcun altro. Per qualunque cosa stampata in volume, questo è un motivo per codificare un URL breve su un dominio che controlli e puntarlo a GitHub: uno spostamento costa allora una modifica al reindirizzamento invece di una ristampa.
Cosa apre davvero la scansione su un telefono
La pagina di un repository su un telefono è una colonna stretta: l'elenco dei file e sotto il README renderizzato. Si legge bene, ed è per questo che un codice su un adesivo da conferenza o sulla serigrafia di una scheda di sviluppo funziona. Due cose vanno sapute prima di stamparne uno. Un repository privato mostra un 404 invece di un invito ad accedere a chi non è autorizzato, quindi un codice puntato su lavoro privato sembra rotto anziché protetto: provalo da un telefono non connesso. E un URL di file grezzo su raw.githubusercontent.com scarica o mostra testo semplice invece di aprire il repository, il che va bene per un file di configurazione e male per qualsiasi cosa debba leggere una persona.
Genera codice QR
Dove si usano i codici QR GitHub
Un codice su un oggetto fisico è la strada più breve tra hardware, carta o un palco e il codice sorgente che ci sta dietro:
Come creare un codice QR GitHub
Dal repository all'adesivo stampato in quattro passaggi:
Genera codice QR- 1
Scegli l'URL che invecchierà meglio
Un profilo per un biglietto, /releases/latest per hardware e manuali, un permalink a un commit per un estratto di codice. Evita link a ramo e numeri di versione in tutto ciò che è stampato.
- 2
Verifica che risolva da disconnesso
Apri l'URL in una finestra anonima. Un repository privato restituisce un 404 invece di un invito ad accedere, ed è quello che vedrà anche chi legge.
- 3
Incolla il link e progetta il codice
Scegli il tipo URL e incolla l'indirizzo, poi scegli forma e colori. Moduli scuri su fondo chiaro reggono un adesivo opaco meglio di una coppia invertita.
- 4
Prova ed esporta
Scansionalo da un telefono, poi esporta SVG o PDF per adesivi e serigrafia, PNG per le slide.
Quale formato di file dovresti scaricare?
KoloQR esporta il tuo codice QR GitHub in tre formati. Scegli in base a dove sarà visto:
- PNG per slide, README e siti di documentazione, dove il codice appare in una sola dimensione fissa.
- SVG per adesivi, file per serigrafia e manuali stampati - tutto ciò che viene ingrandito senza ammorbidire i bordi.
- PDF per consegnarlo a una stamperia di adesivi o a un produttore di schede con qualità pronta per la stampa.
In questa pagina la cosa da sorvegliare è la lunghezza del contenuto. github.com/owner sta sui 25 caratteri e si stampa piccolo senza problemi; un permalink a un file in fondo a un albero può superare i 100, e questo richiede un simbolo più grande o un adesivo più grande. Se un permalink lungo deve finire su qualcosa grande come un'unghia, mettici davanti un reindirizzamento breve sul tuo dominio.
Genera codice QRBuone pratiche per i codici QR GitHub
Un link stampato a una base di codice ha un compito che il codice stesso non può svolgere: essere ancora vero dopo.
Stampa /releases/latest, non un numero di versione
Quell'indirizzo reindirizza sempre alla release pubblicata più recente, così un manuale o l'etichetta di un dispositivo non nominano mai una versione superata.
Usa permalink ai commit per gli estratti di codice
Un link a un file su un ramo mostra ciò che quel ramo contiene al momento della scansione. Un permalink a un commit mostra ciò che hai stampato accanto.
Controlla che i repository privati restituiscano 404
GitHub non invita chi non è connesso ad accedere per un repository che non può vedere. Un codice su lavoro privato sembra rotto a chiunque sia fuori dall'organizzazione.
Non contare sui reindirizzamenti di rinomina per la stampa duratura
Rinominare un repository o un account lascia un reindirizzamento, ma solo finché il vecchio nome resta libero. Serigrafia e confezioni sopravvivono a quella garanzia.
Tieni l'URL abbastanza corto per la superficie
Un URL di profilo si stampa volentieri a 15 mm. Un permalink profondo alla stessa dimensione è un simbolo più fitto sugli stessi millimetri quadrati, ed è lì che le scansioni iniziano a fallire.
Preferisci la pagina del repository a un file grezzo
Un link raw.githubusercontent.com consegna al telefono testo semplice o un download. La pagina del repository renderizza il README, che è ciò per cui una persona ha scansionato.
Etichetta dove porta il codice
«Firmware e documentazione» o «sorgenti di questo talk» accanto al codice è la differenza tra una scansione e un'alzata di spalle.
Attenzione al contrasto sugli adesivi scuri
Moduli scuri su fondo chiaro è ciò che le fotocamere si aspettano. Se l'adesivo deve essere scuro, prova la versione invertita su più telefoni prima di ordinare una tiratura.
Proteggi la zona di silenzio
Quattro moduli di margine libero su ogni lato - facilmente persi su un adesivo piccolo dove la grafica arriva alla linea di taglio.
Dimensiona in base alla distanza
Circa un decimo della distanza di lettura: circa 2 cm su un adesivo da portatile, circa 20 cm su un poster letto a 2 metri.
Perché il tuo codice QR GitHub non funziona
In questa pagina il motivo raramente è il problema. Di solito lo è l'URL dietro - o per ciò a cui punta, o per quanto è lungo.
La scansione mostra una pagina 404
- Causa
- Il repository è privato, oppure è stato rinominato o eliminato e il vecchio nome è stato preso da qualcun altro, il che rimuove il reindirizzamento.
- Soluzione
- Rendi pubblico il repository, oppure punta il codice a un profilo o a una pagina di documentazione pubblica. Per la stampa in volume, codifica un reindirizzamento sul tuo dominio così la destinazione resta modificabile.
Il codice non si scansiona su un adesivo piccolo
- Causa
- È stato codificato un permalink profondo o un percorso di file lungo, quindi il simbolo porta molti più moduli di quanti un adesivo da 15 mm possa risolvere.
- Soluzione
- Accorcia la destinazione - il profilo, la radice del repository o /releases/latest - oppure metti un URL breve del tuo dominio davanti a quello lungo, poi rigenera.
La scansione scarica un file invece di aprire una pagina
- Causa
- L'URL è un indirizzo raw.githubusercontent.com, che serve il file stesso invece della pagina renderizzata da GitHub.
- Soluzione
- Codifica invece l'indirizzo github.com/owner/repo/blob/... Tieni i link grezzi per le macchine - una configurazione che uno script scarica - e non per una persona con una fotocamera.
Il codice punta a una vecchia versione del progetto
- Causa
- È stato codificato l'URL di una release taggata o un link a ramo, e il progetto è andato avanti. Il codice fa esattamente quello che gli è stato detto.
- Soluzione
- Ristampa puntando a /releases/latest per i download, o alla radice del repository per i sorgenti. Entrambi seguono il progetto invece di fissarlo al giorno in cui è stata fatta la grafica.
Ancora non sai se il problema è il file o la stampa? Trascina l'immagine esportata nello scanner di codici QR: se si decodifica sul computer ma non su carta, il problema è nato dopo il file.
Questions? Answered
Un codice QR GitHub contiene un indirizzo github.com - profilo, repository, release o file a un commit preciso. Scansionandolo si apre quella pagina nel browser del telefono. Per leggere un repository pubblico non servono app né account.
Un profilo per un biglietto da visita, github.com/owner/repo/releases/latest per hardware e manuali, e un permalink a un commit per un estratto di codice. Evita link a ramo e versioni fissate in ciò che stampi.
GitHub reindirizza il vecchio indirizzo al nuovo, quindi il codice stampato di solito continua a funzionare - ma solo finché il vecchio nome resta non reclamato. Se qualcun altro lo registra, il reindirizzamento finisce.
Puoi, ma chi non è connesso riceve un 404 invece di un invito ad accedere, quindi il codice sembra rotto a chiunque sia fuori dall'organizzazione. Punta la stampa pubblica su pagine pubbliche.
Codifica github.com/owner/repo/releases/latest. GitHub lo reindirizza alla release pubblicata più recente, così un codice stampato su un dispositivo o un manuale non nomina mai una versione superata.
Un URL di profilo o repository - circa 25-40 caratteri - si stampa affidabile da circa 15 mm. Un permalink lungo a un commit richiede un simbolo più grande: dagli più spazio o accorcia prima la destinazione.
Perché codifica un URL raw.githubusercontent.com, che serve il file stesso. Usa l'indirizzo github.com/owner/repo/blob/... se a leggere la pagina deve essere una persona e non una macchina a scaricare il file.
Sì - esporta un PNG e committalo come qualsiasi altra immagine. Vale la pena quando il README documenta hardware, così l'oggetto stampato e il repository portano lo stesso codice.
Sì. I repository pubblici si visualizzano in qualsiasi browser mobile, README compreso. L'app non cambia nulla sul fatto che la scansione risolva.
Non dal codice, e le statistiche di traffico di GitHub coprono solo i repository che ti appartengono. Codificare un reindirizzamento sul tuo dominio è l'unico modo affidabile per contare le scansioni di un poster o di una tiratura specifica.
Continua a esplorare
Pagine che riprendono da dove finisce questa: lo stesso contesto, lo stesso tipo di codice o la prossima decisione da prendere.
Codice QR Google Documenti
Apre un documento, una dispensa o un modello direttamente da una pagina stampata.
Matrimoni
Un codice sull'invito, che porta gli invitati al modulo di conferma, al programma e alle indicazioni, e in seguito a un album fotografico condiviso.
Scuole e classi
Autorizzazioni, circolari, link della biblioteca e lavori degli studenti, con le misure di stampa e le regole sulla privacy che a una scuola servono davvero.
Codice QR YouTube
Porta le persone dritte a un canale, a un singolo video, a una playlist o alla finestra di iscrizione.
Codice QR LinkedIn
Condividi il tuo profilo o la tua pagina aziendale LinkedIn con un codice che qualsiasi fotocamera sa leggere.
Codice QR per moduli
Apre un sondaggio, una candidatura o un modulo di iscrizione da qualsiasi stampato.
Perché KoloQR?
- Crea codici QR per siti web, menù, Wi-Fi, PDF e biglietti da visita
- Personalizza colori, loghi e forme uniche
- Scarica file PNG e SVG di alta qualità
- Pensato sia per la stampa che per il digitale
