dokümanlar / changelog

Değişiklik günlüğü

Henüz yayımlanmamış değişiklikler, dokümantasyon eklemeleri ve uyumluluk notları.

Henüz yayımlanmamış değişiklikler

Bu kayıtlar yayımlanmış bir npm sürümünü değil, mevcut kaynak ağacındaki çalışmaları açıklar. Pakette kullanılabilirlik, kurduğunuz sürüme göre kontrol edilmelidir.

Dokümantasyon

  • Düz renkli marka vurguları ve eylemler için Pagiera'nın mor ana rengi korundu; nötr gri biçimlendirme marka paletinin yerini almak yerine çevredeki yüzeylere uygulandı.
  • Web sitesi ve el kitabı yüzeyleri nötr gri bir palette birleştirildi. Gezinme; kayan menü içeriği ve ortak animasyonlu gezinme vurgusuyla Oluştur, Entegre et ve Yayımla iş akışları etrafında yeniden düzenlendi.
  • Tanıtım sayfalarının gezinme renkleri yumuşak kömür grisi cam, gri üzerine gelme yüzeyleri ve nötr açılır menülerle nötrleştirildi; dokümantasyon renkleri değişmedi.
  • Tanıtım sayfalarının gezinme çubuğu üstte şeffaf, kaydırıldığında buzlu cam görünümüne getirildi; bağlantı alt çizgileri yerine üzerine gelme, odak ve etkin durumlar için yuvarlatılmış arka planlar eklendi. Dokümantasyon gezinmesi değişmedi.
  • Tanıtım sayfalarının gezinmesi, ayrı animasyonlu mega menü açılır panellerine sahip ortalanmış yuvarlak bir kapsüle dönüştürüldü. Dokümantasyon gezinmesi değişmedi.
  • Web sitesi gezinmesi, logo ve eylem genişliklerinden bağımsız olarak ortalandı; azaltılmış hareket desteğiyle animasyonlu üzerine gelme, odak ve etkin durum alt çizgileri eklendi.
  • Gruplandırılmış gezinme ve üç sütunlu okuma düzeni korunurken mega menüler ve el kitabı, Pagiera'nın mor vurguları, açık sütunları ve daha yumuşak yüzeyleriyle iyileştirildi.
  • Mobilde genişletilebilir gruplarla Ürün, Geliştiriciler ve Kaynaklar mega menüleri eklendi. Dokümantasyon, kesintisiz gezinme şeritleri ve kaynak bağlantıları içeren editoryal bir üç sütunlu el kitabı olarak yeniden biçimlendirildi.
  • Ortak web sitesi gezinmesi; ortalanmış bağlantılar, bir Başlayın eylemi ve klavyeyle erişilebilen duyarlı bir menüyle yenilendi. Dokümantasyon üst bilgisi ayrı kaldı.
  • Sabitlenen dokümantasyon yan şeritleri makale ve üst bilgiyle hizalandı, kaydırmaları görünür görünüm alanıyla sınırlandı ve menü sınırında kenar çubuğu kaydırmasının makaleyi hareket ettirmesi önlendi.
  • Yerel el kitabı; mimari, stüdyo iş akışı, yerel bloklar, belge yapısı, duyarlı tasarım, bileşenler ve düzenler, formlar, etkileşimler, yapay zekâ ve MCP, CLI, revizyonlar, yazı tipleri ve varlıklar ile dağıtım rehberleriyle genişletildi.
  • Bu değişiklik günlüğü ve bir dokümantasyon bakım politikası eklendi.
  • Web sitesi derleme iş akışına katalog, içerik, iç bağlantı ve yerel blok kapsamı kontrolleri eklendi.
  • Tam düzenleyici stil dosyası içe aktarımı pagiera/full.css olarak düzeltildi.
  • Dokümantasyon kataloğu makine tarafından okunabilir site dizinine eklendi.

Stüdyo ve görüntüleme

  • Bağlanan değerler için biçimler eklendi: tarih (hazır biçim ya da kalıp; dil ve saat dilimiyle), sayı, para birimi, harf durumu, uzunluk sınırı, önüne/arkasına metin ve alan boşken gösterilecek değer. Request ve Repeat içindeki metin alanları cümleye katabilir; {{…}} boruları (date, currency, map, replace, default, …) ve güvenli, JavaScript'e benzeyen ifadeleri (koşullar, metin ve liste yöntemleri, ok fonksiyonları) kabul eder. İfadeler global nesnelere ya da sunucuya hiçbir erişim olmadan yorumlanır.
  • Stüdyoda sayfalar arasında geçince canvas'ta boşlukların (gap) kaybolması düzeltildi. Canvas artık gap kısa yazımını ayrı yazımların yanında kullanmıyor, her zaman row-gap ve column-gap yazıyor; React ayrı yazımları kaldırırken kısa yazımı da siliyordu. Tam genişlikteki Section'lar da ayrı satır ve sütun boşluklarını iç kutuya geçirir.
  • Animasyon modülü derinleştirildi. Girişlere bulanıklık, pop, perde açılması ve tamamen özel başlangıç durumları, Children one by one sıralaması, her ziyarette yeniden oynatma ve tetikleme payı eklendi. Yaylar artık sertlik, sönümleme ve kütleden simüle ediliyor ve yaklaşık bir cubic eğri yerine CSS linear() eğrisi olarak yayımlanıyor. Üzerine gelme ve basma; kaldırma, taşıma, döndürme, 3B eğme ve bulanıklaştırma yapabiliyor, durum geçişi düzenlenebiliyor. Kaydırma efektlerine kayma, dönme ve küçülme ile çıkarken tersine oynatma dahil aralık seçimi eklendi. Döngülere salınma, zıplama, kıpırdama ve nefes; miktar, gecikme, yön ve hız ayarlarıyla eklendi. Play ve All girişleri canvas'ta yayımlanan zamanlamayla yeniden oynatır.
  • Bir döngünün öğenin kendi girişi ya da kaydırma efekti tarafından kalıcı olarak iptal edilmesi düzeltildi; döngü artık giriş bitince devam ediyor. Giriş ve kaydırma efektlerinin bittikten sonra katmanı tam opaklığa zorlaması düzeltildi. Son çare görünürleştirme artık yalnızca ekrandakileri gösteriyor; böylece sayfanın aşağısındaki girişler oraya ulaşıldığında yine oynuyor.
  • Canvas sürükle-bırak yeniden yazıldı. Basılı tutma ancak imleç birkaç piksel hareket edince sürüklemeye dönüşür; böylece tıklama artık katmanları yanlışlıkla yeniden sıralamaz. Sürüklenen katman kalkar ve imleci izler, kardeşleri katman boyutunda bir yuva açmak için kayar ve bıraktığı boşluk kapanır. Bırakıldığında katman yerine süzülür. Escape sürüklemeyi iptal edip her şeyi eski haline getirir; imleç kenara yaklaşınca canvas kayar.
  • Bir katman artık boş olmadığı sürece kendinden küçük bir kabın içine yerleştirilmez ve bir alt öğe bölümün kenarına değse bile iki bölüm arasındaki geçişe ulaşılabilir. Bölüm arka planları gibi sabitlenmiş (absolute) alt öğeler ekleme noktası seçilirken yok sayılır.
  • Bir katmanı tüm artboard'ların dışına sürüklemek artık yuva göstermez; bu, katmanı artboard'ların yanına park eden bırakma davranışıyla uyumludur.
  • Insert veya Layers panelinden sürüklenen bloklar aynı ekleme çizgisini gösterir ve kabın sonuna değil, imlecin altındaki kardeşlerin arasına yerleşir.
  • Seçili bir kabın padding değeri her kenarın ortasındaki küçük tutamaçla değiştirilir. Gölgeli padding bandı artık imleci yakalamadığından bir bölüm her yerinden tutulabilir.
  • Yayınlanan sayfalar artık kaydırma çubuğu için yer ayırmaz. Pencereye sığan bir sayfada kaydırma çubuğu ve sağ kenarda boş bir şerit görünmez; böylece tam genişlikteki arka planlar canvas'taki gibi kenara ulaşır. Kaydırılan bir sayfa ile kaydırılmayan bir sayfa arasında geçerken düzen, kaydırma çubuğu genişliği kadar kayabilir.
  • Serbest konumlu (absolute) bir katmanda Fill, artık katmanın kayıtlı konumundan başlamak yerine o eksende ebeveyni iki kenara sabitlenerek baştan sona kaplar. Fill yapılmış bir arka plan görseli taşındıktan sonra bile her kenara tam oturur; doldurulan eksende x veya y değeri ve yatay ya da dikey kısıt yok sayılır. Böyle bir katman sürüklendiğinde veya ok tuşlarıyla kaydırıldığında yalnızca doldurulmayan eksende hareket eder, inspector'daki doldurulan eksenin X veya Y alanı devre dışıdır; doldurulan eksen yeniden boyutlandırılınca, kapladığı kenara sabitlenmiş sabit bir boyuta döner.
  • Sürüklenen katman, sonraki bölümler dahil artboard'daki her şeyin üzerinde çizilir; böylece başka bir bölümün üzerine taşınan arka plan görseli artık o bölümün metinlerinin altında kalmaz.
  • Kendi kabı içinde sürüklenen bir katman, imleç kabın kutusundan çıkana kadar o kapta kalır; böylece iç içe katmanları yeniden sıralamak artık kenara yaklaşınca üst seviyeye sıçramaz.
  • Serbest konumlu (absolute) katmanlar artık kendi ebeveynleri içinde hareket eder ve serbest konumlu kalır. Birini başka bir kabın içine koymak için bırakırken Ctrl (macOS'ta ⌘) basılı tutun.
  • Seçili bir katman, üzerini başka bir katman kaplasa bile kutusunun herhangi bir yerinden sürüklenebilir. Hareket etmeden basıp bırakmak yine üstteki katmanı seçer. Alt+tıklama imlecin altındaki bir sonraki katmanı seçer ve yığın içinde döner.
  • Kilitli katmanlar artık canvas'ta seçilemez veya sürüklenemez; üzerlerine basmak altlarındaki ilk kilitsiz katmana gider. Kilitli katmanlar Layers panelinden seçilebilir kalır.
  • Bir katman yalnızca tüm artboard'ların en az 32 px dışında bırakılırsa artboard'ların yanına park edilir; kenarın hemen ötesine kayan bir bırakma sayfada kalır.
  • Yeni Frame, Section, Image ve Embed katmanları artık varsayılan bir arka plan rengiyle gelmez; arkalarındaki her şey görünür. Kaynağı olmayan bir Image yalnızca canvas'ta çerçeveyle gösterilir, yayınlanan sayfa onun için hiçbir şey çizmez. Mevcut katmanlar sahip oldukları renkleri korur.
  • Canvas aynı anda tek bir breakpoint artboard'u gösterir; dock'taki cihaz düğmeleri onu değiştirir, yeni bir dock düğmesi ise tüm breakpoint'leri yeniden yan yana gösterir. Layers ağacı yalnızca ekrandaki breakpoint'leri listeler. Seçim tarayıcıda hatırlanır.
  • Inspector alanları ince kenarlı beyaz alanlardır; değerler 12 px ve sola hizalıdır, odakta mavi kenar ve yumuşak bir hale görünür; seçim kutuları ve metin alanları da aynı görünümdedir.
  • Tam stüdyo stil dosyası artık host uygulamayı değiştirmez. pagiera/full.css içindeki her kural düzenleyicinin kendi .pg-scope öğesiyle sınırlıdır ve tema değişkenleri :root yerine orada tanımlanır; böylece içe aktarıldığında host uygulamanın renklerini, köşe yuvarlamalarını, başlıklarını veya düğmelerini ezmez. dark: varyantı host'un .dark sınıfına değil, düzenleyicinin kendi .pg-dark sınıfına bağlıdır.
  • Görseller artık sayfaların içinde base64 olarak saklanmıyor. createPagieraClient yeni POST /assets rotasına dayanan uploadImage adaptörünü sağlar, böylece inspector yüklemeleri bir adres tutar; kaydedilen bir sayfadaki veya içe aktarılan bir şablondaki her satır içi data:image/… değeri, eski sürümlerin kaydettiği Luma resimleri dahil, bir sonraki kayıtta assets tablosuna taşınır. Varlıklar içerik özetine göre tekilleştirilir, türleri dosya imzasından okunur ve X-Content-Type-Options: nosniff ile sunulur.
  • Bir veri kaynağının liste yolu artık noktalı yolların yanında JSONPath yazımlarını da kabul eder: $.items, items[0].name, $["items"]. Önceden $.items, adı tam olarak $ olan bir alan arıyordu ve Repeat'in döngüye sokacağı bir şey kalmıyordu. Yanıt tek bir nesne olduğunda Response sekmesi içindeki dizileri öğe sayılarıyla listeler; birini seçmek yolu ayarlar ve isteği yeniden gönderir.
  • Focus mode eklendi: kayıt durumunun yanındaki genişletme düğmesi veya Ctrl/⌘+Shift+F, stüdyonun host uygulamanın kendi kenar çubuğu ve başlığının üzerinde tüm pencereyi kaplamasını sağlar ve alttaki host sayfasının kaymasını durdurur. Tarayıcı başına hatırlanır.
  • Settings ve Templates artık ikon şeridinin yanında tam sayfalar; her birinin solda kendi bölüm listesi var. Biri açıkken canvas, paneller, inspector ve dock kenara alınır; sayfa artık çalışan bir canvas'ın üzerine çizilmez. Templates sayfasında yenileme, içe aktarma ve dışa aktarma içeren tek bir başlık, bir arama alanı ve beyaz şablon kartları var; kategoriler yalnızca sayfanın kendi listesindedir.
  • Bir bileşeni düzenlemek artık Back to pages düğmesi gerektirmez. İkon şeridi tüm hedefleri korur; sayfa düzeyindeki bir hedefi (Pages, Templates, Assets, Data, History, Settings) açmak sayfaya döndürür. Üst çubuk, sayfa adı geri götüren bir yol gösterir; hiçbir şey seçili değilken Escape de geri döndürür ve bileşenin son ana öğesi silinince editör kendiliğinden sayfaya döner.
  • Insert paneli her öğeyi gri bir kutudaki ikon yerine, eklediği şeyin küçük bir çizimiyle (bir çerçeve, üst üste satırlar, ızgara, başlık çubukları, hap şeklinde düğme, form alanları) iki sütunda gösterir.
  • Editör arayüzü sakin, açık renkli bir çalışma alanı olarak yeniden tasarlandı: sıcak kırık beyaz bir çerçeve, paneller ve inspector için beyaz yüzen kartlar, ince kenarlıklar, ana yayınlama eylemi için mürekkep siyahı, seçim ve odak için mavi. Soldaki ikon şeridi artık Insert, Layers, Pages, Templates, Assets, Data, History ve Settings panellerini açar; her panelin başında adı yazar. Canvas araçları (seç veya çiz, breakpoint, sütun ızgarası, etkileşim önizlemesi, zoom, geri al ve yinele, Luma) üst çubuktan canvas'ın altında yüzen bir dock'a taşındı. Üst çubuk Pagiera işaretini ve düzenlenen sayfayı ya da bileşeni gösterir; ikon şeridi aynı yerlere gittiği için çalışma alanı menüsü, hızlı ekleme düğmesi ve açık belge sekmeleri kaldırıldı.
  • Editördeki küçük etiketler artık tek bir dört basamaklı ölçeği izler (10, 11, 12 ve 13 px). Önceden 8–9,5 px çizilen etiketler 10 px'e çıkarıldı, küsuratlı boyutlar en yakın basamağa yuvarlandı. İletişim kutuları ve panellerdeki daha büyük başlıklar değişmedi.
  • İtalik metin stili ve uzun metni üç noktayla kesen Max lines ayarı eklendi. İkisi de Typography altındadır ve breakpoint'e göre değişebilir.
  • Köşeler için ayrı yuvarlama değerleri eklendi. Border and shadow → Corners seçeneği Separate yapılana kadar köşeler Corner radius değerini izler.
  • Kırpılan bir görselin hangi bölümünün görünür kalacağını belirleyen Focus ayarı eklendi.
  • Sabit öğeler için Appears after eklendi: sayfa verilen mesafe kadar kaydırıldığında öğe kayarak görünür. Tuval böyle bir öğeyi yalnızca kendisi veya katmanlarından biri seçiliyken çizer; böylece altındaki sayfayı örtmez. JavaScript yoksa öğe baştan itibaren gösterilir.
  • Site üst bilgisi veya alt bilgisi içinde, aynı bileşenin başka bir katmanını açan tetikleyiciler düzeltildi (örneğin menü düğmesi ve açtığı çekmece); bileşeni site düzeni üzerinden alan sayfalarda hiçbir şey yapmıyorlardı.
  • Kökü kullanılabilir genişliği dolduran ve tek çocuğu olan bir bileşen, düzenlemek için açıldığında artık o çocuğun boyutuna küçültülmüyor.
  • Tam genişlikteki bileşenler artık her breakpoint için ayrı bir tuvalde açılıyor. Daha önce bir piksel genişliğinde bir tuvale çiziliyorlardı ve breakpoint geçersiz kılmaları düzenlenemiyordu.
  • Yerleştirilmiş bileşenler, metne ek olarak örnek başına görsel kaynağını, alt metnini ve bağlantı hedefini değiştirebiliyor. Content sekmesi bunları Component content altında listeler.
  • Assets paneli her bileşeni canlı önizlemeli bir kart olarak gösteriyor. Karta tıklamak bileşeni açar, sürüklemek bir kopyasını yerleştirir; varyantlar yalnızca birden fazla olduğunda etiket olarak görünür, site üst bilgisi ve alt bilgisi ayrıca işaretlenir.
  • Create component, tam genişlikteki bir katmanın breakpoint geçersiz kılmalarını koruyor; böylece duyarlı bir bölüm bileşene dönüştükten sonra da duyarlı kalıyor.
  • Çeviri anahtarları eklendi. Metin, görsel kaynağı, alt metin, bağlantı ve placeholder alanlarının her biri bir anahtar adlandırabilir; RenderedPage geçerli dilin metinlerini translations prop'u ile alır ve stüdyo kendisine verilen her dili önizler. Bkz. çeviriler.
  • Effects → Hover altına Appears → On parent hover eklendi. Katman, üst öğesinin üzerine gelinene veya odaklanılana kadar gizlidir, göründüğünde belirerek gelir ve tuvalde yalnızca seçiliyken çizilir; böylece açılır menüler ve önizleme kartları artık sayfanın veya bileşenin üzerinde açık durmaz. Bu, ayar açılırken hangi tuval etkin olursa olsun her breakpoint için geçerlidir; Repeat içinde ise etkileşim önizlemesi yalnızca imlecin altındaki satırı açar.
  • Giriş animasyonlarının, katman aç/kapa etkileşimlerinin, sürüklenebilir katmanların, istek formlarının ve özel sayfa JavaScript'inin istemci tarafı gezinmeden sonra çalışmaması düzeltildi. Yalnızca tam sayfa yüklemesinde çalışıyorlardı, çünkü sayfalar arasında geçerken eklenen bir betiği tarayıcı hiç çalıştırmaz; oluşturucu artık bu durumda onları kendisi çalıştırıyor.

Ajan araçları

  • Sayfaları incelemek, belge sözleşmesini okumak, dosyaları doğrulamak, yerel belgeler oluşturup güncellemek, önizleme URL'si almak ve açıkça yayımlamak için kaynak ağacında bir CLI eklendi.
  • Güncellemeler beklenen bir sayfa revizyonu gerektirir. Kaydetme çakışmaları başarılı yazma sayılmak yerine hata olarak bildirilir.
  • CLI doğrulaması yapısaldır; oluşturulmuş önizleme ve ana uygulama yetkilendirmesi yine gereklidir.

Yayımlanan sürüm kayıtları

Burada geçmiş sürüm notları yeniden oluşturulmaz. Bir sürüm gerçekten yayımlandığında, doğrulanmış değişikliklerini gerçek sürüm numarası ve yayımlanma tarihi altına taşıyın; ilgili yerlerde uyumluluğu bozan değişiklikleri ve geçiş adımlarını ekleyin.