← Dokümanlar

Yayınlama ve embed

Yayına alma ve yayından kaldırma, üç embed türü (interaktif iframe, inline SVG, otomatik e.js) ve veri değişince hangisinin kendiliğinden güncellendiği.

Son doğrulama: 2026-09-06 · 8 gün önce

Paylaş › Bağlantı ve embed bölümü iki iş yapar: öğeyi yayına alır ve
sitene yapıştıracağın kodu verir. Bölüm açılınca önce "Yayın durumu
yükleniyor…" görürsün, sonra Embed türü seçici gelir.

Üç embed türü

TürNe yapıştırırsınYayın gerekir miVeri değişince
İnteraktifbir iframeevetkendiliğinden güncellenir
Inline (SEO)grafiğin kendisi, SVG olarakhayırtekrar yapıştırman gerekir
Otomatikküçük bir kod + Tuvelia'nın betiğievetkendiliğinden güncellenir

Her türün altında kısa bir açıklama yazar:

  • İnteraktif: "Editör-birebir (interaktif) — stilli tooltip + animasyon; veri değişince otomatik güncellenir. Çoğu sitede sıfır işlem; katı CSP'li sitelerde host'un frame-src'ine tuvelia.com eklenmeli."
  • Inline (SEO): "Bot-dostu, her yerde çalışır. Self-contained SVG doğrudan yapıştırılır; CSP/izin gerektirmez, arama motoru ve AI botları veriyi okur. Statik: veri değişince tekrar yapıştır."
  • Otomatik: "Otomatik (e.js) — script enjekte; katı CSP'li sitelerde çalışmaz. Onun yerine İnteraktif ya da Inline tercih et."

Kararı iki soru belirler. Sayfan grafiğin güncel kalmasını mı istiyor,
yoksa bir kez basılıp durmasını mı? Güncel kalacaksa İnteraktif ya da
Otomatik; sabit kalacaksa Inline. Ve sayfanın sahibi dış iframe/betik
yüklemeye izin veriyor mu? Vermiyorsa Inline tek seçenektir.

Inline (SEO) yayın istemez: "Inline SVG kodu" alanı grafiğin o anki
hâlini hazır getirir ("SVG hazırlanıyor…" kısa bir bekleyiştir),
Inline SVG'yi kopyala ile alırsın. Kopyaladığın şey grafiğin fotoğrafı
değil, kendisidir; okuyucunun tarayıcısı Tuvelia'ya hiç istek atmaz.

Yayına alma

İnteraktif ya da Otomatik seçtiğinde ve öğe yayında değilse bölüm şunu söyler:
"Bu tür için önce yayınlamak gerekir — herkese açık bir /embed/… adresi
oluşur." Yayınla düğmesi (daha önce yayınlayıp kaldırdıysan
Yeniden yayınla) öğenin o anki görüntüsünü ve verisini yayına alır.

Yayından sonra:

  • Kod alanı dolar ("iframe kodu" ya da "e.js kodu"), Kopyala ile alırsın;
    düğme kısa süre "Kopyalandı" yazar.
  • Altında yayındaki adres tıklanabilir görünür. İnteraktif türde bu adres
    canlı sayfadır (/embed/…/live), Otomatik türde statik sayfa (/embed/…).
  • Pencere başlığındaki durum "Yayında · /embed/…" olur.

Yayındaki adres gerçek bir sayfadır ve tek başına açılabilir, ama arama
motorlarına kapalıdır
— aynı içerik hem senin sayfanda hem burada
indekslenip birbiriyle yarışmasın diye.

Veri değişince ne olur

Öğe yayındayken editörde bir şey değiştirdiğinde yayındaki kopya kendiliğinden
yenilenir
; kodu yeniden kopyalaman gerekmez, kod sabittir. İnteraktif ve
Otomatik embed'ler bu kopyayı gösterdiği için güncel kalır. Inline SVG ise
yapıştırdığın anda donmuştur; güncellemek için bölüme dönüp yeniden
kopyalayıp yapıştırırsın.

Yeniden yayınla düğmesi (ipucu: "Snapshot'ı şimdi yenile") aynı yenilemeyi
elle tetikler; otomatik yenileme bir sebeple gecikmişse buna basarsın.

Yayından kaldırma

Yayından kaldır düğmesinin ipucu sonucu söyler: "Public adres anında 404
döner; geri alınabilir." Yani sitene gömdüğün iframe ve otomatik embed'ler o
anda boş kalır; inline SVG'ler etkilenmez (onlar zaten senin sayfandadır).
Yeniden yayınla dersen aynı adres yeniden çalışır — adres değişmez.

Yayındaki bir öğe silinemez; önce yayından kaldırman gerekir. Kural
öğeler sayfasında.

Kodun içinde ne var

  • iframe kodu: genişliği %100, en-boy oranı grafiğin ölçüsünden gelir;
    zaman imleci olan bir grafik ya da haritada kod, kaydırıcı şeridi için
    biraz daha uzun bir boy taşır (statik görselde şerit olmadığı için o boy
    yalnız iframe'e eklenir).
  • Inline SVG kodu: grafiğin genişliğiyle sınırlı, ortalanmış bir kap ve
    içinde duyarlı (responsive) SVG.
  • e.js kodu: kimliği taşıyan bir kap, betik çalışmazsa görünecek bir
    yedek görsel bağlantısı ve Tuvelia'nın betiği.

Sık karşılaşılanlar

"Önizleme henüz hazır değil, tekrar deneyin."

Grafik tuvali daha çizilmeden Yayınla'ya basıldı. Bir an bekleyip yeniden
bas.

"Yayınlama başarısız. Tekrar deneyin." · "Yayından kaldırma başarısız. Tekrar deneyin."

Sunucu isteği reddetti ve kendi mesajını vermediyse bu genel metni görürsün.
Bağlantını kontrol edip yeniden dene; sürerse sayfayı yenile.

Embed sitemde görünmüyor

İnteraktif ya da Otomatik türü seçtiysen ve site katı bir içerik güvenlik
politikası uyguluyorsa (bölüm açıklamalarındaki CSP notu) embed engellenir.
Inline (SEO) türü izin gerektirmez; onu dene.