staticgen

Gen statis

Generator situs web statis yang memungkinkan Anda menggunakan server HTTP dan kerangka kerja yang sudah Anda ketahui. Cukup beri tahu Staticgen cara memulai server Anda, lalu lihat server tersebut merayapi situs Anda dan menghasilkan versi statis dengan semua halaman dan aset yang diperlukan.

Tentang

Jika Anda belum terbiasa, Anda sebenarnya dapat menggunakan perintah wget yang sudah berusia puluhan tahun untuk menghasilkan situs web statis dari situs web dinamis. Proyek ini dibuat khusus untuk ide yang sama, sehingga tim Anda dapat menggunakan server dan kerangka kerja HTTP apa pun yang Anda gunakan. sudah akrab dengan, dalam bahasa apa pun.

Saya belum melakukan tolok ukur atau perbandingan ilmiah apa pun, namun berikut adalah beberapa hasil pada MBP 8-core 2014 saya:

• Mengompilasi 3.296 halaman blog Signal v. Noise dalam 1 detik
• Kompilasi situs Perangkat Lunak Apex saya dalam 150 ms

Instalasi

Melalui gobinaries.com:

$ curl -sf https://gobinaries.com/tj/staticgen/cmd/staticgen | sh

Konfigurasi

Konfigurasi disimpan dalam file ./static.json di direktori root proyek Anda. Opsi berikut tersedia:

• command — Perintah server dijalankan sebelum crawling.
• url — Situs web target yang akan dirayapi. Defaultnya adalah "http://127.0.0.1:3000" .
• dir — Direktori keluaran situs web statis. Defaultnya adalah "build" .
• halaman — Daftar jalur yang ditambahkan ke perayapan, biasanya mencakup halaman yang tidak tertaut seperti halaman arahan. Defaultnya adalah [] .
• concurrency — Jumlah halaman bersamaan yang akan dirayapi. Defaultnya adalah 30 .

Memandu

Pertama buat file konfigurasi ./static.json , misalnya inilah konfigurasi untuk server Go, properti yang dibutuhkan hanya command :

{
  "command" : " go run main.go " ,
  "concurrency" : 50 ,
  "dir" : " dist "
}

Di bawah ini adalah contoh server Node.js, perhatikan bahwa NODE_ENV ditugaskan ke produksi sehingga pengoptimalan seperti cache template Express digunakan untuk meningkatkan kinerja penyajian.

{
  "command" : " NODE_ENV=production node server.js "
}

Jalankan perintah staticgen untuk memulai proses pra-render:

 $ staticgen

Staticgen menjalankan command yang Anda berikan, menunggu server tersedia pada url yang dikonfigurasi. Halaman dan aset disalin ke dir yang dikonfigurasi dan kemudian server Anda dimatikan.

Secara default, batas waktu untuk proses pembuatan adalah 15 menit, tergantung pada situasi Anda, Anda mungkin ingin menambah atau menguranginya dengan tanda -t, --timeout , berikut beberapa contohnya:

 $ staticgen -t 30s
$ staticgen -t 15m
$ staticgen -t 1h

Saat meluncurkan command , Staticgen menyetel variabel lingkungan STATICGEN ke 1 , memungkinkan Anda mengubah perilaku jika perlu.

Untuk melihat situs yang telah dirender sebelumnya, jalankan perintah berikut untuk memulai server file statis dan membuka browser:

 $ staticgen serve

Lihat direktori contoh untuk contoh lengkap.

Catatan

Staticgen tidak melakukan pra-render menggunakan browser tanpa kepala, hal ini membuatnya lebih cepat, namun ini berarti Anda tidak dapat mengandalkan JavaScript sisi klien untuk memanipulasi halaman.

---

Sponsor

Proyek ini disponsori oleh CTO.ai, sehingga memudahkan tim pengembangan untuk membuat dan berbagi otomatisasi alur kerja tanpa meninggalkan baris perintah.

Dan sponsor GitHub saya: