Berikut cara menginstal SiteFab, Buat situs baru dan kompilasi dalam waktu kurang dari 30 detik:
# install the main package
pip install sitefab
spacy download en_core_web_sm
pip install -U spacy-lookups-data
# clone the site template as base
git clone https://github.com/ebursztein/sitefab-template.git mysite/
# clone the plugins in your site directory
git clone https://github.com/ebursztein/sitefab-plugins.git mysite/plugins
# generate your shiny new site
sitefab -c mysite/config/sitefab.yaml generate
Dan voila! Anda tahu memiliki situs yang berfungsi penuh yang dapat dikompilasi secara statis. Sebagai langkah selanjutnya Anda harus menambahkan konten Anda, menyesuaikan template html dan mengubah konfigurasi plugin sesuai keinginan Anda!
Berikut adalah beberapa fungsi utama tingkat tinggi yang menjadikan SiteFab sebagai generator statis pilihan untuk situs web modern:
<picture>
, versi webp untuk browser yang mendukungnya, thumbnail beku untuk memuat dan memotong thumbnail untuk pratinjau.Selain fitur teknisnya, yang membedakan SiteFab dari generator situs lainnya adalah prinsip panduannya:
Konfigurasi di atas konvensi : Setiap perilaku ditentukan secara eksplisit. Tidak ada file atau direktori khusus. SiteFab hanya melakukan apa yang dikatakan konfigurasi situs. Tidak lebih, tidak kurang.
Content Agnostic : Hanya ada satu jenis konten yang disebut postingan. SiteFab tidak membuat asumsi tentang konten yang disimpan dalam file .md. Tugasnya adalah menerapkan konfigurasi yang ditentukan dalam frontmatter untuk merender file tertentu dan memastikan bahwa plugin yang diaktifkan dijalankan dengan benar.
Atomicity : Setiap konten bersifat mandiri dengan memiliki konfigurasinya sendiri di frontmatternya termasuk template mana yang akan digunakan. Hal ini memungkinkan untuk mengakomodasi situs kompleks dengan konfigurasi per halaman dan situs sangat sederhana yang menggunakan kembali templat yang sama berulang kali.
Ortogonalitas : Konfigurasi situs, plugin, dan konfigurasi plugin tidak bergantung pada mesin inti sehingga Anda dapat menggunakan sebanyak mungkin konfigurasi dan plugin tweak yang Anda inginkan. Selain itu, Anda dapat memeriksanya bersama dengan konten situs Anda untuk mendapatkan build yang dapat direproduksi, rollback yang aman, dan versi pipeline build yang bersamaan (misalnya alfa versus stabil).
Berikut beberapa alternatif populer jika SiteFab bukan yang Anda cari:
Jekyll: Pembuatan situs paling populer, ditulis dalam Ruby
.
Hugo: Generator situs populer, ditulis dalam Go
yang berfokus pada kecepatan.
Pelican: Generator situs lain yang ditulis dengan Python
.