Tentang

sitelo tidak dimulai sebagai framework. Ia dimulai dari keinginan untuk menulis markup dengan cara yang terasa wajar di JavaScript — dan terus tumbuh sampai seluruh jalur dari berkas halaman ke situs yang terbit tercakup.

javascript-to-html

Mula-mula datang javascript-to-html (dikenal juga sebagai ht.js): cara sederhana dan intuitif untuk menghasilkan HTML di JavaScript, tanpa mesin templat atau framework yang rumit.

Mengingat betapa lazimnya framework serba lengkap seperti React, menemukan solusi templat sederhana yang tidak membawa serta segalanya ternyata sulit. Dengan hanya berfokus pada mengubah JavaScript menjadi HTML — pada dasarnya fungsi yang mengembalikan string — ht.js tetap ringan, mudah dipakai, luwes, dan dapat diperluas.

Permukaan yang kecil itu membuatnya cocok di banyak tempat: langsung di frontend (gaya SPA), dalam proses build untuk membuat situs statis (SSG), atau bahkan untuk perenderan sisi server (SSR).

Mengajari Vite menghasilkan HTML

Itu menyelesaikan soal penulisan. Masalah berikutnya adalah build: Vite memperlakukan .js / .ts sebagai skrip, bukan halaman. Saya butuh konvensi yang menandai modul tertentu memang dimaksudkan menjadi HTML.

Gagasannya lugas: berkas bernama *.ht.js, *.html.js, *.ht.ts, dan sejenisnya harus diproses menjadi HTML alih-alih dibundel sebagai JavaScript klien. Konvensi itu menjadi vite-plugin-html-pages — perutean berbasis berkas, pemuatan data, aset, dan pembuatan statis di atas Vite.

sitelo

sitelo membungkus Vite dan plugin itu menjadi satu pemasangan dan satu CLI. Anda mendapat pengalaman pengembang yang utuh dan kelas satu: sitelo untuk server langsung, sitelo build untuk produksi, nilai bawaan yang masuk akal, dan model halaman milik plugin tanpa perlu merakit rantai perkakasnya sendiri.

Gagasan yang sama sampai ke bawah: halaman adalah modul yang mengembalikan HTML. sitelo adalah lapisan yang membuat gagasan itu terasa rampung.

Perbandingannya

Sudah banyak perkakas bagus yang menerbitkan situs statis. Ceruk sitelo sengaja sempit: fungsi JavaScript (atau TypeScript) yang mengembalikan HTML, dengan pengalaman pengembangan Vite, dan sesedikit mungkin framework.

PerkakasModelPilih saat
siteloFungsi JS/TS → HTML di atas ViteAnda ingin HTML dari JavaScript dengan alur kerja Vite sungguhan — tanpa perlu framework komponen
AstroKomponen + island, kompiler sendiriSitus konten yang menginginkan island komponen dan ekosistem lebih besar
Next.jsAplikasi React penuh (SSR / SSG / ISR)Anda membangun aplikasi di ekosistem React
HugoTemplat Go, build sangat cepatSitus konten raksasa dan Anda nyaman dengan rantai perkakas Go
EleventyBahasa templat → HTMLAnda ingin templat yang luwes (Nunjucks, Liquid, …) tanpa framework SPA

Jika Anda ingin komponen, hidrasi, dan framework — pakailah framework. Jika Anda ingin berkas HTML dari fungsi JavaScript dengan pengalaman Vite, sitelo adalah perkakas terkecil yang menuntaskan seluruh pekerjaannya.

Baca dokumentasi · GitHub