blip

Blip - Generator blog statis Swift/Markdown

Prasyarat

Blip menggunakan struktur direktori khusus untuk templat dan organisasi situs. Lihat direktori example-site/ untuk demo, atau baca terus untuk penjelasan lengkap.

Templat

Templat adalah panduan tata letak untuk indeks situs dan halaman posting Anda. Berikut ini terletak di config/templates/ :

• index_template.html : Halaman indeks utama situs Anda.

• index_post_template.html : Tata letak pratinjau postingan di halaman indeks.

• post_template.html : Tata letak halaman postingan individual.

Token Khusus

Blip menggunakan beberapa "token" khusus untuk tugas umum dan penggantian teks. Gunakan Config.swift untuk menyesuaikan string pengganti.

Penurunan Harga (Postingan):

• [[MORE]] : Memecah postingan saat ini di halaman index*.html dan menyisipkan tautan Read More ke postingan lengkap.

Templat:

• $(COPYRIGHT) : Menyisipkan string hak cipta khusus ke dalam templat indeks.

• $(POSTS) : Menyisipkan daftar cuplikan postingan ke dalam template indeks.

• $(POSTS_OLDER) : Menyisipkan tautan "Postingan Lama" ke dalam templat indeks.

• $(POSTS_NEWER) : Menyisipkan tautan "Postingan Baru" ke dalam templat indeks.

• $(POST_TITLE) : Menyisipkan judul postingan ke dalam template postingan atau indeks.

• $(POST_TIMESTAMP) : Menyisipkan stempel waktu postingan ke dalam template postingan atau indeks.

• $(POST_BODY) : Menyisipkan badan postingan ke dalam template postingan atau indeks (template indeks akan menampilkan hingga [[MORE]] token apa pun).

• $(POST_PERMALINK) : Menyisipkan permalink postingan ke dalam template postingan atau indeks.

Postingan

Nama file

Postingan harus dalam format Markdown, dan harus mengikuti konvensi penamaan YYYYMMDD.md (ekstensi file .markdown juga didukung).

Struktur Direktori

Direktori posts/ harus berisi setidaknya dua subdirektori:

• drafts : Di sinilah Anda harus meletakkan file Markdown (.md) untuk diterbitkan.

• published : Blip akan menghasilkan index*.html dan memposting halaman di direktori ini. Anda harus menggunakan isi direktori ini untuk situs web Anda.

Postingan yang dipublikasikan disusun berdasarkan tanggal pada nama filenya. Jadi misalnya, postingan dengan nama file 20171220.md akan dipublikasikan di jalur berikut: posts/published/2017/12/20.md . Saat ini, Blip hanya mendukung satu postingan per hari, terutama karena saya jarang menulis blog...

Lembar Gaya & Gambar

• published/stylesheets/ : Templat default menggunakan index.css yang disertakan sebagai stylesheet. Anda dapat meletakkan file CSS lainnya di sini dan referensi di template Anda, jika diperlukan,

• published/images/ : Letakkan gambar Anda di sini, dan Anda dapat mereferensikannya dalam Penurunan Harga sebagai berikut: ![image](/images/someimage.jpg)

Penggunaan

Tulis postingan Anda di Markdown, dengan konvensi nama file yang benar ( YYYYMMDD.md ), lalu letakkan di direktori drafts/ .

Kemudian jalankan perintah berikut:

 ./blip /path/to/your/blog/ -r

Argumen

-r Membangun kembali seluruh situs, dengan menerbitkan semua file Markdown di direktori drafts/ .

-w Mengawasi drafts/ direktori Anda untuk file Markdown baru dan secara otomatis menerbitkannya.

-i Hanya membangun kembali halaman index*.html .

-h Menampilkan bantuan.

Ketergantungan

• SwiftFSWatcher

Pengamat Sistem File yang mudah digunakan/diperluas menggunakan Swift.

• Turun

Render Markdown yang sangat cepat di Swift, dibuat berdasarkan cmak.

Contoh Langsung

Kunjungi situs pribadi saya untuk melihat contoh penggunaan Blip.