Crea un código QR para un perfil o repo de GitHub
Pega la dirección, dale al código el estilo de tu pegatina o tu diapositiva y descárgalo listo para imprimir, apuntado a una URL que seguirá resolviendo después del próximo cambio de nombre.
Se abre en Google Maps. Las coordenadas también funcionan: 37.4224, -122.0841.
El código abre el formulario «Escribir una reseña» de tu negocio. Pega el ID de lugar o un enlace de Google Maps que lo contenga.
Un enlace UPI no lleva suma de verificación: un ID mal escrito genera un código que se escanea perfectamente y le paga a otra persona. Pega el ID desde tu app de pagos en lugar de teclearlo, y mándate una rupia antes de imprimir.
Pégala exactamente como la copiaste. KoloQR no arma el payload: codifica el que emitió tu banco y lo comprueba antes de que lo imprimas.
SVG, PNG, JPG • Máx. 2 MB
¿Qué es un código QR de GitHub?
Un código QR de GitHub es un código QR que guarda una dirección de github.com: un perfil, un repositorio, una release, un gist o un archivo en un commit concreto. Al escanearlo se abre esa página en el navegador del móvil. GitHub no exige app para leer un repositorio, así que el escaneo funciona en cualquier teléfono.
¿Qué URL de GitHub debería ir en el código?
GitHub tiene varias direcciones para la misma cosa, y envejecen a ritmos muy distintos:
- github.com/owner/repo/releases/latest - siempre redirige a la release publicada más reciente. Imprime esto en hardware o documentación en lugar de un número de versión que estará obsoleto en un mes.
- github.com/owner/repo/blob/<commit>/ruta - un enlace permanente a un archivo tal como estaba en un commit. Pulsar y en la página de un archivo reescribe la URL de rama a esta forma, y es el único enlace a archivo que no se pudre.
- github.com/owner/repo/blob/main/README.md - un enlace a rama. Cómodo, pero muestra lo que main contenga cuando se escanee, que para una referencia impresa pueden ser años de cambios después.
GitHub mantiene redirecciones cuando se renombra un repositorio o una cuenta, así que un código impreso no muere necesariamente con un cambio de nombre - pero esa redirección depende de que el nombre antiguo siga sin reclamar, y un nombre de usuario liberado puede registrarlo otra persona. Para cualquier cosa impresa en volumen, eso es motivo para codificar una URL corta de un dominio que controles y apuntarla a GitHub, de modo que una mudanza cueste editar una redirección en lugar de reimprimir.
Qué abre el escaneo en un móvil
La página de un repositorio en un móvil es una columna estrecha: la lista de archivos y, debajo, el README renderizado. Se lee bien, y por eso funciona un código en una pegatina de congreso o en la serigrafía de una placa de desarrollo. Dos cosas conviene saber antes de imprimir uno. Un repositorio privado muestra un 404 en lugar de un aviso para iniciar sesión a quien no lo tenga, así que un código apuntado a trabajo privado parece roto en vez de protegido: pruébalo desde un móvil sin sesión. Y una URL de archivo en bruto de raw.githubusercontent.com se descarga o se muestra como texto plano en lugar de abrir el repositorio, lo cual está bien para un archivo de configuración y mal para cualquier cosa pensada para que la lea una persona.
Generar código QR
Dónde se usan los códigos QR de GitHub
Un código en un objeto físico es el camino más corto entre el hardware, el papel o un escenario y el código fuente que hay detrás:
Cómo crear un código QR de GitHub
Del repositorio a la pegatina impresa en cuatro pasos:
Generar código QR- 1
Elige la URL que mejor envejezca
Un perfil para una tarjeta, /releases/latest para hardware y manuales, un enlace permanente a un commit para un fragmento de código. Evita enlaces de rama y números de versión en todo lo impreso.
- 2
Comprueba que resuelve sin sesión iniciada
Abre la URL en una ventana privada. Un repositorio privado devuelve un 404 en lugar de pedir inicio de sesión, y eso es lo que verá tu lector.
- 3
Pega el enlace y diseña el código
Elige el tipo URL y pega la dirección, luego escoge forma y colores. Módulos oscuros sobre fondo claro aguantan mejor una pegatina mate que un par invertido.
- 4
Pruébalo y expórtalo
Escanéalo desde un móvil y exporta SVG o PDF para pegatinas y serigrafía, PNG para diapositivas.
¿Qué formato de archivo deberías descargar?
KoloQR exporta tu código QR de GitHub en tres formatos. Elige por dónde va a verse:
- PNG para diapositivas, READMEs y sitios de documentación, donde el código se muestra a un tamaño fijo.
- SVG para pegatinas, artes de serigrafía y manuales impresos: todo lo que se escale sin ablandar los bordes.
- PDF para entregar a una imprenta de pegatinas o a un fabricante de placas con calidad lista para imprimir.
La longitud de la carga es lo que hay que vigilar en esta página. github.com/owner ronda los 25 caracteres y se imprime pequeño sin problemas; un enlace permanente a un archivo en el fondo de un árbol puede pasar de 100, y eso pide un símbolo mayor o una pegatina mayor. Si un enlace permanente largo tiene que ir en algo del tamaño de una uña, pon delante una redirección corta en tu propio dominio.
Generar código QRBuenas prácticas para códigos QR de GitHub
Un enlace impreso a una base de código tiene un trabajo que el código en sí no puede hacer: seguir siendo cierto más adelante.
Imprime /releases/latest, no un número de versión
Esa dirección siempre redirige a la release publicada más reciente, así que un manual o una etiqueta de dispositivo nunca nombran una versión superada.
Usa enlaces permanentes a commits para fragmentos de código
Un enlace a un archivo en una rama muestra lo que esa rama tenga al escanearlo. Un enlace permanente a un commit muestra lo que imprimiste al lado.
Comprueba que los repos privados devuelven 404
GitHub no invita a iniciar sesión a quien no puede ver un repositorio. Un código a trabajo privado parece roto a todo el que esté fuera de la organización.
No confíes en las redirecciones de renombrado para impresión duradera
Renombrar un repositorio o una cuenta deja una redirección, pero solo mientras el nombre antiguo siga libre. La serigrafía y el embalaje sobreviven a esa garantía.
Mantén la URL lo bastante corta para la superficie
Una URL de perfil se imprime feliz a 15 mm. Un enlace permanente profundo al mismo tamaño es un símbolo más denso en los mismos milímetros cuadrados, y ahí es donde empiezan a fallar los escaneos.
Prefiere la página del repositorio a un archivo en bruto
Un enlace a raw.githubusercontent.com entrega al móvil texto plano o una descarga. La página del repositorio renderiza el README, que es lo que la persona buscaba.
Etiqueta a dónde lleva el código
«Firmware y documentación» o «código de esta charla» junto al código es la diferencia entre un escaneo y un encogimiento de hombros.
Vigila el contraste en pegatinas oscuras
Módulos oscuros sobre fondo claro es lo que esperan las cámaras. Si la pegatina tiene que ser oscura, prueba la versión invertida en varios móviles antes de encargar una tirada.
Protege la zona de silencio
Cuatro módulos de margen limpio por cada lado, algo que se pierde fácil en una pegatina pequeña donde el arte llega hasta la línea de corte.
Dimensiónalo según la distancia
Aproximadamente una décima parte de la distancia de lectura: unos 2 cm en una pegatina de portátil, unos 20 cm en un póster leído a 2 metros.
Por qué tu código QR de GitHub no funciona
El patrón casi nunca es el problema en esta página. La URL de detrás normalmente sí, ya sea por lo que apunta o por lo larga que es.
El escaneo muestra una página 404
- Causa
- El repositorio es privado, o se renombró o se borró y el nombre antiguo lo ha tomado otra persona, lo que elimina la redirección.
- Solución
- Haz público el repositorio, o apunta el código a un perfil o a una página de documentación pública. Para lo impreso en volumen, codifica una redirección en tu propio dominio para que el destino siga siendo editable.
El código no se escanea en una pegatina pequeña
- Causa
- Se codificó un enlace permanente profundo o una ruta de archivo larga, así que el símbolo lleva muchos más módulos de los que una pegatina de 15 mm puede resolver.
- Solución
- Acorta el destino - el perfil, la raíz del repositorio o /releases/latest - o pon una URL corta de tu propio dominio delante de la larga, y regenera.
El escaneo descarga un archivo en vez de abrir una página
- Causa
- La URL es una dirección de raw.githubusercontent.com, que sirve el archivo en sí y no la página renderizada de GitHub.
- Solución
- Codifica en su lugar la dirección github.com/owner/repo/blob/... Deja los enlaces en bruto para máquinas - una configuración que descarga un script - y no para una persona con una cámara.
El código apunta a una versión antigua del proyecto
- Causa
- Se codificó la URL de una release etiquetada o un enlace de rama, y el proyecto siguió avanzando. El código hace exactamente lo que se le dijo.
- Solución
- Reimprime contra /releases/latest para descargas, o la raíz del repositorio para el código fuente. Ambas siguen al proyecto en lugar de fijarlo al día en que se hizo el arte.
¿Sigues sin saber si el fallo está en el archivo o en la impresión? Suelta la imagen exportada en el escáner de códigos QR: si se descodifica en el ordenador y no en papel, el fallo entró después del archivo.
Questions? Answered
Un código QR de GitHub guarda una dirección de github.com: un perfil, repositorio, release o archivo en un commit concreto. Al escanearlo se abre esa página en el navegador del móvil. No hace falta app ni cuenta para leer un repositorio público.
Un perfil para una tarjeta de visita, github.com/owner/repo/releases/latest para hardware y manuales, y un enlace permanente a un commit para un fragmento de código. Evita enlaces de rama y versiones fijadas en lo impreso.
GitHub redirige la dirección antigua a la nueva, así que el código impreso suele seguir funcionando, pero solo mientras el nombre antiguo siga sin reclamar. Si otra persona lo registra, la redirección se acaba y el código lleva a su proyecto.
Puedes, pero quien no tenga sesión iniciada recibe un 404 en lugar de una invitación a entrar, así que el código parece roto a todo el que esté fuera de la organización. Apunta lo impreso público a páginas públicas.
Codifica github.com/owner/repo/releases/latest. GitHub lo redirige a la release publicada más reciente, así que un código impreso en un aparato o en un manual nunca nombra una versión superada.
Una URL de perfil o de repositorio - unos 25 a 40 caracteres - se imprime fiable desde unos 15 mm. Un enlace permanente largo a un commit necesita un símbolo mayor, así que dale más espacio o acorta antes el destino.
Porque codifica una URL de raw.githubusercontent.com, que sirve el archivo en sí. Usa la dirección github.com/owner/repo/blob/... si quien va a leer la página es una persona y no una máquina que recoge el archivo.
Sí: exporta PNG y súbelo como cualquier otra imagen. Merece la pena cuando el README documenta hardware, para que el objeto impreso y el repositorio lleven el mismo código.
Sí. Los repositorios públicos se renderizan en cualquier navegador móvil, README incluido. La app no cambia nada respecto a si el escaneo resuelve.
Desde el código no, y las estadísticas de tráfico de GitHub solo cubren repositorios que te pertenecen. Codificar una redirección en tu propio dominio es la única forma fiable de contar escaneos de un póster o una tirada concreta.
Sigue explorando
Páginas que continúan donde esta termina: el mismo contexto, el mismo tipo de código o la siguiente decisión que tomar.
Código QR de Google Docs
Abre un documento, un material de clase o una plantilla desde una página impresa.
Bodas
Un código en la invitación que lleva a los invitados al formulario de confirmación, al horario y las indicaciones, y después a un álbum de fotos compartido.
Colegios y aulas
Autorizaciones, circulares, enlaces de biblioteca y trabajos del alumnado, con los tamaños de impresión y las reglas de privacidad que un colegio necesita de verdad.
Código QR de YouTube
Lleva a la gente directo a un canal, un vídeo concreto, una lista de reproducción o el aviso de suscripción.
Código QR de LinkedIn
Comparte tu perfil o tu página de empresa de LinkedIn con un código que lee la cámara de cualquier móvil.
Código QR de formulario
Abre una encuesta, una solicitud o un formulario de inscripción desde cualquier impreso.
¿Por qué KoloQR?
- Crea códigos QR para sitios web, menús, Wi-Fi, PDF y tarjetas de visita
- Personaliza colores, logotipos y formas únicas
- Descarga archivos PNG y SVG de alta calidad
- Pensado tanto para impresión como para digital
