jmmasw

Buat saja saya situs web statis

JMMASW adalah alat sederhana untuk masalah sederhana: situs web statis.

Operasi

1. Muat semua file dengan ekstensi ".html" atau ".tmpl"
2. Parse setiap file ke template go
3. Muat file data ("./data.json" per default)
4. Jalankan semua templat dengan nama yang berakhir ".html"
5. Tulis output ke file kecuali itu kosong

Penggunaan

JMMASW menerima parameter Commandline berikut:

• data - Lokasi file data
• dir - Lokasi Proyek, Default adalah Direktori Saat Ini
• static-out -Direktori Output, default adalah ./jasw-out (untuk "Just a Static Situs Out")
• ignore-no-data -default ke true. Jika diatur ke false maka file data yang hilang menghasilkan penghentian program

Bangunan

JMMASW dibangun menggunakan go1.8, jadi Anda harus menginstal minimum go1.8 agar ini berfungsi tetapi versi yang lebih lama mungkin juga berfungsi (tetapi tidak ada janji)

Untuk menginstal cukup jalankan perintah berikut:

 go get go.rls.moe/jmmasw
go install go.rls.moe/jmmasw

Template

Untuk informasi tentang format template, lihat entri Godoc pada html/template dan text/template .

Template ditentukan oleh nama file mereka tetapi jika Anda secara manual mendefinisikan templat ini tidak berlaku.

Hanya templat dengan nama yang berakhir dengan ".html" yang akan diterjemahkan, ".tmpl" file hanya akan diuraikan dan dimaksudkan untuk fungsionalitas umum.

Fungsi template

• file menerima satu string sebagai parameter dan mencoba membaca file yang ditentukan dari sistem file
• json Parse String yang diberikan ke dalam format JSON, struktur tingkat atas harus peta, array sederhana tidak diizinkan
• markdown membuat string yang diberikan ke HTML menggunakan prosesor Markdown tanpa sanitasi (jangan gunakan input pengguna!)
• dict menerima sejumlah pasangan nilai kunci dengan kunci yang diketik string dan mengembalikan hasilnya. Ini memungkinkan untuk menggabungkan beberapa variabel menjadi satu pipa

Peta jalan

• Sertakan penanda tangan parser dan markdown file loader
• Fungsi untuk menguraikan file .json tambahan dari dalam templat
• Metode untuk mengabaikan direktori tertentu
• Fungsi untuk mengeluarkan file yang tidak ada sebagai templat
  • Contoh: index.html menghasilkan index-en.html dan index-de.html alih-alih index.html

Tunggu apa?

Jika Anda bertanya-tanya mengapa alat ini ada: Saya membuatnya sehingga saya dapat menghasilkan situs web saya untuk beberapa bahasa tanpa harus menyalin separuh-situs web sepanjang waktu.

Saya mempertimbangkan Hugo, yang merupakan generator halaman statis yang sangat baik tetapi juga terlalu rumit untuk aplikasi ini. JMMASW bekerja dengan templat HTML "mentah" dan tidak membuat asumsi tentang situs web Anda.

Anda dapat mengambil situs web Anda seperti sekarang dan asalkan tidak mengandung kode go-template yang tidak valid, itu akan keluar dari ujung JMMASW tanpa perubahan.