Crée un code QR pour un profil ou un dépôt GitHub
Colle l'adresse, mets le code au style de ton autocollant ou de ta diapositive et télécharge-le prêt à imprimer - pointé vers une URL qui répondra encore après le prochain renommage.
S'ouvre dans Google Maps. Les coordonnées fonctionnent aussi : 37.4224, -122.0841.
Le code ouvre le formulaire « Rédiger un avis » de ton établissement. Colle l'ID de lieu, ou un lien Google Maps qui le contient.
Un lien UPI n'a pas de somme de contrôle : un identifiant mal saisi donne un code qui se scanne parfaitement et paie quelqu'un d'autre. Colle l'identifiant depuis ton application de paiement au lieu de le taper, et envoie-toi une roupie avant d'imprimer.
Colle-la exactement telle que copiée. KoloQR n'assemble pas la charge utile : il encode celle que ta banque a émise, et la vérifie avant que tu l'imprimes.
SVG, PNG, JPG • Max. 2 Mo
Qu'est-ce qu'un code QR GitHub ?
Un code QR GitHub est un code QR qui contient une adresse github.com : un profil, un dépôt, une release, un gist ou un fichier à un commit précis. Le scanner ouvre cette page dans le navigateur du téléphone. GitHub n'exige aucune application pour lire un dépôt, donc le scan fonctionne sur n'importe quel téléphone.
Quelle URL GitHub mettre dans le code ?
GitHub propose plusieurs adresses pour la même chose, et elles vieillissent très différemment :
- github.com/owner/repo/releases/latest - redirige toujours vers la release publiée la plus récente. Imprime cela sur du matériel ou dans une documentation, plutôt qu'un numéro de version faux d'ici un mois.
- github.com/owner/repo/blob/<commit>/chemin - un lien permanent vers un fichier tel qu'il était à un commit. Appuyer sur y depuis la page d'un fichier réécrit l'URL de branche sous cette forme, et c'est le seul lien de fichier qui ne peut pas pourrir.
- github.com/owner/repo/blob/main/README.md - un lien de branche. Pratique, mais il affiche ce que main contient au moment du scan, ce qui, pour une référence imprimée, peut représenter des années de changements plus tard.
GitHub conserve des redirections quand un dépôt ou un compte est renommé, donc un code imprimé ne meurt pas forcément d'un renommage - mais cette redirection dépend du fait que l'ancien nom reste non réclamé, et un identifiant libéré peut être enregistré par quelqu'un d'autre. Pour tout ce qui est imprimé en volume, c'est une raison d'encoder une URL courte sur un domaine que tu contrôles et de la faire pointer vers GitHub : un déménagement coûte alors une redirection à modifier plutôt qu'un retirage.
Ce que le scan ouvre réellement sur un téléphone
La page d'un dépôt sur un téléphone est une colonne étroite : la liste des fichiers, puis le README rendu en dessous. C'est lisible, et c'est pour cela qu'un code sur un autocollant de conférence ou sur la sérigraphie d'une carte de développement fonctionne. Deux choses à savoir avant d'en imprimer un. Un dépôt privé affiche une 404 plutôt qu'une invitation à se connecter pour qui n'y a pas accès : un code pointant vers du travail privé a donc l'air cassé plutôt que protégé - teste-le depuis un téléphone déconnecté. Et une URL de fichier brut sur raw.githubusercontent.com se télécharge ou s'affiche en texte brut au lieu d'ouvrir le dépôt, ce qui convient à un fichier de configuration et pas à ce qu'un humain doit lire.
Créer un code QR
Où les codes QR GitHub sont utilisés
Un code sur un objet physique est le chemin le plus court entre du matériel, du papier ou une scène et le code source qui les sous-tend :
- 1
Choisis l'URL qui vieillira le mieux
Un profil pour une carte, /releases/latest pour du matériel et des manuels, un lien permanent de commit pour un extrait de code. Évite les liens de branche et les numéros de version dans tout imprimé.
- 2
Vérifie qu'elle répond en étant déconnecté
Ouvre l'URL dans une fenêtre privée. Un dépôt privé renvoie une 404 plutôt qu'une invitation à se connecter, et c'est ce que verra ton lecteur.
- 3
Colle le lien et conçois le code
Choisis le type URL et colle l'adresse, puis choisis une forme et des couleurs. Des modules sombres sur fond clair supportent mieux un autocollant mat qu'une paire inversée.
- 4
Teste et exporte
Scanne-le depuis un téléphone, puis exporte en SVG ou PDF pour les autocollants et la sérigraphie, et en PNG pour les diapositives.
Quel format de fichier télécharger ?
KoloQR exporte ton code QR GitHub dans trois formats. Choisis selon l'endroit où il sera vu :
- PNG pour les diapositives, les README et les sites de documentation, où le code apparaît à une taille fixe.
- SVG pour les autocollants, les fichiers de sérigraphie et les manuels imprimés - tout ce qui est agrandi sans ramollir les contours.
- PDF pour transmettre à un imprimeur d'autocollants ou à un fabricant de cartes en qualité prête à imprimer.
Sur cette page, c'est la longueur de la charge qu'il faut surveiller. github.com/owner fait environ 25 caractères et s'imprime petit sans souci ; un lien permanent de commit vers un fichier profond dans l'arborescence peut dépasser 100, ce qui exige un symbole ou un autocollant plus grand. Si un long lien permanent doit tenir sur quelque chose de la taille d'un ongle, mets devant une redirection courte sur ton propre domaine.
Créer un code QRBonnes pratiques pour les codes QR GitHub
Un lien imprimé vers une base de code a une tâche que le code lui-même ne peut pas accomplir : rester vrai plus tard.
Imprime /releases/latest, pas un numéro de version
Cette adresse redirige toujours vers la release publiée la plus récente, donc un manuel ou une étiquette d'appareil ne nomme jamais une version dépassée.
Utilise des liens permanents de commit pour les extraits de code
Un lien vers un fichier sur une branche montre ce que cette branche contient au moment du scan. Un lien permanent de commit montre ce que tu as imprimé à côté.
Vérifie que les dépôts privés renvoient une 404
GitHub n'invite pas les visiteurs déconnectés à se connecter pour un dépôt qu'ils ne peuvent pas voir. Un code vers du travail privé paraît cassé à tous ceux qui sont hors de l'organisation.
Ne compte pas sur les redirections de renommage pour l'imprimé durable
Renommer un dépôt ou un compte laisse une redirection, mais seulement tant que l'ancien nom reste libre. La sérigraphie et l'emballage survivent à cette garantie.
Garde l'URL assez courte pour la surface
Une URL de profil s'imprime volontiers à 15 mm. Un lien permanent profond à la même taille est un symbole plus dense sur les mêmes millimètres carrés, et c'est là que les scans commencent à échouer.
Préfère la page du dépôt à un fichier brut
Un lien raw.githubusercontent.com remet au téléphone du texte brut ou un téléchargement. La page du dépôt rend le README, et c'est ce que la personne cherchait.
Indique où mène le code
« Firmware et documentation » ou « code source de cette conférence » à côté du code, c'est la différence entre un scan et un haussement d'épaules.
Surveille le contraste sur les autocollants sombres
Des modules sombres sur fond clair, c'est ce qu'attendent les appareils photo. Si l'autocollant doit être sombre, teste la version inversée sur plusieurs téléphones avant de commander un tirage.
Protège la zone de silence
Quatre modules de marge libre de chaque côté - facilement perdus sur un petit autocollant où le visuel court jusqu'à la ligne de découpe.
Dimensionne selon la distance
Environ un dixième de la distance de lecture : à peu près 2 cm sur un autocollant d'ordinateur portable, à peu près 20 cm sur une affiche lue à 2 mètres.
Pourquoi ton code QR GitHub ne fonctionne pas
Le motif est rarement le problème sur cette page. L'URL derrière l'est généralement - soit à cause de ce qu'elle vise, soit à cause de sa longueur.
Le scan affiche une page 404
- Cause
- Le dépôt est privé, ou il a été renommé ou supprimé et l'ancien nom a depuis été pris par quelqu'un d'autre, ce qui supprime la redirection.
- Solution
- Rends le dépôt public, ou fais pointer le code vers un profil ou une page de documentation publique. Pour ce qui est imprimé en volume, encode une redirection sur ton propre domaine pour garder la destination modifiable.
Le code ne se scanne pas sur un petit autocollant
- Cause
- Un lien permanent profond ou un long chemin de fichier a été encodé, donc le symbole porte bien plus de modules qu'un autocollant de 15 mm ne peut en résoudre.
- Solution
- Raccourcis la destination - le profil, la racine du dépôt ou /releases/latest - ou place une URL courte de ton domaine devant la longue, puis régénère.
Le scan télécharge un fichier au lieu d'ouvrir une page
- Cause
- L'URL est une adresse raw.githubusercontent.com, qui sert le fichier lui-même plutôt que la page rendue par GitHub.
- Solution
- Encode plutôt l'adresse github.com/owner/repo/blob/... Garde les liens bruts pour les machines - une configuration qu'un script récupère - plutôt que pour un humain avec un appareil photo.
Le code pointe vers une ancienne version du projet
- Cause
- Une URL de release taguée ou un lien de branche a été encodé, et le projet a avancé. Le code fait exactement ce qu'on lui a demandé.
- Solution
- Réimprime avec /releases/latest pour les téléchargements, ou la racine du dépôt pour les sources. Les deux suivent le projet au lieu de le figer au jour de la maquette.
Tu ne sais toujours pas si le problème vient du fichier ou de l'impression ? Dépose l'image exportée dans le scanner de codes QR : si elle se décode sur un ordinateur mais pas sur papier, le problème est apparu après le fichier.
Questions? Answered
Un code QR GitHub contient une adresse github.com - profil, dépôt, release ou fichier à un commit précis. Le scanner ouvre cette page dans le navigateur du téléphone. Ni application ni compte ne sont nécessaires pour lire un dépôt public.
Un profil pour une carte de visite, github.com/owner/repo/releases/latest pour le matériel et les manuels, et un lien permanent de commit pour un extrait de code. Évite les liens de branche et les versions figées dans l'imprimé.
GitHub redirige l'ancienne adresse vers la nouvelle, donc le code imprimé continue généralement de fonctionner - mais seulement tant que l'ancien nom reste libre. Si quelqu'un d'autre l'enregistre, la redirection s'arrête.
Tu peux, mais les visiteurs déconnectés obtiennent une 404 plutôt qu'une invitation à se connecter : le code paraît cassé à tous ceux qui sont hors de l'organisation. Fais pointer l'imprimé public vers des pages publiques.
Encode github.com/owner/repo/releases/latest. GitHub redirige vers la release publiée la plus récente, donc un code imprimé sur un appareil ou dans un manuel ne nomme jamais une version dépassée.
Une URL de profil ou de dépôt - environ 25 à 40 caractères - s'imprime de façon fiable dès 15 mm. Un long lien permanent de commit demande un symbole plus grand : donne-lui plus de place ou raccourcis d'abord la destination.
Parce qu'il encode une URL raw.githubusercontent.com, qui sert le fichier lui-même. Utilise l'adresse github.com/owner/repo/blob/... si c'est une personne qui doit lire la page plutôt qu'une machine qui récupère le fichier.
Oui - exporte un PNG et commite-le comme n'importe quelle image. Cela vaut la peine quand le README documente du matériel, pour que l'objet imprimé et le dépôt portent le même code.
Oui. Les dépôts publics s'affichent dans n'importe quel navigateur mobile, README compris. L'application ne change rien au fait que le scan aboutisse.
Pas depuis le code, et les statistiques de trafic de GitHub ne couvrent que les dépôts qui t'appartiennent. Encoder une redirection sur ton propre domaine est le seul moyen fiable de compter les scans d'une affiche ou d'un tirage donné.
Continue d'explorer
Des pages qui prennent la suite de celle-ci : le même contexte, le même type de code ou la prochaine décision à prendre.
Code QR Google Docs
Ouvre un document, un support de cours ou un modèle depuis une page imprimée.
Mariages
Un seul code sur le faire-part, qui renvoie les invités vers ton formulaire RSVP, le programme et l'itinéraire, puis vers un album photo partagé.
Écoles et classes
Autorisations, circulaires, liens de bibliothèque et travaux d'élèves, avec les tailles d'impression et les règles de confidentialité dont une école a réellement besoin.
Code QR YouTube
Envoie les gens directement vers une chaîne, une vidéo, une playlist ou l'invite d'abonnement.
Code QR LinkedIn
Partage ton profil ou ta page entreprise LinkedIn avec un code que l'appareil photo de n'importe quel téléphone sait lire.
Code QR de formulaire
Ouvre un sondage, une candidature ou un formulaire d'inscription depuis n'importe quel imprimé.
Pourquoi KoloQR ?
- Crée des codes QR pour des sites web, des menus, le Wi-Fi, des PDF et des cartes de visite
- Personnalise les couleurs, les logos et des formes uniques
- Télécharge des fichiers PNG et SVG de haute qualité
- Conçu pour l'impression comme pour le numérique
