
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.
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.
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
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.
Sık yapılan hata
Yalnızca zaten oturum açılmış tarayıcıda test etmek.
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.
Sıra sizde
Paylaşım resmi adresiniz 200 döndürüyor ama HTML ana sayfası gösteriyor. Resim kontrolü başarılı mı? Ne düzeltilmeli?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Hayır. Kartın ayarlanan adreste gerçek resme ihtiyacı var. Asistandan share-card.jpg dosyasını o yolda yayımlamasını; oturum kapalı isteğin ana sayfa yerine image/jpeg içerikli resmi döndürdüğünü doğrulamasını isterdim.
- Yanıt durumu 200 olsa da HTML yedek sayfasını resim olarak kabul etmez.
- Ayarlanan tam herkese açık resim adresini ve gerçek resim içeriğini kontrol eder.
Bu adımda kullanılan 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.
Sık yapılan hata
Dağıtılan meta verilerde yer tutucu alan adlarını bırakmak.
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
Sıra sizde
Seçtiğiniz platform hangi kartı gösterdi ve ne hâlâ belirsiz?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek sonuç: Herkese açık sayfa ve JPEG güncel ama seçilen platform önceki başlığı gösteriyor. O platformun eski önizlemesini kaydeder, mevcut aracıyla yenileme isteyip oluşan kartı yeniden incelerdim. Yalnızca LinkedIn kontrolünden güncel WhatsApp kartı sonucu bildirmezdim.
- Adı verilen platformdaki gerçek kartı kaydeder; başlık/resmini sayfayla karşılaştırır.
- Güncel herkese açık çıktıyı platformun önbellekte kalmış olabilecek kartından ayırır.
Bu adımda kullanılan 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.
Sık yapılan hata
Her 200 yanıtını beklenen dosyanın sunulduğunun kanıtı saymak.
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.
Sıra sizde
Başlangıç malzemeleri
Başlangıç dosyaları ve deneme içerikleri hazır. Gerçek servis doğrulaması için Başlamadan önce bölümünde belirtilen kendi hesabınız, gelen kutunuz veya alan adınız gerekir. Bunlar olmadan dosyaları inceleyebilirsiniz; gerçekten denemediğiniz canlı adımı denenmedi diye kaydedin.
Yazı bağlantısını ve gerçek resim/platform kontrol kaydını sunun.
Hazırlanacak çıktı Herkese açık alıştırma URL'si ve varsa önbellek sınırlamalarıyla gözlemlenen resim/önizleme sonuçları.
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek teslim kaydı: article.html “Fix a mismatched contact link” tanımlar, bağlantı düzeltmesini anlatır ve yayımlanan yazı adresini gösterir; share-card.jpg oturum kapalı açılır. İncelenen platform o yazı başlığını gösteriyor. Diğer platformlar denenmedi; onların önizlemelerinin yenilendiğini iddia etmiyorum.
- Yazıya kendisiyle eşleşen başlık, açıklama ve herkese açık sayfa adresi verir.
- Gerçek resim/platform gözlemlerini sunar; kontrol edilmeyen platformu belirtir.
Bu adımda kullanılan 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.
Sık yapılan hata
Yerel kaynak incelemesinin WhatsApp’ın önizlemeyi yenilediğini kanıtladığını söylemek.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.
Öğrenmeye devam edin
- İlk kişisel web sitenizi nasıl kurarsınız?
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
- Kendi alan adınızı web sitenize nasıl bağlarsınız?
- Kendi alan adınızla e-posta nasıl kurulur
- Web sitenizi telefonda rahat kullanılır hale nasıl getirirsiniz?
- Web sitenizdeki görsellerin daha hızlı yüklenmesini nasıl sağlarsınız?
- Sitenize gelen geri bildirimler gelen kutunuza nasıl ulaşır
- Sitenize e-posta aboneliği nasıl eklenir
- Web sitenizden otomatik e-posta nasıl gönderirsiniz?
- Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
- İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?
- Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?
- Kullanıcıların profil bilgilerini düzenlemesini nasıl sağlarsınız?
- Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
- API anahtarlarını tarayıcıya göndermeden nasıl kullanırsınız?
- Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?
- Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
- Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
- Web sitenize nasıl blog eklersiniz?
- Web sitenize nasıl arama eklersiniz?
- Web sitenize nasıl başka bir dil eklersiniz?
- Google’ın sitenizi bulmasına nasıl yardımcı olursunuz
- Sitenizde ziyaretler ve yararlı işlemler nasıl ölçülür
- Ziyaretçilerin randevu almasını nasıl sağlarsınız?
- Web sitenizde ödeme nasıl alınır
- Yayımlamadan önce site değişiklikleri nasıl önizlenir
- Hatalı yayımlanan web sitenizi önceki çalışan sürüme nasıl döndürürsünüz?
- Web sitenizin verilerini nasıl yedekler ve geri yüklersiniz?
- Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir