第一次jekyll就上手

每個人都有第一次

每個人都有第一次,也許是第一次架設部落格的夢想。在這裡介紹一個很夯的部落格架設方法 - jekyll
它能將我們寫出的Markdown(或其他Markup language)轉化成網頁讀取的html。讓我們不需要再花時間去寫html的open和close tag。

來看看jekyll專案的檔案結構吧

jekyll檔案結構主要為下:

_config.yml   => 設定檔,也可以直接從command line給予flag來做修改
_draft        => 還沒有要公開放上部落格的文章都放在這
_includes     => 放網頁partials的地方
_layouts      => 放layouts的地方
_posts        => 放一些動態內容,像是新增的文章。 Convention: YEAR-MONTH-DAY-title.md
_data         => well-formatted的data放在這,像是.yml等等
_site         => 轉換好的html會被放在這
index.html    => 網站的首頁
others        => 只要有YAML Front Matter的檔案,jekyll就會特別處理

看完上述的檔案結構簡單介紹,你可能還是有些不了解,你可以再jekyll的官方網站找到大部分的解答。

Configuration

我們可以在_config.yml中或command flag做設定,我們要如何才能針對單一的頁面做configuration呢?
好問題,我們可以透過在每個pages及posts裡面的YAML Front Matter做設定。

Predifined global variables

layout                => 指定要使用的layout
permalink             => 設定URL
published             => 設定是否要show up在網站上
category/categories   => 文章的類別,若是設定多個類別可以用空格分開
tags                  => 跟category相似

Custom variables

若Front Matter內的變數為自訂,也可在pages或posts中使用。

Inclding images & resources

將要包含的內容放在/assets或/download中。

Post excerpt & Highight code snippets



簡單記錄了一些在使用jekyll做部落格時需要注意到的事項,由於筆者還處於新手階段,有錯請多多指教。