Feed şablonu script'i

Feed şablonu script'ini inceleyin, blok hatalarına karşı korumalı düzenleyin, farkı görüp kaydedin ve eski sürümlere dönün.

Şablon script'i sayfası, bir XML feed şablonunun içeriğini incelediğiniz ve düzenlediğiniz yerdir. Script, feed dosyasının XML iskeletini ve içine gömülü {{ … }} ifadelerini (ürünler üzerinde dönen döngüler, koşullar, ürün alanları) içerir; feed her üretildiğinde bu script'e göre oluşturulur. Sayfa script'i renklendirilmiş ve blokları eşleştirilmiş olarak gösterir, düzenlemeyi hatalı yapıya karşı korur ve her kayıttan önceki sürümü geçmişte saklar.

Ekrana ulaşma

Feed yönetimi ekranında Kanal seçicisinden kanalı seçin, XML şablonları tablosunda ilgili satırdaki Script'i aç düğmesine basın. Seçili kanal bu sayfaya taşınır.

Feed yönetimi ekranını görebiliyorsanız script'i de görüntüleyebilirsiniz. Düzenleme ve eski sürümü geri yükleme ayrıca feed'i değiştirme yetkisi ister.

Ekranın bölümleri

Başlık: şablonun adı ve altında Şablon script'i yazısı. Sağda Feed yönetimine dön (tarayıcıda bir önceki sayfaya döner), Geçmiş ve yetkiniz varsa Düzenle düğmeleri. Düzenle düzenleme modundayken gizlenir.
Ortak şablon uyarısı: şablon birden çok kanalda kullanılıyorsa sarı şeritte "Bu şablon … kanalda kullanılıyor (…); kayıt hepsini etkiler." yazar ve kanal adları sıralanır.
Script alanı: görüntüleme modunda araç çubuğu, satır numaralı script ve sağda yan panel; düzenleme modunda düzenleyici.

Script'i görüntüleme

Sayfa açıldığında script görüntüleme modundadır ve değiştirilemez.

Araç çubuğu

Öğe	Ne işe yarar
Script içinde ara (⌘F)	Script'te metin arar; büyük/küçük harf ayırmaz. Eşleşmeler sarıyla işaretlenir, geçerli eşleşme koyu sarı olur ve alanda "3/12" gibi sayaç görünür (eşleşme yoksa "0"). Enter sonraki, Shift+Enter önceki eşleşmeye gider; Önceki / Sonraki okları da aynı işi yapar. Esc ya da Temizle aramayı kaldırır. ⌘F (Windows'ta Ctrl+F) arama kutusuna odaklanır.
Satır kaydır	Uzun satırları ekrana sığacak şekilde alt satıra kaydırır. Varsayılan kapalıdır.
Blok girintisi	İç içe blokları girinti çizgileriyle gösterir. Varsayılan açıktır.
Üst blokları katla / Hepsini aç	En dıştaki blokların içini gizler; bir blok katlıyken düğme Hepsini aç'a dönüşür.
Bloklar dengeli / "… blok hatası"	Yeşil rozet her bloğun doğru kapandığını gösterir. Kırmızı rozet hata sayısını verir; tıklayınca ilk hatalı satıra gider.
"… satır · … blok"	Script'in satır ve blok sayısı.
Kopyala	Script'in tamamını panoya kopyalar; "Kopyalandı" bildirimi çıkar.
İndir	Script'i şablonun dosya adıyla XML dosyası olarak indirir.
Tam ekran / Tam ekrandan çık	Script'i tam ekranda açar. Esc ile de çıkabilirsiniz.

Script alanı

Her satırın solunda satır numarası bulunur. XML etiketleri ve {{ … }} ifadeleri farklı renklerle gösterilir.
Blok, {{for …}}, {{if …}}, {{while …}}, {{capture …}}, {{with …}}, {{case …}}, {{func …}}, {{tablerow …}} ya da {{wrap …}} ile açılıp … ile kapanan bölümdür. Bir blok satırının üzerine geldiğinizde bloğun açılış, varsa else/when ve end satırları birlikte vurgulanır; satıra tıklarsanız vurgu sabitlenir.
Birden fazla satırlık blokların açılış satırında Katla oku bulunur. Katlanmış blokta "… N satır" rozeti görünür; rozete ya da Aç okuna basınca blok açılır. Arama bir eşleşmeyi katlanmış bloğun içinde bulursa blok kendiliğinden açılır.
Hatalı satırlar kırmızı zeminle ve yanında kapanmamış blok (açılıp end ile kapanmamış blok) ya da eşi olmayan end (açılışı olmayan fazladan …) uyarısıyla gösterilir.

Yan panel

Yan paneldeki düğmeyle iki görünüm arasında geçiş yaparsınız:

"Anahat (…)": script'teki bütün blokların listesi. Her satırda blok başlangıç satırı ve açılış ifadesi (ör. for p in …) yer alır, iç içe bloklar girintili görünür. Kapanmamış bloğun yanında kırmızı uyarı simgesi olur. Bir maddeye tıklayınca script o satıra kayar. Blok yoksa "Şablonda döngü ya da koşul yok" yazar.
"Alanlar (…)": şablonun okuduğu alanlar, değişken adına göre gruplanmış olarak. Değişken bir döngüden geliyorsa yanında "← kaynak" biçiminde döngünün üzerinde döndüğü liste gösterilir. Bir alan birden çok kez kullanılıyorsa adın yanında "×sayı" yazar. Bir alana tıklamak onu script içinde arar; böylece feed'e hangi ürün bilgilerinin girdiğini ve nerede kullanıldığını hızla görürsünüz. Alan yoksa "Şablon alan okumuyor" yazar.

Script'i düzenleme

Bu işlem feed'i değiştirme yetkisi olan hesaplarda görünür; yetkiniz yoksa Düzenle düğmesi çıkmaz.

Başlıktaki Düzenle düğmesine basın. Script boşsa ortadaki Script boş mesajının altındaki Düzenle düğmesini de kullanabilirsiniz.
Düzenleyicide değişikliklerinizi yapın:
- Tab tuşu iki boşluk girinti ekler; Enter yeni satırda önceki satırın girintisini korur.
- Bulunduğunuz satır vurgulanır; araç çubuğunun sağında "Satır …, Sütun …" konumu görünür.
- Satırlar kaydırılmaz; uzun satırlarda yatay kaydırın.
Araç çubuğundaki rozetleri izleyin: Kaydedilmemiş değişiklik / Değişiklik yok ve Bloklar dengeli / "… blok hatası". Hata varsa araç çubuğunun altında her hata için "Satır …: kapanmamış blok" gibi kırmızı düğmeler çıkar; düğmeye basınca imleç o satıra gider.
Kaydet düğmesine ya da ⌘S (Windows'ta Ctrl+S) tuşlarına basın.
Değişiklikleri kaydet penceresi açılır. Pencerede "Kayıt … kanalın feed'ini bir sonraki üretimde etkiler. Önceki sürüm geçmişe yedeklenir." açıklaması ve değişikliklerin satır farkı görünür:
- Üstte eklenen ("+… satır", yeşil) ve silinen ("−… satır", kırmızı) satır sayıları yer alır.
- Eklenen satırlar yeşil zeminde "+", silinen satırlar kırmızı zeminde "−" işaretiyle gösterilir; solda eski ve yeni satır numaraları bulunur.
- Değişikliklerin çevresindeki üç satır dışında değişmeyen bölgeler "… N değişmeyen satır" olarak kısaltılır.
Farkı kontrol edip Kaydet'e basın. Vazgeçmek için Vazgeç'i seçin; düzenleyiciye geri dönersiniz.

Sonuç:

Başarılı kayıtta "Şablon kaydedildi" bildirimi çıkar ve sayfa yeni script ile görüntüleme moduna döner. Script sunucudakiyle aynıysa bildirim "Değişiklik yok" olur.
Önceki sürüm geçmişe yedeklenir; gerekirse Geçmiş'ten geri yükleyebilirsiniz.
Değişiklik feed'e bir sonraki üretimde yansır.
Kayıt başarısız olursa kırmızı "Şablon kaydedilemedi" bildirimi hatanın açıklamasıyla görünür; taslağınız düzenleyicide kalır.

Kaydet düğmesi şu durumlarda pasif kalır: hiçbir değişiklik yapılmadıysa, script'te blok hatası varsa ya da kayıt sürüyorsa. Blok hatası olan script kaydedilemez; hatalı bir şablon feed'in güncellenmemesine yol açacağı için bu engel bilinçli olarak konmuştur.

Düzenlemeden vazgeçme

Vazgeç düğmesine basın. Kaydedilmemiş değişiklik varsa "Değişiklikler atılsın mı?" sorusu gelir; onaylarsanız taslak silinir ve kayıtlı script'e dönersiniz.

Kaydedilmemiş değişiklik varken sayfadan ayrılmaya çalışırsanız (ör. Feed yönetimine dön ya da menüden başka ekran) "Kaydedilmemiş değişiklikler kaybolacak. Çıkılsın mı?" sorusu çıkar. Tarayıcı sekmesini kapatırken de tarayıcı sizi uyarır.

Aynı anda başka biri kaydederse

Siz düzenlerken başka biri aynı şablonu kaydettiyse kaydınız kabul edilmez ve sarı şeritte "Şablon siz düzenlerken başka biri tarafından değiştirildi. En güncel sürüm alındı; taslağınız duruyor — farkı kontrol edip yeniden kaydedin." mesajı görünür. Taslağınız kaybolmaz; Kaydet'e yeniden bastığınızda fark artık en güncel sürüme göre gösterilir. Diğer kişinin değişikliklerini ezmemek için farkı dikkatle inceleyin.

Geçmiş ve eski sürüme dönme

Geçmiş penceresi, konsoldan yapılan her kayıttan önceki sürümü listeler.

Başlıktaki Geçmiş düğmesine basın.
Soldaki listede her sürüm, yerine yenisinin kaydedildiği tarih-saatle görünür; en yenisinin yanında Son rozeti bulunur. Altında o kaydı yapan kişi ve sürümün boyutu ("… · … bayt") yazar. Pencere açıldığında en yeni sürüm seçili gelir.
Bir sürüme tıklayın. Sağda bu sürüm, şu anki script ile karşılaştırılır: yeşil "+" satırlar seçili sürümde olup şu anki script'te olmayan, kırmızı "−" satırlar şu anki script'te olup seçili sürümde olmayan satırlardır.
Bu sürüme dönmek istiyorsanız Düzenleyiciye yükle'ye basın. Pencere kapanır, sayfa düzenleme moduna geçer, sürüm düzenleyiciye taslak olarak yüklenir ve "Sürüm düzenleyiciye yüklendi; kaydedince geri alınmış olur." bildirimi çıkar.
Taslağı inceleyip Kaydet ile kaydedin. Kaydetmezseniz geri alma gerçekleşmez.

Düzenleyiciye yükle yalnızca düzenleme yetkisi olan hesaplarda görünür ve seçili sürüm şu anki script ile aynıysa pasiftir. Yetkiniz yoksa geçmişi yalnızca inceleyebilirsiniz.
Düzenleme sırasında Geçmiş'ten bir sürüm yüklerseniz o ana kadar yazdığınız kaydedilmemiş taslak sorulmadan bu sürümle değiştirilir. Taslağınızı korumak istiyorsanız önce kaydedin.
Pencerede Kapat ile hiçbir şey değiştirmeden çıkarsınız.
Geri yükleme de normal bir kayıttır; ondan önceki sürüm de geçmişe eklenir, yani geri almayı da geri alabilirsiniz.
Liste boşsa "Henüz kayıt yok" yazar: önceki sürümler konsoldan yapılan ilk kayıttan itibaren tutulur.

Sık karşılaşılan durumlar

Düzenle düğmesini göremiyorum. Hesabınızın feed'i değiştirme yetkisi yok; script'i yalnızca görüntüleyebilir, kopyalayabilir ve indirebilirsiniz.
Kaydet düğmesi pasif. Ya değişiklik yok ya da script'te blok hatası var. Kırmızı "… blok hatası" rozetine ya da "Satır …" düğmelerine basarak hatalı satıra gidin; eksik …'i ekleyin ya da fazladan olanı silin.
Şablon birden çok kanalda kullanılıyor uyarısı çıkıyor. Bu şablona yaptığınız değişiklik şeritte adı geçen bütün kanalların feed'ini etkiler. Yalnızca tek bir kanalı değiştirmek istiyorsanız kaydetmeden önce sistem yöneticinize danışın.
Kaydettim ama feed hâlâ eski. Değişiklik feed'in bir sonraki üretiminde yansır; hemen görünmemesi normaldir.
"Script boş" mesajı görünüyor. Bu şablon için kayıtlı bir script yok. Yetkiniz varsa Düzenle ile yeni script yazabilirsiniz.
"Feed servisi yapılandırılmadı" ya da "Bir şeyler ters gitti" mesajı çıkıyor. İlki çalışma alanında feed kurulumunun tamamlanmadığını gösterir ve yeniden denemekle düzelmez. İkincisinde Tekrar dene'ye basın; sürerse Teknik ayrıntı metniyle sistem yöneticinize bildirin.