Mini ders · Türkçe

Bağlantı paylaşırken sitenizin önizlemesi nasıl düzeltilir

Asistana başlık, açıklama ve verilen resmi verin; ardından gerçek herkese açık bağlantının ürettiği kartı kontrol edin.

Etkileşimli derse başlaDers notlarını oku

Bu ders kimler için?

Paylaşılan bağlantılarında önizlemesi eksik veya yanıltıcı olan web sitesi sahipleri için. Kodlama asistanı sayfa üst verilerini ekleyebilir; siz gerçek paylaşım kartını incelersiniz.

Başlamadan önce

Kendi herkese açık HTTPS alıştırma sayfanız ve verilen paylaşım kartı resmi. Asistan dosyalarını düzenleyip yayımlayabilir. Sosyal platformlar özel localhost sayfasını alamaz ve önbellekteki önizlemelerinin yenilenmesi gerekebilir.

Tahmini süre: 15–27 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Platformlar sonuçları önbelleğe alır ve ne göstereceklerine kendileri karar verir. Yerel meta veri kontrolü, canlı LinkedIn, Slack veya WhatsApp önizlemesini kanıtlayamaz.

Neler öğreneceksin?

  • Hedeflenen başlığı, açıklamayı ve resmi bağlayın.
  • Resmin herkese açık biçimde alınabildiğini kontrol edin.
  • Gerçek platform önizlemesini ve sınırlarını inceleyin.

Uygulama dosyaları

Adım 1

Paylaşmak istediğiniz kartı seçin

Önizleme, herkese açık biçimde alınabilen sayfadan üretilir.

Sağlanan sayfayı açın. Başlığı “Practical notes for building a website”; share-card.jpg içeriyor. Bu başlığın, kısa açıklamanın ve resmin, ziyaretçinin açacağı şeyi doğru anlatıp anlatmadığına karar verin.

Asistana gerçek herkese açık HTTPS sayfa adresinizi verip bu değerleri paylaşım için bağlamasını isteyin. Ayrılmış https://YOUR-SITE.example/ kök adresi şablondur; yalnızca dizüstünüzde bulunan resmi bir platform alamaz.

Somut bir örnek

Sağlanan açıklama “Small examples, working files and clear checks for your next website feature.” şeklindedir. Başlıkla birlikte, ilgisiz ana sayfa yerine pratik web sitesi notları vaat eder.

Verilen sayfayı ve paylaşım resmini kullan. Görünür içerikle tutarlı olacak şekilde yazıya özgü hedeflenen başlığı, açıklamayı ve mutlak herkese açık resim URL'sini ekle. Yayımlanan sayfayı/resmi oturum kapalıyken kontrol etmeme, ardından gerçek paylaşım önizlemesini incelememe yardım et. Üst veri kodunu sen düzenle. Yalnızca yerel resimden veya sağlayıcıya gönderilen önbellek yenileme isteğinden platformun güncellendiği sonucunu çıkarma.

Open Graph: temel meta veriler

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Paylaşılan bağlantı nereye gittiğini anlatsın

Önizleme için sayfa meta verileri ve platformun gerçekten alabileceği bir görsel gerekir.

Paylaşım önizlemesi genellikle platformun URL’nizi getirip meta verileri okumasıyla oluşturulur. Oturum açık tarayıcınızda gördüğünüzün ekran görüntüsünden ibaret değildir.

Bu ders eksiksiz bir sayfa head bölümü ve yeni bir paylaşım görseli sağlar. Ayrılmış örnek alan adını değiştirecek, kendi deneme sayfanızı yayımlayacak ve oturumsuz bir isteğe ne döndüğünü inceleyeceksiniz.

Çözülmüş örnek

İyi bir başlık sayfanın ne sunduğunu anlatır. “My site” (Sitem), ardından kısa açıklama gelen “Practical notes for building a website” (Site yapmak için uygulamalı notlar) başlığından çok daha az bağlam verir.

Open Graph: temel meta veriler

Extra implementation exercise

Küçük görsel neden dizüstü bilgisayarınızda çalışıp Slack’te görünmeyebilir?

Çözülmüş örneği göster

Platform localhost’a veya kimliği doğrulanmış oturumunuza erişemez. Ayrıca tam paylaşılan adreste erişilebilir bir görsel URL’si ve doğru HTML meta verileri gerekir.

  • Platformun herkese açık ağ erişimine ihtiyaç duyduğunu fark eder.
  • Paylaşılan URL’yi ve görseli bağımsız olarak kontrol eder.

Adım 2

Yayımlanan resmi kontrol edin

Kartın gerçekten referans verdiği resim yolunu inceleyin.

Hazır olduğunuzda alıştırma değişikliğini yayımlayın; ardından gerçek paylaşım resmi URL'sini oturum kapalıyken açın. Asistandan bunun eksik dosya veya giriş sayfası yerine hedeflenen resim olduğunu doğrulamasını isteyin.

Sayfada görünen resmi değiştirmek, paylaşım için kullanılan ayrı resim değerini mutlaka değiştirmez. Sunulan referansı da doğrulayın.

Somut bir örnek

Resim adresi share-card.jpg yerine sitenin HTML ana sayfasını açarsa sunucu yine 200 döndürebilir. Adres sayfa olarak çalışır ama karta resim sağlamaz.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Önizlemeyi ilk gelen HTML’e koyun

Dışarıdan yapılan istekte de çalışan mutlak canonical ve görsel URL’leri kullanın.

Verilen head bölümünü inceleyin. og:title, og:description, og:type, og:url ve og:image tam olarak bu sayfayı tanımlar. Uzak bir tarayıcı botu belirsiz olmayan bir hedefe ihtiyaç duyduğu için görsel yolu mutlaktır.

YOUR-SITE.example değerini her yerde değiştirin. Görsel, atölyeyle birlikte verilen gerçek bir dosyadır. Temel meta verileri yüklemeden sonra eklemek için tarayıcı JavaScript’ine güvenmeyin; botların davranışı değişir.

Verilen yatay kart 1672 × 941 pikseldir. Platformlar farklı kırpma veya boyutlandırma yapabilir; anlamlı ayrıntıları kenarlardan uzak tutun ve gerçek sonucu inceleyin. Bu bir başlangıç görselidir, her platformun aynı kırpmayı göstereceğinin garantisi değildir. Dağıtılan public klasöründe share-card.jpg bulunduğunu doğrulayın.

Bir platformu denemeden önce, dağıtılmış tam og:image URL’nizi oturum kapalıyken açın ve gerçek görselin göründüğü başarılı bir image/jpeg yanıtı doğrulayın. Dosyanın eksik olması, ayrılmış örnek alan adı veya yerine HTML dönmesi bu kontrolden geçmez.

Çözülmüş örnek

Görünen gövdedeki doğru göreli görsel, bozuk mutlak og:image adresini düzeltmez. Aynı olduklarını varsaymak yerine iki hedefi de inceleyin.

<meta property="og:image"
  content="https://YOUR-SITE.example/share-card.jpg">
<meta property="og:type" content="website">

Extra implementation exercise

Görünen sayfa görselini değiştirdiniz ama og:image eksik bir dosyayı gösteriyor. Bot hangi görseli deneyecek?

Çözülmüş örneği göster

Genellikle meta verideki, hâlâ bozuk olan görseli deneyecektir. og:image URL’sini düzeltin ve gerçek yanıtını doğrulayın.

  • Meta verideki hedefi okur.
  • Önizleme verisini oluşturulmuş sayfa gövdesinden çıkarsamaz.

Adım 3

Gerçek platform önizlemesini inceleyin

Uzaktan almayı ve önbelleği dikkate alın.

Yayımladıktan sonra sayfa ve resim adreslerini oturum kapalı inceleyin. Ardından varsa LinkedIn Post Inspector gibi platform aracı kullanın veya deneme bağlantısını özel paylaşarak gerçek kartını inceleyin. Görünen başlığı, açıklamayı ve resim kırpımını karşılaştırın.

Platformu ve ne gösterdiğini yazın. Herkese açık dosyalar güncel ama platform eski kartı gösteriyorsa önbelleğini araştırın; yenileme istemek görünür sonuç değil, bir adımdır.

Somut bir örnek

Örnek karşılaştırma: Herkese açık sayfa yeni başlığı ve JPEG’i sağlıyor; incelenen platform hâlâ eski başlık gösteriyor. Bu, bütün platformların yenilendiğinin kanıtı değil, platforma özgü önbellek sonucuna işaret eder.

LinkedIn Post Inspector · Meta Sharing Debugger

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Önbelleği suçlamadan önce yanıtı kontrol edin

Ham HTML’i, yönlendirmeleri ve görsele erişimi doğrulayın; sonra platformu test edin.

Tam paylaşılan URL’yi oturumu kapalı tarayıcıda açıp ham kaynağı inceleyin. Yönlendirmeleri izleyin ve son durum kodunu kontrol edin. Görseli ayrı isteyin: yerine HTML dönmek yerine uygun içerik türüyle görsel baytları dönmelidir.

Sunucu çıktısı doğru olduktan sonra, varsa platformun inceleme aracını kullanın ve yeni paylaşım deneyin. Mevcut mesajlar önbellekteki önizlemeyi tutabilir. Kendi tarayıcı önbelleğinizi yenilemek sosyal platformun önbelleğini temizlemez.

Örneğin kendi hesabınızla LinkedIn Post Inspector’ı açıp tam herkese açık URL’yi girin. Meta Sharing Debugger başka bir platforma özgü araçtır ve giriş isteyebilir. Tarayıcı geliştirici araçlarında Network içinden görsel isteğini seçin; Headers → Content-Type değerini ve yanıt önizlemesini inceleyin. Platform araçları yine de erişilemez olabilir veya önbellekten sonuç verebilir.

Hedef sayfaya/görsele, sahibi olarak açtığınız oturum olmadan ziyaretçi veya bot erişebilmelidir. Hata ayıklama aracı ayrı konudur: LinkedIn ya da Meta, inceleme aracını kullanmak için giriş yapmanızı isteyebilir. Araca giriş yapmak özel hedefi taranabilir kılmaz. Araç erişiminiz yoksa bu sınırlamayı kaydedin; ham yanıt kontrollerini gözlemlemediğiniz platform önizlemesinden ayrı tutun.

WhatsApp veya Slack için herkese açık deneme URL’sini kontrolünüzdeki test konuşmasında paylaşabilir, önizlemeyi veya görünmediğini kaydedebilirsiniz. Yalnızca HTTP yanıtlarını incelediyseniz platform testinin geçtiğini söylemeyin; hesap ya da araç yoksa bu sınırı kaydedin.

Çözülmüş örnek

200 text/html dönen görsel isteği aslında tek sayfalı uygulamanın varsayılan HTML yanıtı olabilir. Yalnızca 200 durum kodu görsel sunulduğunu kanıtlamaz.

LinkedIn Post Inspector · Meta Sharing Debugger

Extra implementation exercise

og:image isteği 200 ile giriş sayfası döndürüyor. Görsel kontrolü başarılı mı?

Çözülmüş örneği göster

Hayır. Bot görsel yerine HTML aldı. Görsel URL’sinin oturum açmadan gerçek dosyayı döndürmesi için yönlendirmeyi/erişimi düzeltin.

  • Durum koduyla birlikte içerik türünü ve gövdeyi de kontrol eder.
  • Gerçek görsel baytlarına oturum açmadan erişilmesini gerekli görür.

Adım 4

Yazıya özgü kartı tamamlayın

Paylaşılan kimlikle gerçek sayfayı uyumlu tutun.

Asistandan sağlanan “Fix a mismatched contact link” referans yazısını kendi paylaşım başlığı, açıklaması ve sayfa adresiyle eklemesini isteyin. share-card.jpg yeniden kullanılabilir; kimliği yine de ana sayfa yerine o yazıyı anlatmalı.

Yazıyı deneme sitenizde yayımlayın; tam herkese açık sayfasını ve resmini açıp platform kartını yeniden inceleyin. Yapılamayan platform kontrolü son notta kalsın.

Somut bir örnek

Yazı kartının başlığı “Fix a mismatched contact link” olmalı. Açıklaması href ile id karşılaştırmasını, bağlantının düzeltilmesini ve sonucun kontrolünü anlatır. Ana sayfanın genel başlığını kullanmak bu bağlantının ne öğrettiğini gizlerdi.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ödeviniz: belirli bir yazının önizlemesini hazırlayın

Doğrudan yazıya giden bağlantıya kendine ait doğru başlık, açıklama ve görsel verin.

Kendine ait meta verileri ve açıklayıcı paylaşım mesajı olan bir yazı sayfası oluşturun. canonical/og:url değerlerini ana sayfa yerine o yazıda tutun.

Yalnızca deneme sitenize yayımlayın, oturumsuz yanıtlarını test edin ve erişiminiz varsa bir platformun gerçek önizlemesini kaydedin. Platform reddeder veya eski sonucu önbellekten gösterirse yalnızca HTML’e bakıp başarılı demek yerine bu gözlemi belgeleyin.

Çözülmüş örnek

Her zaman ana sayfanın önizlemesini gösteren iki farklı yazı teknik olarak paylaşılabilir, fakat alıcının belirli bağlantıyı anlamasına yardımcı olmaz.

Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

Extra implementation exercise

Yazıya özgü bir önizleme ve yanıt/platform test kaydı hazırlayın.

Çözülmüş örneği göster

canonical, og:url ve og:image içindeki ayrılmış örnek alan adını kendi adresinizle değiştirin. Verilen JPEG’i HTML’in yanında yayımlayın. İki tam URL’yi de oturum açmadan açıp Network yanıtını inceleyin: sayfa adresi HTML döndürmeli; görsel adresi ise görsel yerine dönen bir HTML sayfası değil, gerçek image/jpeg baytları sunmalıdır.

Belirli bir yazı için ana sayfanın kimliğini yeniden kullanmak yerine kendi başlığını, açıklamasını ve canonical/OG URL’sini verin. Eksiksiz örnek yazı bu ayrı head bölümünü gösterir.

Hesabınızın erişimi varsa LinkedIn Post Inspector veya Meta Sharing Debugger kullanın, sonra gerçek platform sonucunu ve test zamanını kaydedin. Önbellekteki eski önizleme, mevcut sunucu çıktısının yanlış olmasından farklı bir gözlemdir. Yalnızca yerel kaynak kontrolleri canlı WhatsApp önizlemesini kanıtlayamaz.

  • Meta veriler tam olarak paylaşılan yazıyı anlatır.
  • Ham HTML ve görsel erişimi doğrulanmıştır; platform sonucu dürüstçe kaydedilir.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin