Siapkan berkas yang tepat
Panduan GitHub saat ini menerima berkas PNG, JPG, atau GIF di bawah 1 MB. Ukuran minimal yang disarankan adalah 640 × 320 piksel, dengan 1280 × 640 untuk tampilan terbaik. Mulailah dengan kanvas 2:1 yang lebih besar, lalu periksa keterbacaan pada ukuran yang jauh lebih kecil.
Untuk validator CSV fiktif, tata letak yang jelas dapat menampilkan nama proyek, “Periksa berkas CSV sebelum mengimpor”, dan contoh sederhana dari masukan hingga kesalahan. Hindari memaksakan seluruh sesi terminal ke dalam gambar kecil. Jauhkan teks penting dari tepi untuk mengantisipasi pemotongan gambar oleh platform berbagi.
Unggah dan periksa tautan yang dibagikan
Buka Settings repositori, temukan Social preview, pilih Edit, dan unggah gambar. Bagikan URL repositori publik di tempat audiens akan melihatnya. Periksa hasilnya di sana; unggahan yang berhasil tidak menjamin semua platform langsung mengganti pratinjau dalam cache.
- Pastikan gambar tersebut milik repositori yang Anda bagikan.
- Periksa format berkas, dimensi piksel, dan ukuran berkas sebelum mengunggah.
- Gunakan kontras yang mudah dibaca; periksa gambar transparan pada latar terang dan gelap.
- Jika gambar belum diperbarui, pastikan pengaturan repositori tersimpan dan periksa cache platform tujuan.
Jaga konsistensi pratinjau dengan proyek
Gunakan nama dan tujuan proyek yang sama pada gambar, README, dan pengumuman rilis. Jika tangkapan layar menampilkan fitur eksperimental, beri keterangan atau gunakan alur kerja yang stabil. Jangan menambahkan jumlah Star, logo pelanggan, atau klaim kinerja yang dibuat-buat.
Tinjau kembali gambar ketika kasus penggunaan utama proyek berubah. Pratinjau adalah sarana komunikasi, bukan jaminan tersendiri atas peringkat, rasio klik, atau GitHub Star.
Pertanyaan umum
Apakah ini sama dengan avatar pemilik repositori?
Tidak. Avatar pemilik mengidentifikasi akun. Pratinjau sosial repositori khusus mewakili proyek tertentu ketika tautannya dibagikan.
Bisakah pratinjau menggunakan latar transparan?
GitHub mendukung transparansi PNG. Periksa kontras pada latar yang berbeda; latar solid merupakan pilihan praktis ketika tampilan tujuan belum pasti.
Mengapa saya masih melihat pratinjau lama setelah mengunggah?
Pastikan terlebih dahulu bahwa gambar baru tersimpan di repositori yang benar. Platform berbagi dapat menyimpan pratinjau dalam cache; perilaku penyegarannya terpisah dari pengaturan repositori.