Hakkında
sitelo bir framework olarak başlamadı. Biçimlendirmeyi JavaScript’te doğal hissettiren bir biçimde yazma isteğiyle başladı — ve sayfa dosyasından yayımlanan siteye kadar bütün yol kapsanana dek büyüdü.
javascript-to-html
Önce javascript-to-html geldi (ht.js adıyla da bilinir): karmaşık şablon motorları ya da frameworkler olmadan JavaScript’te HTML üretmenin yalın, sezgisel bir yolu.
React gibi her şeyi kapsayan frameworkler bu kadar yaygınlaşmışken, mutfaktaki her şeyi yanında getirmeyen basit bir şablon çözümü bulmak şaşırtıcı biçimde zordu. Yalnızca JavaScript’i HTML’e dönüştürmeye — yani dize döndüren fonksiyonlara — odaklanan ht.js hafif, kullanımı kolay, esnek ve genişletilebilir kalıyor.
Bu küçük yüzey onu pek çok yere sığdırır: doğrudan ön yüzde (SPA gibi), statik site üretmek için bir derlemede (SSG) ya da sunucu tarafı işleme (SSR) için bile.
Vite’a HTML üretmeyi öğretmek
Bu, yazma sorununu çözdü. Sıradaki sorun derlemeydi: Vite .js / .ts dosyalarını sayfa değil, betik sayar. Belirli modüllerin HTML olmaya niyetli olduğu bir kurala ihtiyacım vardı.
Fikir açıktı: *.ht.js, *.html.js, *.ht.ts ve benzeri adlardaki dosyalar istemci JavaScript’i olarak paketlenmek yerine HTML’e işlenmeli. Bu kural vite-plugin-html-pages oldu — Vite’ın üzerinde dosya tabanlı yönlendirme, veri yükleme, varlıklar ve statik üretim.
sitelo
sitelo, Vite’ı ve bu eklentiyi tek bir kuruluma ve tek bir CLI’a sarar. Bütünlüklü, birinci sınıf bir geliştirici deneyimi elde edersiniz: canlı sunucu için sitelo, üretim için sitelo build, makul varsayılanlar ve araç zincirini kendiniz kurmadan eklentinin sayfa modeli.
Aşağıya kadar aynı fikir: sayfalar HTML döndüren modüllerdir. sitelo, bu fikri tamamlanmış hissettiren katmandır.
Bileşenler ve sunucu adaları
HTML döndüren fonksiyonların en üste kadar birleştirilebildiği ortaya çıktı. sitelo-ui aynı şekilde kurulmuş bir bileşen kütüphanesidir: düğmeler, kartlar, formlar, tablolar, modallar ve sayfa bölümleri — her biri string döndüren bir fonksiyon. Derleyici yok, çalışma zamanı yok, hidrasyon yok: ne kurarsanız dist/ klasörüne o gider.
Yine de bir sayfanın her bölümü statik olamaz. Sunucu adaları sayfayı statik tutar ve yalnızca her istekte taze veri gereken kısımları — önbelleğe alınmış bir yazının altındaki yorumlar, bir ürün sayfasındaki stok durumu — sayfa görüntülendiğinde bir sunucuda render eder. Bir ada da yine HTML döndüren bir fonksiyondur: derleme onun yedek içeriğini yayımlar, küçücük bir yükleyici de render edilmiş parçayı yerine koyar.
İkisi de modeli değiştirmez. İstemci tarafında hâlâ framework yok — yalnızca fonksiyonlardan çıkan HTML, derleme anında ya da istek anında.
Nasıl karşılaştırılır
Statik site yayımlayan pek çok iyi araç zaten var. sitelo’nun alanı bilerek dar: HTML döndüren JavaScript (ya da TypeScript) fonksiyonları, Vite’ın geliştirme deneyimiyle ve olabildiğince az frameworkle.
| Araç | Model | Şu durumda tercih edin |
|---|---|---|
| sitelo | Vite üzerinde JS/TS fonksiyonları → HTML, artı bileşenler ve sunucu adaları | Gerçek bir Vite iş akışıyla JavaScript’ten HTML istiyorsunuz — bileşenler ve istek başına render edilen bölümler dahil, istemci frameworkü ya da hidrasyon olmadan |
| Astro | Framework bileşenleri + istemci ve sunucu adaları, kendi derleyicisi | React, Vue ya da Svelte bileşenlerini tarayıcıda hidrate etmek ve daha büyük bir ekosistem istiyorsunuz |
| Next.js | Tam React uygulaması (SSR / SSG / ISR) | React ekosisteminde bir uygulama geliştiriyorsunuz |
| Hugo | Go şablonları, çok hızlı derlemeler | Devasa içerik siteleri ve Go’nun araç zincirinde rahatsınız |
| Eleventy | Şablon dilleri → HTML | SPA frameworkü olmadan esnek şablonlar (Nunjucks, Liquid, …) istiyorsunuz |
İstemci tarafı bileşen ve hidrasyon istiyorsanız — bir framework kullanın. JavaScript fonksiyonlarından Vite deneyimiyle HTML istiyorsanız — bileşenler ve sunucuda render edilen bölümler dahil — işin tamamını yapan en küçük araç sitelo’dur.