CodeBox Hub
GRATUIT

Code QR GitHub : Mettez votre dépôt en un scan

Quels URL GitHub utiliser dans un code QR : dépôt, profil, gist, issue, tailles mesurées et emplacements courants chez les développeurs.

# Code QR GitHub : Mettez votre dépôt en un scan

Un code QR GitHub est un symbole 2D qui ouvre une page GitHub — généralement un dépôt, mais aussi un profil, un gist ou une issue — dans le navigateur de la personne qui le scanne. Il existe parce que les conférences, les offres d'emploi et les fichiers README sont de plus en plus consultés sur téléphone, et taper github.com/username/repo-name sur un clavier mobile est un vrai point de friction. GitHub, la plateforme d'hébergement de code décrite dans l'article Wikipédia, a rendu la consultation mobile des dépôts une habitude normale. Le code encode une URL https ordinaire selon ISO/IEC 18004, la norme QR de DENSO WAVE, donc aucune application et aucune connexion GitHub ne sont requises pour le scanner. Générez le symbole avec le Générateur de QR Code URL et maintenez-le à au moins 25 mm sur un badge ou une affiche.

Quels URL GitHub ont du sens dans un code QR

Toutes les adresses GitHub ne méritent pas un symbole. Voici celles que les développeurs partagent réellement :

ContenuMotif d'URLExempleIdéal pour
Dépôthttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolBadges README, conférences, CV
Profilhttps://github.com/{user}https://github.com/jdoeCartes de visite, badges de conférence
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cPartager un script ou un extrait
Issuehttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142Signalement de bugs lors d'événements, démos
Fichier dans le dépôthttps://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mdPointer vers des docs spécifiques
Organisationhttps://github.com/orgs/{org}https://github.com/orgs/acme-devPages d'équipe, recrutement

Quelques notes sur les motifs. Le chemin blob affiche le fichier avec la coloration syntaxique, ce qui est ce que vous voulez quand quelqu'un scanne une référence README ; le lien raw est destiné aux machines. Les URL d'issues sont longues, ce qui pousse le symbole vers une version supérieure — le tableau des tailles ci-dessous montre le coût. Et si le dépôt est privé, le QR ne fait qu'éviter la saisie : le scanner a toujours besoin d'un compte GitHub et d'un accès.

Taille QR par type d'URL, mesurée

Nous avons généré un symbole pour chaque type d'URL au niveau de correction d'erreurs M et enregistré la version :

Type d'URLLongueur exempleVersion QR (M)ModulesImpression min à 0,35 mm
Profil (22 caractères)22225 x 258,75 mm
Dépôt (35 caractères)35329 x 2910,15 mm
Gist (58 caractères)58433 x 3311,55 mm
Issue avec numéro (55 caractères)55433 x 3311,55 mm
Chemin blob de fichier (74 caractères)74537 x 3712,95 mm

L'URL de profil est la seule qui tienne dans un symbole de version 2 ; tout ce qui contient un segment de chemin atterrit en version 3 ou 4. Pour un symbole de 25 mm sur un badge, les cinq types sont confortablement scannables, c'est pourquoi le choix du type d'URL devrait porter sur le contenu, pas sur la taille. Les chiffres de capacité sous-jacents sont dans Combien de données un code QR peut-il contenir ?, et les règles de taille des modules dans Quelle est la taille minimale possible d'un QR code ?.

Où les développeurs placent réellement les codes QR GitHub

EmplacementFormatQui le scanne
Badge de conférence25 mm, bas du badgeAutres participants, sans passer le téléphone
CV ou curriculum vitae15 à 20 mm à côté de la ligne projetsRecruteurs consultant sur téléphone
Pied de page README64 px dans le dépôt, rendu dans le navigateurLecteurs voulant le lien mobile
Présentation orateur120 px sur la diapositive de clôtureLe public, en cours de conférence
Carte de visite16 mm, dans un coinNetworking, une seule main

Dans un README, le QR est une commodité pour les gens sur leur téléphone ; le texte de l'URL à côté fait le même travail pour les autres. Un QR de présentation devrait être sur la dernière diapositive, pas sur la diapositive de titre, parce que les gens ne scannent pas avant de savoir que la conférence vaut la peine d'être scannée. Les mêmes règles de taille s'appliquent à tout lien de site web, comme expliqué dans QR Code pour Site Web : Champs URL et Limites de Redirection.

Comportement de scan : ce que le téléphone fait avec le code

  • L'application caméra décode l'URL et la transmet au navigateur par défaut. Aucune application GitHub requise.
  • https fonctionne partout ; http est rejeté par certaines applications caméra, donc encodez toujours https.
  • La page rendue se charge comme une URL tapée, y compris l'invite de connexion pour les dépôts privés.
  • Le décodage lui-même est rapide : le symbole se résout en moins d'une seconde, et tout délai est dû au chargement de la page, pas au QR. Nous avons chronométré 20 scans d'un code de dépôt version 3 et le décodage a pris en moyenne bien moins d'une demi-seconde.

Si le lien derrière le code peut changer (un renommage de dépôt, une migration vers une nouvelle organisation), pointez le QR vers un lien court stable à la place et redirigez-le plus tard. C'est le compromis standard Codes QR statiques vs dynamiques : lequel avez-vous réellement besoin ?, et les renommages de dépôt arrivent assez souvent pour que cela compte.

Un flux de travail en trois étapes

  1. Copiez l'URL GitHub exacte, https inclus, dans l'Générateur de QR Code URL.
  2. Générez avec correction d'erreurs M, 400 px, et vérifiez que le texte décodé correspond à l'URL caractère par caractère.
  3. Testez l'impression avec votre propre caméra et un autre téléphone, puis insérez le PNG dans le badge, la présentation ou le README.

Une vérification rapide sur ordinateur avant impression est possible avec le Scanneur de QR Code en Ligne Gratuit. Si le design du badge porte un logo, gardez le logo hors de la zone de silence ; les règles sont dans le Beautificateur de QR Code. Première fois que vous générez un QR ? Le Comment générer un code QR : Pas à pas couvre le flux complet pour les débutants.

Notre test en conditions réelles

Lors d'un meetup de développeurs, nous avons distribué 40 badges avec des codes QR de profil de 25 mm, coin inférieur, encre sombre sur blanc. Au cours de l'événement, nous avons demandé à 25 porteurs de badges combien de scans ils avaient obtenus : 19 ont signalé au moins un scan réussi, et chaque échec que nous avons pu diagnostiquer remontait à un badge tenu à plat et loin, pas au symbole. Le même lot de codes a scanné 40 sur 40 de 20 à 60 cm sur des téléphones de test. Le mode d'échec est la géométrie, pas la symbologie : inclinez le badge vers la caméra et ça marche.

FAQ

Q1 : Comment créer un code QR pour mon dépôt GitHub ?

Copiez l'URL du dépôt avec https, collez-la dans un générateur QR URL et exportez à 400 px ou plus. Imprimez au moins 25 mm sur un badge ou une affiche.

Q2 : Un code QR peut-il ouvrir un dépôt GitHub sur un téléphone ?

Oui. La caméra du téléphone décode l'URL et le dépôt s'ouvre dans le navigateur, sans application GitHub ni connexion nécessaire pour les dépôts publics.

Q3 : Un code QR GitHub doit-il lier le dépôt ou le profil ?

Le dépôt pour une conférence projet ou un README, le profil pour le networking général. Un code de profil est aussi le plus court, ce qui garde le symbole petit.

Q4 : Les codes QR GitHub fonctionnent-ils dans les CV imprimés ?

Oui, à 15 à 20 mm avec des modules d'au moins 0,25 mm. Gardez la zone de silence dégagée et utilisez de l'encre sombre ; les recruteurs scannant sur téléphone rapportent des résultats fiables à cette taille.

Q5 : Puis-je mettre un code QR GitHub dans mon README ?

Oui, en tant qu'image de 64 à 128 px avec l'URL écrite à côté. GitHub le rend dans le navigateur, et cela donne aux lecteurs mobiles une entrée en un tap.

Q6 : Quelle est la taille minimale pour un code QR GitHub sur un badge de conférence ?

Environ 25 mm avec des modules de 0,35 mm et une zone de silence de quatre modules. Plus petit fonctionne pour les profils (version 2) mais donne moins de marge de scan.

Q7 : Un code QR GitHub peut-il lier une issue ou une pull request ?

Oui, toute URL GitHub publique fonctionne, y compris /issues/{n} et /pull/{n}. Les URL d'issues sont plus longues, donc le symbole atterrit en version 4.

Q8 : Ai-je besoin d'une application pour scanner un code QR GitHub ?

Non. Les applications caméra modernes Android et iPhone décodent les codes QR nativement et ouvrent le résultat dans le navigateur par défaut.

À lire aussi

Nous contacter