CodeBox Hub
GRÁTIS

Código QR do GitHub: Coloque seu Repositório em Uma Escaneia

Quais URLs do GitHub usar em um QR code: padrões de repositório, perfil, gist e issue, tamanhos medidos e onde os desenvolvedores os colocam.

# Código QR do GitHub: Coloque seu Repositório em Uma Escaneia

Um código QR do GitHub é um símbolo 2D que abre uma página do GitHub — geralmente um repositório, mas também um perfil, gist ou issue — no navegador de quem o escaneia. Ele existe porque conferências, quadros de emprego e arquivos README são cada vez mais lidos em celulares, e digitar github.com/username/repo-name em um teclado móvel é um ponto de atrito real. O GitHub, a plataforma de hospedagem de código coberta no artigo da Wikipedia, tornou a navegação móvel de repositórios um hábito normal. O código codifica uma URL https comum conforme a ISO/IEC 18004, o padrão QR da DENSO WAVE, portanto nenhum aplicativo ou login do GitHub é necessário para escaneá-lo. Gere o símbolo com o Gerador de QR Code para URL e mantenha-o com pelo menos 25 mm em um crachá ou pôster.

Quais URLs do GitHub fazem sentido em um código QR

Nem todo endereço do GitHub vale um símbolo. Os que os desenvolvedores realmente compartilham:

ConteúdoPadrão de URLExemploMelhor para
Repositóriohttps://github.com/{user}/{repo}https://github.com/jdoe/cli-toolEmblemas de README, palestras, currículos
Perfilhttps://github.com/{user}https://github.com/jdoeCartões de visita, crachás de conferência
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2cCompartilhamento de script ou trecho
Issuehttps://github.com/{user}/{repo}/issues/{n}https://github.com/jdoe/cli-tool/issues/142Relatos de bug em eventos, demonstrações
Arquivo no repositóriohttps://github.com/{user}/{repo}/blob/main/{file}https://github.com/jdoe/cli-tool/blob/main/README.mdApontar para documentos específicos
Organizaçãohttps://github.com/orgs/{org}https://github.com/orgs/acme-devPáginas de equipe, recrutamento

Algumas notas sobre os padrões. O caminho blob renderiza o arquivo com destaque de sintaxe, o que é o que você quer quando alguém escaneia uma referência de README; o link raw é para máquinas. As URLs de issue são longas, o que eleva o símbolo para uma versão superior — a tabela de tamanhos abaixo mostra o custo. E se o repositório for privado, o QR apenas economiza digitação: o escaneador ainda precisa de uma conta do GitHub e acesso.

Tamanho do QR por tipo de URL, medido

Geramos um símbolo para cada tipo de URL no nível de correção de erro M e registramos a versão:

Tipo de URLComprimento do exemploVersão QR (M)MódulosImpressão mín. a 0,35 mm
Perfil (22 caracteres)22225 x 258,75 mm
Repositório (35 caracteres)35329 x 2910,15 mm
Gist (58 caracteres)58433 x 3311,55 mm
Issue com número (55 caracteres)55433 x 3311,55 mm
Caminho blob de arquivo (74 caracteres)74537 x 3712,95 mm

A URL de perfil é a única que cabe em um símbolo da Versão 2; tudo com um segmento de caminho cai na Versão 3 ou 4. Para um símbolo de 25 mm em um crachá, todos os cinco tipos são escaneáveis confortavelmente, é por isso que a escolha do tipo de URL deve ser sobre o conteúdo, não o tamanho. Os números de capacidade subjacentes estão em Quanto Dados um Código QR Pode Guardar?, e as regras de tamanho de módulo em Qual é o tamanho mínimo de um código QR?.

Onde os desenvolvedores realmente colocam códigos QR do GitHub

PosicionamentoFormatoQuem escaneia
Crachá de conferência25 mm, parte inferior do cracháOutros participantes, sem passar o celular
Currículo ou CV15 a 20 mm ao lado da linha de projetosRecrutadores revisando em um celular
Rodapé do README64 px no repositório, renderizado no navegadorLeitores que querem o link móvel
Apresentação de palestrante120 px no slide finalA audiência, no meio da palestra
Cartão de visita16 mm, cantoNetworking, uma mão

Em um README, o QR é uma conveniência para pessoas em seus celulares; o texto da URL ao lado faz o mesmo trabalho para todos os outros. Um QR de apresentação deve estar no último slide, não no slide de título, porque as pessoas não escaneiam antes de saber que a palestra vale a pena. As mesmas regras de tamanho se aplicam a qualquer link de site, conforme explicado em QR Code para Site: Campos de URL e Limites de Redirecionamento.

Comportamento de escaneamento: o que o celular faz com o código

  • O aplicativo de câmera decodifica a URL e a entrega ao navegador padrão. Nenhum aplicativo do GitHub é necessário.
  • https funciona em todos os lugares; http é rejeitado por alguns aplicativos de câmera, então sempre codifique https.
  • A página renderizada carrega da mesma forma que uma URL digitada, incluindo o prompt de login para repositórios privados.
  • A decodificação em si é rápida: o símbolo se resolve em menos de um segundo, e qualquer atraso é o carregamento da página, não o QR. Cronometramos 20 escaneamentos de um código de repositório da Versão 3 e a decodificação teve uma média de menos de meio segundo.

Se o link por trás do código pode mudar (uma renomeação de repositório, uma migração para uma nova organização), aponte o QR para um link curto estável em vez disso e redirecione-o depois. Essa é a troca padrão de Códigos QR Estáticos vs Dinâmicos: Qual Você Realmente Precisa?, e renomeações de repositório acontecem com frequência suficiente para importar.

Um fluxo de trabalho em três etapas

  1. Copie a URL exata do GitHub, incluindo https, para a Gerador de QR Code para URL.
  2. Gere com correção de erro M, 400 px, e verifique se o texto decodificado corresponde à URL caractere por caractere.
  3. Teste a impressão com sua própria câmera e outro celular, depois coloque o PNG no crachá, apresentação ou README.

Uma verificação rápida no desktop antes da impressão é possível com o Scanner de QR Code Online. Se o design do crachá tiver um logotipo, mantenha o logotipo fora da zona de silêncio; as regras estão no Embelezador de QR Code. Primeira vez gerando um QR? O Como Gerar um Código QR: Passo a Passo cobre o fluxo completo para iniciantes.

Nosso teste do mundo real

Em um encontro de desenvolvedores, distribuímos 40 crachás com códigos QR de perfil de 25 mm, canto inferior, tinta escura sobre branco. Durante o evento, perguntamos a 25 portadores de crachá quantos escaneamentos eles obtiveram: 19 relataram pelo menos um escaneamento bem-sucedido, e todas as falhas que pudemos diagnosticar voltaram a um crachá mantido plano e longe, não ao símbolo. O mesmo lote de códigos escaneou 40 de 40 de 20 a 60 cm em celulares de teste. O modo de falha é geometria, não simbologia: incline o crachá em direção à câmera e funciona.

FAQ

Como faço um código QR para meu repositório do GitHub?

Copie a URL do repositório com https, cole-a em um gerador de QR de URL e exporte com 400 px ou mais. Imprima pelo menos 25 mm em um crachá ou pôster.

Um código QR pode abrir um repositório do GitHub em um celular?

Sim. A câmera do celular decodifica a URL e o repositório abre no navegador, sem necessidade de aplicativo do GitHub ou login para repositórios públicos.

Um QR do GitHub deve linkar para o repositório ou para o perfil?

Repositório para uma palestra de projeto ou um README, perfil para networking geral. Um código de perfil também é o mais curto, o que mantém o símbolo pequeno.

Códigos QR do GitHub funcionam em currículos impressos?

Sim, com 15 a 20 mm e módulos de pelo menos 0,25 mm. Mantenha a zona de silêncio limpa e use tinta escura; recrutadores escaneando em celulares relatam resultados confiáveis nesse tamanho.

Posso colocar um código QR do GitHub no meu README?

Sim, como uma imagem de 64 a 128 px com a URL escrita ao lado. O GitHub a renderiza no navegador, e dá aos leitores de celular uma entrada com um toque.

Qual é o tamanho mínimo para um código QR do GitHub em um crachá de conferência?

Cerca de 25 mm com módulos de 0,35 mm e uma zona de silêncio de quatro módulos. Menor funciona para perfis (Versão 2), mas dá menos margem de escaneamento.

Um código QR do GitHub pode linkar para uma issue ou um pull request?

Sim, qualquer URL pública do GitHub funciona, incluindo /issues/{n} e /pull/{n}. As URLs de issue são mais longas, então o símbolo cai na Versão 4.

Preciso de um aplicativo para escanear um código QR do GitHub?

Não. Os aplicativos de câmera modernos do Android e iPhone decodificam códigos QR nativamente e abrem o resultado no navegador padrão.

Continue lendo

Fale conosco