BlazorStatic

Manfaatkan kekuatan Blazor untuk membuat situs web statis.

Ubah aplikasi Blazor Anda menjadi situs statis.

? Bagaimana cara kerjanya?

BlazorStatic bertujuan untuk menjadi intuitif dan mudah digunakan bagi sebagian besar pengembang yang telah bekerja dengan segala jenis kerangka front-end, terutama jika Anda sudah bekerja dengan Blazor.

Situs BlazorStatic adalah contoh perpustakaan yang kaya fitur. Periksa kode sumbernya.

Saat menjalankan aplikasi Anda, BlazorStatic mengambil HTML halaman dengan HttpClient , mengeluarkan file dan aset HTML ke folder output , dan dari sana Anda dapat menerapkannya ke server HTTP atau layanan hosting standar apa pun.

Ada banyak default untuk menjaga penggunaan tetap sederhana, namun Anda dapat mengonfigurasinya secara ekstensif. Misalnya, Anda dapat mencocokkan materi depan YAML Anda dalam file penurunan harga (yang dapat digunakan kembali dari generator situs statis lainnya).

Memulai

Anda dapat mulai menggunakan BlazorStatic dengan tiga cara, bergantung pada pengaturan dan tujuan penggunaan Anda. Anda memerlukan .NET SDK 8 atau lebih tinggi untuk memulai.

? Cara yang Direkomendasikan

Instal template BlazorStatic:

dotnet new install BlazorStatic.Templates

Ini menambahkan opsi baru ke daftar templat dotnet new Anda. Kemudian buat proyek baru menggunakan:

dotnet new BlazorStaticMinimalBlog -o MyBlazorStaticApp

Ini membuat folder dan proyek MyBlazorStaticApp . Ini adalah aplikasi .NET Blazor standar dengan paket BlazorStatic terinstal, termasuk beberapa komponen, gaya, dan postingan blog yang telah ditentukan sebelumnya dengan konten contoh.

Jalankan aplikasi menggunakan dotnet watch . Ini akan meluncurkan aplikasi, memungkinkan Anda melihatnya secara langsung, sekaligus menghasilkan file HTML statis di folder output .

Dari sini, Anda siap menjelajahi proyek, menambahkan konten, membuat halaman baru, dan banyak lagi.

• File penurunan harga terletak di folder Content/Blog .
• File .gitignore disertakan dengan rekomendasi .NET standar dan mengabaikan folder output .
• Templat ini juga menyertakan folder .github dengan tindakan GitHub untuk membangun dan menerapkan ke Halaman GitHub. Lihat bagian Penerapan di bawah.
• Anda dapat menyesuaikan apa pun. Untuk rincian lebih lanjut, lihat dokumen ini, yang menjelaskan semuanya secara lebih mendalam.

?‍➡️ Cara Tercepat

Gunakan BlazorStaticMinimalBlog sebagai template (tombol hijau besar).

Ini akan menyalin semua konten dan menjalankan tindakan GitHub untuk Anda. Setelah dijalankan, buka pengaturan dan aktifkan halaman GitHub:

Halaman Anda sudah siap sekarang!

Cara Adat

Jika Anda ingin memahami sepenuhnya cara kerja BlazorStatic atau jika Anda sudah memiliki proyek tempat Anda ingin mengintegrasikan perpustakaan BlazorStatic, mulailah dari awal. Lihat dokumen ini untuk panduan.

? Fitur

• Manfaatkan pengalaman Blazor Anda yang sudah ada.
• Parsing dan gunakan file penurunan harga dengan mudah.
• Dukungan untuk bagian depan YAML khusus itu penting.
• Secara otomatis menemukan halaman di antara file Razor.
• Kemampuan untuk menambah/menghapus halaman sesuai kebutuhan.
• Bekerja dengan semua kerangka dan tema CSS.
• Mudah diterapkan dengan pipeline CI/CD.
• Mendukung HotReload
• Memiliki templat dotnet new

? Menyebarkan

Anda dapat menyebarkan folder output ke layanan hosting statis apa pun, seperti GitHub Pages, Netlify, Vercel, Azure Static Web Apps, dll.

Instruksi terperinci ada di sini.

Sampel

Keterangan	Sumber	Hidup
Halaman tentang BlazorStatic (repo ini berisi kode itu sendiri)	sumber	hidup
Blognya minim	sumber	hidup
Zodoc - sampel pemrosesan gambar dan pembelajaran mendalam	sumber	hidup
❓ Tambahkan halaman Anda di sini!!!

? Kontribusi

Kontribusi sangat dianjurkan dan dihargai. Jika Anda menemukan sesuatu yang hilang, tidak jelas, atau mengalami masalah dengan kode, saya sangat menyambut masukan Anda. Jangan ragu untuk:

• Buat terbitan baru atau kirimkan PR.
• Hubungi melalui email: [email protected]
• Hubungi saya langsung untuk pertanyaan atau saran apa pun.
• Ajukan pertanyaan atau mulai diskusi di server Blazor Community Discord.