Buat kode QR
Buat kode QR

Buat kode QR untuk profil atau repo GitHub

Tempel alamatnya, sesuaikan gaya kode dengan stiker atau salindia Anda, lalu unduh dalam kualitas siap cetak - diarahkan ke URL yang masih akan terbuka setelah penggantian nama berikutnya.

1 Konten
https://
Tanpa pendaftaran Kode QR tanpa batas Tanpa tanda air Free high-resolution downloads
2 Desain
Bentuk
Pola
Mata
3 Pratinjau
Tersalin!

Apa itu kode QR GitHub?

Kode QR GitHub adalah kode QR yang menyimpan alamat github.com - sebuah profil, repositori, rilis, gist, atau berkas pada commit tertentu. Memindainya membuka halaman itu di peramban ponsel. GitHub tidak mensyaratkan aplikasi untuk membaca repositori, jadi pindaiannya berfungsi di ponsel mana pun.

Designer KoloQR dengan kode QR yang sedang ditata - bentuk, warna, dan logo di tengah

URL GitHub mana yang sebaiknya masuk ke dalam kode

GitHub punya beberapa alamat untuk hal yang sama, dan ketahanannya sangat berbeda:

  • github.com/owner/repo/releases/latest - selalu dialihkan ke rilis terbit paling baru. Cetak ini pada perangkat keras atau dokumentasi, bukan nomor versi yang sebulan lagi sudah salah.
  • github.com/owner/repo/blob/<commit>/path - tautan permanen ke berkas sebagaimana adanya pada satu commit. Menekan y di halaman berkas mengubah URL cabang menjadi bentuk ini, dan hanya tautan berkas inilah yang tidak bisa lapuk.
  • github.com/owner/repo/blob/main/README.md - tautan cabang. Praktis, tetapi menampilkan apa pun isi main saat dipindai, yang untuk rujukan cetak bisa berarti perubahan bertahun-tahun kemudian.

GitHub tetap menyimpan pengalihan ketika repositori atau akun diganti nama, jadi kode cetak tidak otomatis mati karena penggantian nama - tetapi pengalihan itu bergantung pada nama lama yang tetap tak diklaim, dan nama pengguna yang dilepas bisa didaftarkan orang lain. Untuk apa pun yang dicetak dalam jumlah besar, itu alasan untuk mengodekan URL pendek di domain yang Anda kendalikan lalu mengarahkannya ke GitHub, sehingga perpindahan hanya butuh satu suntingan pengalihan alih-alih cetak ulang.

Apa yang benar-benar dibuka pindaian di ponsel

Halaman repositori di ponsel berupa kolom sempit: daftar berkas, lalu README yang dirender di bawahnya. Itu terbaca dengan baik, dan itulah sebabnya kode di stiker konferensi atau di sablon papan pengembang bisa berfungsi. Ada dua hal yang perlu diketahui sebelum mencetaknya. Repositori privat menampilkan 404 alih-alih ajakan masuk akun bagi orang yang tidak berwenang, jadi kode yang mengarah ke pekerjaan privat tampak rusak, bukan terlindungi - ujilah dari ponsel yang keluar akun. Dan URL berkas mentah di raw.githubusercontent.com akan mengunduh atau menampilkan teks polos alih-alih membuka repositori, yang cocok untuk berkas konfigurasi dan tidak cocok untuk apa pun yang dimaksudkan dibaca manusia.

Buat kode QR
Ponsel memindai kode QR cetak untuk diuji sebelum produksi

Di mana kode QR GitHub digunakan

Kode pada benda fisik adalah jalan terpendek dari perangkat keras, kertas, atau panggung menuju kode sumber di baliknya:

Stiker dan tanda pengenal konferensi

Stiker berkode mengalahkan nama repositori yang disebut dari panggung lalu setengah terlupakan di perjalanan pulang.

Perangkat keras dan papan pengembang

Kode yang disablon di papan atau dicetak di kemasan mengarah ke repositori firmware dan rilis terbarunya, selama umur perangkat itu.

Dokumentasi dan buku panduan cetak

Buku panduan sudah usang di hari ia dicetak. Kode menuju folder dokumentasi di repositori adalah versi yang tidak ikut usang.

Salindia dan materi lokakarya

Satu kode di salindia terakhir, diarahkan ke tautan permanen, agar contoh yang disalin orang adalah contoh yang mereka lihat.

Kartu nama pengembang

Kode profil membawa karyanya sendiri, bukan penjelasan tentang karya itu - dan itulah gunanya kartu nama.

Poster di hackathon dan demo day

Juri atau pengunjung memindai poster dan proyeknya sudah terbuka sebelum mereka sampai ke meja berikutnya.

Cara membuat kode QR GitHub

Dari repositori sampai stiker tercetak dalam empat langkah:

Buat kode QR
  1. 1

    Pilih URL yang paling tahan waktu

    Profil untuk kartu nama, /releases/latest untuk perangkat keras dan panduan, tautan permanen commit untuk cuplikan kode. Hindari tautan cabang dan nomor versi pada apa pun yang dicetak.

  2. 2

    Pastikan alamatnya terbuka saat keluar akun

    Buka URL itu di jendela penyamaran. Repositori privat mengembalikan 404 alih-alih ajakan masuk akun, dan itulah yang akan dilihat pembaca Anda.

  3. 3

    Tempel tautannya dan rancang kodenya

    Pilih tipe URL dan tempel alamatnya, lalu pilih bentuk dan warna. Modul gelap di atas latar terang bertahan lebih baik pada stiker doff dibanding pasangan warna terbalik.

  4. 4

    Uji lalu ekspor

    Pindai dari ponsel, lalu ekspor SVG atau PDF untuk stiker dan sablon, serta PNG untuk salindia.

Generator KoloQR dengan kode QR yang sedang dirancang dan siap diunduh

Format file mana yang sebaiknya Anda unduh?

KoloQR mengekspor kode QR GitHub Anda dalam tiga format. Pilih berdasarkan tempat kode itu akan dilihat:

  • PNG untuk salindia, README, dan situs dokumentasi, di mana kode tampil dalam satu ukuran tetap.
  • SVG untuk stiker, materi sablon, dan buku panduan cetak - apa pun yang diperbesar tanpa membuat tepinya melunak.
  • PDF untuk diserahkan ke percetakan stiker atau pabrikan papan sirkuit dengan kualitas siap cetak.

Di halaman ini yang perlu diawasi adalah panjang muatan. github.com/owner panjangnya sekitar 25 karakter dan nyaman dicetak kecil; tautan permanen commit ke berkas yang dalam di pohon direktori bisa melewati 100 karakter, dan itu menuntut simbol atau stiker yang lebih besar. Kalau tautan permanen panjang harus muat di benda seukuran kuku, taruh pengalihan pendek di domain Anda sendiri di depannya.

Buat kode QR

Praktik terbaik untuk kode QR GitHub

Tautan cetak ke sebuah basis kode punya satu tugas yang tidak bisa dikerjakan kodenya sendiri: tetap benar di kemudian hari.

  • Cetak /releases/latest, bukan nomor versi

    Alamat itu selalu dialihkan ke rilis terbit paling baru, sehingga buku panduan atau label perangkat tidak pernah menyebut versi yang sudah digantikan.

  • Pakai tautan permanen commit untuk cuplikan kode

    Tautan ke berkas pada sebuah cabang menampilkan apa pun isi cabang itu saat dipindai. Tautan permanen ke commit menampilkan persis yang Anda cetak di sebelahnya.

  • Periksa bahwa repositori privat mengembalikan 404

    GitHub tidak mengajak pengunjung yang keluar akun untuk masuk demi repositori yang tak boleh mereka lihat. Kode ke pekerjaan privat tampak rusak bagi semua orang di luar organisasi.

  • Jangan bergantung pada pengalihan penggantian nama untuk cetakan berumur panjang

    Mengganti nama repositori atau akun meninggalkan pengalihan, tetapi hanya selama nama lama tidak diklaim. Sablon dan kemasan hidup lebih lama daripada jaminan itu.

  • Jaga URL tetap cukup pendek untuk permukaannya

    URL profil tercetak nyaman pada 15 mm. Tautan permanen yang dalam pada ukuran yang sama menjadi simbol lebih padat di milimeter persegi yang sama, dan di situlah pindaian mulai gagal.

  • Lebih baik halaman repositori daripada berkas mentah

    Tautan raw.githubusercontent.com menyodorkan teks polos atau unduhan ke ponsel. Halaman repositori merender README, dan itulah yang dicari orang saat memindai.

  • Beri label ke mana kode itu menuju

    “Firmware dan dokumentasi” atau “kode sumber untuk sesi ini” di samping kode adalah beda antara sebuah pindaian dan sekadar angkat bahu.

  • Perhatikan kontras pada stiker gelap

    Modul gelap di atas latar terang adalah yang diharapkan kamera. Kalau stikernya memang harus gelap, uji versi terbaliknya di beberapa ponsel sebelum memesan produksi.

  • Lindungi zona hening

    Empat modul margin bersih di setiap sisi - mudah hilang pada stiker kecil yang desainnya mepet garis potong.

  • Sesuaikan ukurannya dengan jarak baca

    Kira-kira sepersepuluh jarak baca: sekitar 2 cm di stiker laptop, sekitar 20 cm di poster yang dibaca dari 2 meter.

Kenapa kode QR GitHub Anda tidak berfungsi

Di halaman ini polanya jarang menjadi masalah. URL di baliknya biasanya yang bermasalah - entah karena apa yang ditunjuknya, entah karena panjangnya.

  • Pindaian menampilkan halaman 404

    Penyebab
    Repositorinya privat, atau sudah diganti nama maupun dihapus dan nama lamanya kini diambil orang lain, yang membuat pengalihannya hilang.
    Solusi
    Jadikan repositorinya publik, atau arahkan kode ke profil maupun halaman dokumentasi publik. Untuk apa pun yang dicetak banyak, kodekan pengalihan di domain Anda sendiri agar tujuannya tetap bisa diubah.

  • Kode tidak terbaca di stiker kecil

    Penyebab
    Yang dikodekan adalah tautan permanen yang dalam atau jalur berkas yang panjang, sehingga simbolnya membawa jauh lebih banyak modul daripada yang bisa ditangkap stiker 15 mm.
    Solusi
    Perpendek tujuannya - profil, akar repositori, atau /releases/latest - atau taruh URL pendek dari domain Anda di depan yang panjang, lalu buat ulang kodenya.

  • Pindaian mengunduh berkas alih-alih membuka halaman

    Penyebab
    URL-nya adalah alamat raw.githubusercontent.com, yang menyajikan berkasnya sendiri, bukan halaman terender milik GitHub.
    Solusi
    Kodekan alamat github.com/owner/repo/blob/... sebagai gantinya. Simpan tautan mentah untuk mesin - misalnya konfigurasi yang diambil skrip - bukan untuk manusia berkamera.

  • Kode menunjuk versi proyek yang lama

    Penyebab
    Yang dikodekan adalah URL rilis bertag atau tautan cabang, sementara proyeknya sudah bergerak maju. Kodenya melakukan persis seperti yang diperintahkan.
    Solusi
    Cetak ulang mengarah ke /releases/latest untuk unduhan, atau ke akar repositori untuk kode sumber. Keduanya mengikuti proyek alih-alih memakukannya pada hari desainnya dibuat.

Masih ragu apakah masalahnya ada di berkas atau di hasil cetak? Jatuhkan gambar hasil ekspor ke pemindai kode QR - kalau terbaca di komputer tetapi tidak di kertas, masalahnya muncul setelah berkas.

Questions? Answered

Kode QR GitHub menyimpan alamat github.com - profil, repositori, rilis, atau berkas pada commit tertentu. Memindainya membuka halaman itu di peramban ponsel. Membaca repositori publik tidak butuh aplikasi maupun akun.

Profil untuk kartu nama, github.com/owner/repo/releases/latest untuk perangkat keras dan buku panduan, dan tautan permanen commit untuk cuplikan kode. Hindari tautan cabang dan nomor versi tetap pada materi cetak.

GitHub mengalihkan alamat lama ke yang baru, jadi kode cetak biasanya tetap bekerja - tetapi hanya selama nama lama tidak diklaim. Kalau orang lain mendaftarkannya, pengalihannya berhenti.

Bisa, tetapi pengunjung yang keluar akun mendapat 404 alih-alih ajakan masuk, jadi kodenya tampak rusak bagi semua orang di luar organisasi. Arahkan materi cetak publik ke halaman publik.

Kodekan github.com/owner/repo/releases/latest. GitHub mengalihkannya ke rilis terbit paling baru, sehingga kode yang tercetak di perangkat atau buku panduan tidak pernah menyebut versi yang sudah digantikan.

URL profil atau repositori - sekitar 25 sampai 40 karakter - tercetak andal mulai sekitar 15 mm. Tautan permanen commit yang panjang butuh simbol lebih besar, jadi beri ruang lebih atau perpendek dulu tujuannya.

Karena yang dikodekan adalah URL raw.githubusercontent.com, yang menyajikan berkasnya sendiri. Gunakan alamat github.com/owner/repo/blob/... bila yang membaca halaman itu manusia, bukan mesin yang mengambil berkas.

Bisa - ekspor PNG lalu commit seperti gambar lain. Ini berguna ketika README mendokumentasikan perangkat keras, agar benda cetaknya dan repositorinya membawa kode yang sama.

Berfungsi. Repositori publik tampil di peramban ponsel mana pun, termasuk README-nya. Ada tidaknya aplikasi tidak mengubah apakah pindaian itu terbuka.

Tidak dari kodenya, dan statistik lalu lintas GitHub hanya mencakup repositori milik Anda. Mengodekan pengalihan di domain sendiri adalah satu-satunya cara andal menghitung pindaian dari poster atau produksi cetak tertentu.

Lanjutkan menjelajah

Halaman yang melanjutkan dari tempat halaman ini berhenti: konteks yang sama, jenis kode yang sama, atau keputusan berikutnya.

Kode QR Google Dokumen

Membuka dokumen, materi ajar, atau templat langsung dari halaman cetak.

Pernikahan

Satu kode pada undangan, menautkan tamu ke formulir RSVP, jadwal dan petunjuk arah, serta album foto bersama setelahnya.

Sekolah dan ruang kelas

Surat izin, surat edaran, tautan perpustakaan, dan karya siswa, dengan ukuran cetak serta aturan privasi yang benar-benar dibutuhkan sekolah.

Kode QR YouTube

Mengarahkan orang langsung ke sebuah kanal, satu video, sebuah playlist, atau ajakan berlangganan.

Kode QR LinkedIn

Bagikan profil atau halaman perusahaan LinkedIn Anda lewat kode yang bisa dibaca kamera ponsel mana pun.

Kode QR formulir

Membuka survei, lamaran, atau formulir pendaftaran dari media cetak apa pun.

Mengapa KoloQR?

  • Buat kode QR untuk situs web, menu, Wi-Fi, PDF, dan kartu nama
  • Sesuaikan warna, logo, dan bentuk unik
  • Unduh file PNG dan SVG berkualitas tinggi
  • Dibuat untuk cetak maupun digital
Buat kode QR
Kode QR hitam polos di samping kode yang sama yang didesain ulang menjadi lingkaran dengan warna merek