Jekyll paling sederhana
Situs berbasis Jekyll minimal di halaman GH, dikurangi menjadi satu halaman konten dengan tema
Pratinjau
Tentang
Ini adalah Templat dan Proyek Demo Langsung. Ini menunjukkan betapa sedikit Anda perlu mengatur untuk mendapatkan situs Jekyll di halaman GH.
- index.md
- Untuk beranda - satu -satunya halaman dalam kasus ini.
- Jika Anda meninggalkan halaman ini, maka
README.md akan digunakan sebagai beranda Anda.
- _config.yml
- Atur tema - yang menangani tata letak dan gaya.
- Aktifkan Plugin Sitemap Jekyll - Mengaktifkannya di Gemfile tidak cukup. Perhatikan bahwa plugin lain akan diaktifkan untuk Anda seperti frontmatter opsional.
- Nilai standar lainnya seperti
baseurl , title dan description telah ditinggalkan dari konfigurasi. Saat membangun di halaman GH, ini akan disimpulkan untuk Anda oleh permata halaman GH.
- Gemfile
- Ini sebenarnya tidak digunakan oleh halaman GH, tetapi memungkinkan Anda untuk menginstal tema Jekyll secara lokal menggunakan Bundler.
- Gunakan satu
github-pages permata jika Anda ingin mencocokkan semua permata di halaman GH (yang bisa sangat berat untuk dipasang). - Hapus file ini jika Anda tidak perlu menjalankan situs Anda secara lokal.
Jika Anda menginginkan contoh yang lebih lengkap dari situs multi-halaman dengan posting, permata, tata letak, dll. Kemudian periksa repo jekyll-blog-demo saya. Itu dapat digunakan sebagai templat dan situs demo juga.
Cara Menggunakan Proyek Ini
Pengaturan
- Klik Gunakan template ini untuk membuat repo baru di akun Anda sendiri. Anda dapat meninggalkan namanya sebagai
simplest-jekyll . - Aktifkan halaman GitHub di pengaturan repo Anda. Pilih untuk melayani dari
master cabang dan opsi / jalur. - Periksa tab Lingkungan Repo Anda untuk melihat kapan penyebaran selesai.
- Klik Lihat Penyebaran untuk melihat situs langsung. misalnya https://michaelcurrin.github.io/Simplest-jekyll/
Perhatikan bahwa /simplest-jekyll/index.html tersedia segera tetapi butuh beberapa menit sampai halaman github membuat /simplest-jekyll/ tersedia.
Menyesuaikan
- Perbarui
README.md dengan detail Anda sendiri. Ini sebenarnya tidak digunakan di situs yang digunakan tetapi terlihat secara lokal dan di GitHub. - Tema
- Edit tema di _config.yml jika Anda menginginkan tema lain.
- Anda juga dapat menggunakan bagian halaman GitHub dari pengaturan repo untuk melihat pratinjau secara visual.
- Catatan Hanya tema yang didukung oleh halaman GitHub yang dicakup (sekitar 10) tetapi jika Anda menggunakan bidang Remote_Theme di konfigurasi Anda, Anda dapat merujuk lebih banyak tema.
- Untuk menginstal dan berjalan secara lokal, Anda harus memastikan Gemfile Anda mencakup tema yang digunakan dalam konfigurasi.
- Seperti kebanyakan situs Jekyll, index.md digunakan sebagai beranda.
- Ini memiliki materi depan di bagian atas sehingga cairan apa pun akan diterapkan.
- Edit file
index.md Anda dengan konten Anda sendiri sebagai html atau markdown. - Anda dapat mengganti nama menjadi
index.html jika Anda hanya ingin html biasa. - Anda dapat menghilangkan materi depan di bagian atas untuk menghilangkan pemformatan cair dan tema apa pun.
- Jika Anda mau, tambahkan lebih banyak halaman di root dan keluarkan HTML umum seperti header atau head atau navbar ke dalam folder
_includes atau folder _layouts (tidak ada yang tercakup dalam ruang lingkup proyek ini tetapi umum untuk proyek Jekyll). - Lihat dokumen dan tutorial di situs Jekyll untuk info lebih lanjut.
- Jalankan Jekyll secara opsional:
- Pasang Ruby dan Bundler.
- Instal Project Gems - Jekyll dan Permata Tema.
- Jalankan Jekyll Dev Server.
- Untuk instruksi yang lebih lengkap, lihat Docs of Jekyll Blog Demo. Anda harus menambahkan
Makefile juga untuk mencocokkan perintah itu.
Proyek terkait
- - Blog default yang dihasilkan dengan Jekyll CLI. Menggunakan tema, konten, pengaturan gaya, permata, dan makefile.
- - Menggunakan Jekyll 4, Tema, Tindakan GitHub, dan halaman GitHub.
- - Situs Jekyll minimal dengan tema tetapi tidak ada Gemfile.
Lisensi
Dirilis di bawah MIT oleh @MichaelCurrin.
