每個人都有第一次
每個人都有第一次,也許是第一次架設部落格的夢想。在這裡介紹一個很夯的部落格架設方法 - 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做部落格時需要注意到的事項,由於筆者還處於新手階段,有錯請多多指教。