Sediakan blog Jekyll dalam 5 minit dengan Poole

3

Takeaways Key

Jekyll, penjana tapak statik yang ditulis dalam Ruby, boleh digunakan untuk membuat laman web atau blog yang mudah diurus tanpa memerlukan pangkalan data yang kompleks. Ia boleh dihoskan secara percuma di halaman GitHub.

Poole, yang digambarkan sebagai "persediaan asas" untuk laman web Jekyll, boleh digunakan untuk menyelaraskan proses menubuhkan tapak Jekyll. Ia datang dengan contoh templat, halaman, jawatan, dan gaya untuk bermula dengan cepat.

Menambah jawatan baru ke blog Jekyll melibatkan meletakkan fail markdown dalam folder _Posts dan memastikan ia mengandungi bahan depan YAML yang sesuai di bahagian atas. Blog kemudian boleh diterbitkan melalui halaman GitHub, yang memerlukan pemahaman asas Git.

Pada masa-masa kebelakangan ini, terdapat sesuatu yang jauh dari laman web yang didorong oleh pangkalan data, kembali ke arah tapak yang lebih mudah, lebih statik-di mana boleh dilaksanakan, seperti dengan laman portfolio atau blog yang mudah.
Ini bukan untuk mengatakan bahawa orang kembali ke tapak .html pada masa lalu, walaupun. Anda masih mahu dapat mengurus templat dan kod di seluruh tapak dengan cekap, dan di sinilah penjana tapak statik masuk.
Penjana tapak statik direka untuk mengambil pelbagai fail statik anda dan menjadikannya sebagai laman web. Terdapat banyak dan banyak yang dipilih, dan terdapat artikel baru-baru ini mengenai mereka di Sitepoint, yang meliputi bahasa yang berbeza yang mereka masuk, pilihan berasaskan nod, kelebihan potensi mereka atas WordPress, dan juga cara menggulung anda sendiri dengan Grunt .

Dalam artikel ini, kita akan melihat Jekyll, salah satu yang paling popular dan digunakan secara meluas. Saya akan menerangkan bagaimana anda boleh membina blog, dengan pengekodan yang minimum, dan kemudian menjadi tuan rumah secara percuma di halaman GitHub. Kami juga akan menggunakan Poole, sejenis kerangka atau "persediaan asas" -untuk membina tapak Jekyll.

Jekyll secara ringkas

Jekyll ditulis dalam Ruby. Ia dipasang pada komputer anda sebagai permata ruby. Ia bukan CMS, ia bukan perisian blog, ia tidak datang dengan templat, kandungan dan sebagainya. Ia lebih mudah daripada itu. Fikirkannya sebagai program mudah yang menyediakan cara yang berguna untuk memproses fail anda.

Setelah Jekyll dipasang, anda boleh meletakkannya untuk berfungsi dari baris arahan. Ia boleh melakukan perkara -perkara seperti markdown proses, dan kerana ia menghasilkan tapak statik, anda boleh melihat kemajuan secara tempatan, dan menjadi tuan rumah laman web anda pada pelayan web statik seperti halaman GitHub.

Memasang Jekyll

Pertama, anda perlu memasang Jekyll pada sistem anda. Untuk Mac, jalankan arahan berikut di Terminal untuk memasang Jekyll:

Ini secara automatik akan memasang semua kebergantungan permata Jekyll. Jika anda terjebak semasa pemasangan, lihat halaman penyelesaian masalah di laman web rasmi Jekyll atau memfailkan isu di GitHub.

Walaupun Jekyll tidak disokong secara rasmi di Windows, anda masih boleh menjalankannya dengan beberapa tweak. Sila rujuk Jekyll pada halaman Windows di laman web Jekyll atau panduan ini oleh Julian Thilo.

mendapatkan poole dan pelayan pertama anda

Daripada bermula dengan tema Jekyll mentah, mari kita gunakan Poole. Ia dicipta oleh Mark Otto, dan ini adalah bagaimana dia menerangkannya:

Poole adalah butler untuk Jekyll, penjana tapak statik. Ia direka dan dibangunkan oleh @MDO untuk menyediakan persediaan asas yang jelas dan ringkas untuk mana -mana laman Jekyll. Ia berbuat demikian dengan menyediakan pemasangan vanila penuh Jekyll dengan templat contoh, halaman, jawatan, dan gaya.

anda dapat melihat versi asas di sini. Walaupun ia sangat baik untuk blog yang minimum, saya suka dua tema yang dibina di atasnya lebih banyak: Hyde dan Lanyon. Mari kita gunakan Hyde untuk membina blog demo kami.

Untuk mendapatkan persediaan untuk Hyde, pergi ke halaman GitHub dan muat turun repositori. Letakkannya ke dalam folder pilihan anda dan pergi ke terminal. Mari kita anggap anda menyimpannya di desktop anda. Jalankan arahan berikut untuk berpindah ke direktori itu dan mulakan pelayan:

$ gem install jekyll

Perintah Servis Jekyll akan memulakan pelayan pembangunan yang akan membolehkan anda melihat pratonton tapak yang dihasilkan di penyemak imbas anda secara tempatan.

Untuk memahami apa yang saya maksudkan, buka tab baru dalam penyemak imbas anda dan jenis: http: // localhost: 4000. Jika anda telah mengikuti segala -galanya dengan betul, anda akan dapati blog anda yang baru dilahirkan di sana.

Menambah jawatan baru

Repositori Hyde-Master yang anda muat turun hanya mengandungi banyak folder seperti _layouts, _posts dan _includes. Tetapi hanya ada satu folder yang perlu anda ambil perhatian jika anda ingin menguruskan siaran untuk blog anda: _Posts. Ia mengandungi semua catatan anda dalam format markdown.

Untuk menambah catatan blog baru, hanya letakkan fail markdown anda dalam folder _Posts. Pastikan fail markdown anda mengandungi perkara berikut (dikenali sebagai bahan depan YAML) di bahagian atas:

$ cd Desktop/hyde-master/

$ jekyll serve

Ini akan memberitahu Jekyll bahawa anda menambah jawatan. (Semak siaran sampel dalam folder _Posts jika anda mempunyai keraguan.)

Jalankan Jekyll berkhidmat lagi di terminal anda dan anda akan dapati jawatan baru di blog anda jika anda membuka http: // localhost: 4000.

Untuk memastikan pembinaan blog anda yang betul, Jekyll memerlukan konvensyen penamaan ini:

---
layout: post
title: Your Post Title
---

Tahun adalah nombor empat digit, bulan dan hari adalah nombor dua angka, dan markup adalah lanjutan fail yang mewakili format yang digunakan dalam fail (dalam kes kami MD). Sebagai contoh, jawatan pertama anda boleh dinamakan 2015-03-29-saya-first-post.md.

Menerbitkan blog anda

Sebaik sahaja anda mengikuti langkah -langkah di atas, dan telah menambah beberapa jawatan anda sendiri, anda sudah bersedia untuk menunjukkan blog baru anda ke dunia. Anda boleh menyiarkan fail anda ke banyak tuan rumah web, tetapi GitHub telah menjadikannya sangat mudah (dan percuma!) Untuk menjadi tuan rumah laman Jekyll statik melalui halaman GitHub. Yang perlu anda miliki adalah akaun github.

Sebelum menolaknya ke GitHub, mari kita buat beberapa perubahan:

dalam fail config.yml:

• Tukar tajuk, tagline, penerangan github dan pengarang ke butiran peribadi anda.
• Tukar URL ke your_github_username.github.io.

Dalam cname, sebutkan your_github_username.github.io bukan hyde.getpoole.com. Dan edit tentang.md untuk memasukkan butiran anda.

Satu yang telah anda buat di atas perubahan, buat repositori Your_github_username.github.io dan gerakkan semua fail dari desktop anda ke repositori itu.

Cuba buka anda_github_username.github.io dalam penyemak imbas, dan anda akan menemui blog baru anda di sana.

Satu perkara penting untuk diperhatikan: Anda perlu tahu sedikit git untuk dapat menambah jawatan baru anda ke repositori. Sekiranya baris arahan bukanlah perkara anda, terdapat banyak alat -seperti GitHub untuk Mac -yang menjadikannya mudah untuk bekerja dengan Git. Sama ada cara, sebaik sahaja anda telah menambah jawatan anda ke repositori, halaman GitHub akan menjaga selebihnya.

bacaan selanjutnya

Jawatan ini adalah tentang mendapatkan anda bermula dengan Jekyll, tetapi ada banyak yang boleh anda lakukan jika anda sanggup meluangkan sedikit masa untuk belajar. Anda akan menemui sumber berikut yang berguna untuk memahami Jekyll dan Git sedikit lebih baik:

• Dokumentasi Jekyll -sangat kemas dan dokumentasi titik
• intro to jekyll -penjelasan yang baik oleh Johan Ronsee
• Asas Git dan GitHub -dari saluran YouTube GitHub rasmi
• belajar asas git dalam 15 minit -tutorial interaktif oleh sekolah kod.

Saya harap anda dapati artikel ini berguna. Jika anda cuba membina blog menggunakan langkah -langkah yang disebutkan di atas dan terjebak di mana -mana sahaja, sila tanya soalan dalam komen di bawah. Saya akan aktif di sana.

Soalan Lazim (Soalan Lazim) Mengenai Menyiapkan Blog Jekyll dalam 5 Minit Dengan Poole

Apa itu Jekyll dan mengapa saya harus menggunakannya untuk blog saya? Ia mengambil direktori templat yang mengandungi fail teks mentah dalam pelbagai format, menjalankannya melalui penukar dan penukar, dan meludahkan laman web statik yang lengkap dan siap untuk diterbitkan. Kelebihan utama menggunakan Jekyll adalah kesederhanaannya. Ia tidak memerlukan pangkalan data atau kemas kini, menjadikannya selamat dan mudah dijaga. Selain itu, anda boleh menjadi tuan rumah laman web anda secara langsung di GitHub secara percuma.

Apa itu Poole dan bagaimana ia melengkapkan Jekyll?

Poole adalah persediaan asas untuk projek Jekyll. Ia menyediakan persediaan asas yang jelas dan ringkas untuk mana -mana laman Jekyll. Ia berbuat demikian dengan menyediakan pemasangan vanila penuh Jekyll dengan templat contoh, halaman, jawatan, dan gaya. Ini membantu anda bangun dan berlari dengan Jekyll dalam masa yang singkat.

Bagaimana saya memasang Jekyll dan Poole?

Untuk memasang Jekyll, anda perlu memasang Ruby pada sistem anda. Sebaik sahaja anda mempunyai Ruby, anda boleh memasang Jekyll dengan menjalankan perintah permata pemasangan Jekyll Bundler. Untuk Poole, anda hanya perlu memuat turun atau mengklon repositori Poole dari GitHub dan anda baik untuk pergi.

Bagaimana saya membuat jawatan baru di Jekyll? Jekyll adalah mudah. Anda hanya perlu menambah fail dalam direktori _Posts yang mengikuti konvensyen yyyy-mm-dd-name-of-post.ext dan jekyll akan secara automatik memprosesnya ke dalam jawatan. dan merasakan blog Jekyll saya?

_layouts dan _sass direktori. Anda juga boleh menambah stylesheets anda sendiri dalam direktori CSS.

Bagaimana saya menjadi tuan rumah blog Jekyll saya di GitHub? Anda hanya perlu membuat repositori baru, tolak laman web Jekyll anda, dan kemudian mengkonfigurasi tetapan repositori untuk menggunakan cawangan GH-PAGES untuk halaman GitHub.

Mengemas kini blog Jekyll anda semudah membuat perubahan pada fail anda dan menolaknya ke repositori GitHub anda. Jekyll secara automatik akan membina semula laman web anda setiap kali anda menolak perubahan.

Bolehkah saya menggunakan Jekyll dengan bahasa lain?

Ya, Jekyll menyokong pelbagai bahasa. Anda boleh mengkonfigurasi bahasa laman web anda dalam fail _config.yml dan Jekyll akan mengendalikan selebihnya. Blog dengan meletakkannya di direktori imej dan merujuknya dalam catatan atau halaman anda menggunakan sintaks Markdown atau HTML yang sesuai. Plugin dengan Jekyll?

Ya, Jekyll menyokong pelbagai plugin yang dapat melanjutkan fungsinya. Anda boleh memasang plugin dengan menambahkannya ke fail permata dan _config.yml anda, dan kemudian menjalankan arahan pemasangan bundle.

Atas ialah kandungan terperinci Sediakan blog Jekyll dalam 5 minit dengan Poole. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!