Proje rehberleri

GitHub sosyal önizleme görseli: boyut, kurulum ve kontrol listesi

Bir deponun sosyal önizlemesi, bağlantısı paylaşıldığında insanların görebileceği görseldir. Projeyi tek bakışta anlatmak için kullanın: kısa bir ad, yararlı bir vaat ve anlaşılır bir örnek. README dosyasını tamamlar, onun yerini almaz.

GitHubStart yayın ekibi · Güncellendi

Doğru dosyayı hazırlayın

GitHub'ın güncel yönergeleri 1 MB altındaki PNG, JPG veya GIF dosyalarını kabul eder. En az 640 × 320 piksel, en iyi görüntü için ise 1280 × 640 önerilir. Daha büyük 2:1 tuvalle başlayın, ardından çok daha küçük bir boyutta okunabilirliği kontrol edin.

Hayalî bir CSV doğrulayıcısı için açık bir düzen; proje adını, “İçe aktarmadan önce CSV dosyalarını kontrol edin” ifadesini ve girdiden hataya uzanan basit bir örneği gösterebilir. Tüm terminal oturumunu küçük bir görsele sıkıştırmayın. Paylaşım yüzeyinin görseli kırpma ihtimaline karşı önemli metinleri kenarlardan uzak tutun.

Yükleyin ve paylaşılan bağlantıyı kontrol edin

Deponun Settings bölümünü açın, Social preview alanını bulun, Edit seçeneğini seçin ve görseli yükleyin. Herkese açık depo URL'sini kitlenizin göreceği yerde paylaşın. Sonucu orada kontrol edin; başarılı yükleme her platformun önbellekteki önizlemeyi hemen değiştireceğini garanti etmez.

  • Görselin paylaştığınız depoya ait olduğunu doğrulayın.
  • Yüklemeden önce dosya biçimini, piksel boyutlarını ve dosya boyutunu kontrol edin.
  • Okunaklı kontrast kullanın; saydam çizimleri açık ve koyu arka planlarda inceleyin.
  • Görsel eskiyse kaydedilen depo ayarını doğrulayın ve hedef platformun önbelleğini araştırın.

Önizlemeyi projeyle tutarlı tutun

Görselde, README dosyasında ve sürüm duyurusunda aynı proje adını ve amacını kullanın. Ekran görüntüsü deneysel bir özelliği gösteriyorsa bunu belirtin veya kararlı bir iş akışı kullanın. Uydurma yıldız sayıları, müşteri logoları veya performans iddiaları eklemeyin.

Projenin temel kullanım senaryosu değiştiğinde görseli yeniden değerlendirin. Önizleme bir iletişim aracıdır; sıralama, tıklama oranı veya GitHub yıldızları için ayrı bir garanti değildir.

Sık sorulan sorular

Bu, depo sahibinin avatarıyla aynı mı?

Hayır. Sahibin avatarı hesabı tanımlar. Özel depo sosyal önizlemesi, bağlantısı paylaşıldığında belirli bir projeyi temsil eder.

Önizlemede saydam arka plan kullanılabilir mi?

GitHub PNG saydamlığını destekler. Farklı arka planlarda kontrastı kontrol edin; hedefteki görünüm belirsizse düz bir arka plan pratik bir seçimdir.

Yüklemeden sonra neden hâlâ eski önizlemeyi görüyorum?

Önce yeni görselin doğru depoya kaydedildiğini doğrulayın. Paylaşım platformları önizlemeleri önbelleğe alabilir; yenileme davranışları depo ayarından ayrıdır.

Kaynaklar