zenito
Stil ve Tasarım

Rehber Kendi stilinizi oluşturmak: alt stil, şablon düzenleme, dışa ve içe aktarma

  • zenito
  • 0 cevap
  • 65 görüntülenme
  • Kilitli
zenito
Aktif üye
Admin
  • Katılım4 Eki 2026
  • Mesajlar55
  • Tepki puanı33
#1
Merhaba,

Renkleri ve logoyu değiştirmek için stil özellikleri yeterli. Sayfanın yapısına dokunmak, başka bir siteye taşınabilen ya da satılabilen bir stil hazırlamak isteyenler için Zenito'nun stil sisteminin nasıl çalıştığını bu konuda anlatıyoruz.

Varsayılan stili değil, alt stili düzenleyin
Stiller bir ağaç gibi çalışır. Bir stil yalnızca kendi değiştirdiklerini saklar; dokunmadığı her şablonu ve stil özelliğini üst stilinden alır. Ağacın en altında, Zenito'yla gelen ana veriler durur.

Önerimiz şu: Görünüm › Stiller › Stil ekle ile "Zenito" stilinin altına kendi stilinizi açın ve değişikliklerinizi orada yapın. Bir şeyi bozarsanız varsayılan stil yerinde durur, iki stili yan yana karşılaştırabilirsiniz. Ziyaretçilerin stiller arasında seçim yapabilmesini istiyorsanız listedeki Seçilebilir anahtarını açın.

Şablon düzenleme
Görünüm › Şablonlar sayfasında Site, Yönetim paneli ve E-posta sekmeleri var. Üstten stili seçip şablonu açtığınızda yaptığınız değişiklik o stile ait bir kopya olarak kaydedilir; ana şablon olduğu gibi kalır.

  • Geçmiş: Her kayıt bir önceki halini saklar (şablon başına 30 sürüm). Geçmiş listesinden eski bir sürümü şimdikiyle karşılaştırabilir, "Bu sürüme dön" ile geri alabilirsiniz.
  • Üst sürümle karşılaştır: Kopyanızda üst stile göre hangi satırları eklediğinizi ve çıkardığınızı gösterir.
  • Şablonu geri al: Stile ait kopyayı siler, stil yeniden üst stilin sürümünü kullanır.

Güncellemeden sonra "Güncel değil" uyarısı
Zenito güncellendiğinde ana şablonlar da değişebilir. Daha önce kopyaladığınız bir şablonun üst sürümü değiştiyse listede Güncel değil olarak işaretlenir; "Güncel olmayan" süzgeciyle hepsini bir arada görebilirsiniz. Kopyanız eski haliyle kullanılmaya devam eder, yani yeni sürümle gelen bir düzeltme o sayfada görünmez.

Bu durumda şablonu açıp "Üst sürümle karşılaştır" ile farkları görün. Kendi eklediğiniz birkaç satırsa en temizi şablonu geri alıp değişikliğinizi yeni sürümün üzerine tekrar yapmaktır.

"Stil özelliğini değiştirdim ama sitede değişmiyor" şikayetinin çoğu da buradan çıkıyor: o bölümün şablonunun eski bir kopyası stilde duruyordur.

Şablon dili hakkında kısaca
Şablonlar HTML'dir; değişkenler {$thread.title}, ifadeler {{ ... }} ile yazılır, çıktı kendiliğinden kaçışlanır. Koşul ve döngü için <zn:if is="...">, <zn:foreach loop="..." value="..."> gibi etiketler kullanılır. Şablon içinde bir stil özelliğini okumak için:
Kod
<zn:if is="property('stickyHeader')"> ... </zn:if>
Etiketlerin tam listesi pakette gelen geliştirici rehberinde (docs/gelistirici-rehberi.md) var.

Stil yazarken dikkat etmeniz gereken birkaç nokta:
  • Renkleri sabit yazmayın. Her stil özelliği bir CSS değişkenidir: colorPrimary → --zn-color-primary, headerBg → --zn-header-bg. Değişken kullanırsanız koyu tema ve stil özellikleri sizin stilinizde de çalışır.
  • Adresleri elle yazmayın. 1.1.4'ten beri site sahibi /threads/ gibi kelimeleri değiştirebiliyor. Şablonda {{ link('threads', $thread) }} kullanın, kelimenin kendisi gerekiyorsa route_prefix('threads').
  • Makale forumlarını unutmayın. Forum türü "Makale" olan forumlar konuları kart olarak listeler (article_macros::card, article.css) ve ilk mesajı makale düzeninde gösterir. Konu listesini ya da mesaj görünümünü değiştiren bir stil iki görünüme de bakmalı.
  • Eklentilerin aradığı satırlara dikkat edin. Eklentiler şablonlarda belirli bir satırı bulup değişiklik yapar. O satırı stilinizde değiştirirseniz eklentinin değişikliği sessizce uygulanmaz. Görünüm › Şablon değişiklikleri sayfasında hangi eklentinin hangi şablona dokunduğunu görebilirsiniz.

Dışa ve içe aktarma
Görünüm › Stiller › stil › Dışa aktar tek bir JSON dosyası verir. Dosyada stilin kendi şablonları, stil özelliği değerleri ve stile yüklenen görseller (logo, favicon, arka plan...) bulunur.

Yalnızca bu stili dışa aktar işaretliyse dosya sadece bu stilin değişikliklerini taşır ve içe aktarılacağı sitede aynı üst stile ihtiyaç duyar. İşaretlemezseniz üst stillerin özelleştirmeleri de dosyaya katılır, dosya tek başına çalışır. Stili başka birine verecekseniz işaretsiz bırakın.

Başka bir sitede Görünüm › Stiller › Stil içe aktar ile dosyayı yükleyin. Görseller yeni stilin klasörüne yazılır ve adresleri kendiliğinden düzeltilir; türü ya da uzantısı uymayan dosyalar alınmaz.

Hazırladığınız stilleri bu foruma paylaşabilirsiniz; takıldığınız yerleri de buraya yazın.
Cevap yazabilmek için giriş yapmalı veya kayıt olmalısınız.

Şu an bu konuyu okuyanlar

0

0 üye, 0 ziyaretçi ve 0 arama motoru