Ank's Blog

在個人VPS上安裝和使用Jekyll

  • 2020年 03月27日

為何選擇Jekyll?

Jekyll的官網：英文和簡中

它是一個靜態網頁的生成工具，是GitHub Pages所推薦使用的，現在我把它搬到我個人VPS上使用，而且它還有一項很吸引我的說法，就是像駭客一樣寫Blog，使用vim像寫Code一樣的寫作。

同時它又具備了這些條件:

  • markdown語法
  • 程式碼顯示美觀
  • 簡潔(無廣告)
  • 離線撰寫
  • 可用編譯器(如:vim)寫文章
  • 高度客製化
  • 可靠的備份與長久保存
  • 高移植性

如何使用Jekyll

因為我是在個人主機上，才有這些步驟，佈署在Github上不需安裝Jekyll，操作更為簡單

安裝Jekyll

看這裡 : 在VPS上安裝Jekyll

使用Jekyll(默認範例)

!!!注意 目的地目錄會被清空

jekyll new my-awesome-site    #用新建一個jekyll格式的目錄
jekyll build --source /home/user/my-awesome-site --destination /home/wwwroot/default/ --trace #把Jekyll格式的目錄轉換成靜態網頁目錄

/home/user/my-awesome-site可以是你新建的Jekyll默認範例，也可以是你下載別人做好的Jekyll範例 /home/wwwroot/default/ 是你的網站根目錄

默認的主題範例是這樣子:

Jekyll的目錄結構

剛提到Jekyll其實就是一個靜態網站的生成器

負責 Jekyll格式目錄 到 靜態網頁目錄 的一個生成轉換

這個過程除了會清空目的地目錄

還對來源目錄(即Jekyll目錄)的格式和命名有一定的規範

對於需要接觸Jekyll的人來說，多少需要了解一下

一般的Jekyll目錄結構是這樣:

  _config.yml
  _drafts
         ├─begin-with-the-crazy-ideas.textile
         └─on-simplicity-in-technology.markdown
  _includes
         ├─footer.html
         └─header.html
  _layouts
         ├─default.html
         └─post.html
  _posts
         ├─2007-10-29-why-every-programmer-should-play-nethack.textile
         └─2009-04-26-i-want-eat-hotdog.textile
 _data
         └─members.yml
  _site
  index.html

特別要注意的地方就是撰寫的文章有嚴格的命名規則，一般存放在_posts目錄中

格式: 年-月-日-標題.檔案名

例子: 2020-03-26-use-jekyll-on-vps.md

更多內容可以看官網的目錄結構一節

搜索