Salah satu kesukaran yang saya alami ketika cuba lulus dari Worpress ke Jekyll fSaya mesti memahami setiap komponen dan bagaimana mereka berinteraksi antara satu sama lain. Saya menjumpai jalan keluar ketika saya berhenti mencuba membuat blog saya dari awal dan mula membalikkan teknik tema dibangunkan oleh orang lain. Kelebihan sumber terbuka.
Untuk memulakan, dengan andaian anda telah memasang prasyarat yang telah kami gariskan dalam artikel sebelumnya, kami akan membina laman web kami. Contohnya ialah blog berkebun.
jekyll new blog_de_jardineria
Sekiranya anda pergi ke folder, anda akan melihat perkara berikut:
- Folder dipanggil _pos.
- Dua fail dengan pemanjangan markdown
- Halaman Web.
- Fail konfigurasi dengan sambungan .yml yang akan kita bahas secara meluas dalam artikel seterusnya.
- Fail Gemfile yang menyenaraikan komponen laman web dan nama lain yang sama tetapi dengan sambungan .lock yang menghalang pengubahsuaian secara tidak sengaja.
Struktur projek
Seperti mana-mana laman web berasaskan WordPress, Jekyll juga membuat struktur folder di mana ia menyimpan semua fail, dan ia melakukannya dengan alasan yang sama. Benarkan pengguna mengelompokkan fail dengan teratur dan, semasa projek berkembang, tetap dapat dikendalikan.
Kami membuat folder asas dengan arahan jekyll new. Di dalamnya kita dapati dua jenis folder; yang berkaitan dengan konfigurasi blog yang diidentifikasi dengan tanda sempang di depan nama (dalam kes kami folder _post dan yang mempunyai sumber yang tidak akan disertakan sebagai sebahagian daripada proses penciptaan. Contohnya, mereka yang mengandungi gambar.
Folder berdasarkan kandungan
Dalam kumpulan ini se menyimpan kandungan yang ditujukan untuk pengunjung laman web
_ pos
Folder itu _pos mengandungi semua entri blog. Berikut adalah format yang sangat khusus digunakan untuk setiap fail yang disimpan di dalamnya. Nama fail mestilah dalam format tarikh-nama fail - tahun-month-date-full_filename.md - dan tarikh pengeposan ini akan dipaparkan sebagai tarikh catatan blog Jekyll ini dibuat. Kita mesti ingat bahawa walaupun folder dipanggil _ siaran, berikut adalah semua kandungan yang akan dilihat oleh pembaca blog, contohnya borang hubungan atau biografi penulis. Kemudian kita akan melihat bahawa mungkin untuk menetapkan reka bentuk yang berbeza ke halaman.
_kraf
Ia sama dengan menyimpan draf WordPress. Penggunaannya yang disyorkan adalah untuk catatan yang belum siap untuk diterbitkan walaupun boleh digunakan untuk menyimpan senarai idea, reka bentuk yang akan digunakan kemudian, dll.
_termasuk
Di ruang ini kita dapat menyimpan kod html yang dapat digunakan semula beberapa kali. Sebagai contoh, dalam kes kita, sepanduk yang menyambut awal musim bergantung pada hemisfera di mana pengguna berada.
_laburan
Seperti yang kami katakan di atas, bahagian kandungan yang berbeza mungkin memerlukan susun atur yang berbeza. Sebagai contoh, untuk menunjukkan video, kami mungkin mahu halaman menjadi satu lajur, sementara jika itu adalah pengarang tetamu, kami memerlukan lajur untuk menunjukkan biografi dan maklumat hubungan mereka. Reka bentuk yang berbeza yang akan digunakan laman web ini disimpan dalam folder ini.
Folder maklumat
Kedua-dua folder ini digunakan oleh laman web untuk operasinya.
_data
Dalam blog satu orang, fail konfigurasi dapat menyimpan semua data yang diperlukan. Tetapi, jika kita mempunyai blog dengan banyak pengarang, kaedah pengurusan maklumat yang lain diperlukan. Folder itu _data Ini digunakan untuk menyimpan data dalam format JSON atau CSV yang dapat diambil oleh laman web sesuai dengan interaksi dengan pengguna.
_jika awak
Folder itu _jika awak Laman web melengkapkannya dengan semua maklumat yang ada di folder sebelumnya. Di sini kita akan menemui laman web yang akan kita muat naik ke pelayan supaya pengguna dapat mengakses. Sudah tentu, kerana ia adalah kod html dan css, adalah mungkin untuk melakukan pengubahsuaian seperti laman web lain.
Pada artikel seterusnya kita akan mula mengubah fail konfigurasi.