使用 Jekyll + Github 來建立一個部落格。

這邊會大致介紹如何操作。(以下操作指令都在終端機進行)

安裝jekyll

Jekyll 是基於 ruby 語言寫的,所以要使用前須先安裝 ruby,之後才可以操作 gem 指令(類似 npm 的套件吧)。

安裝 Jekyll gem install jekyll

除了安裝 Jekyll 之外,也需要一併安裝 rake 與 bundle 才能正確安裝。

gem install rake gem install bundle

這部分我也不懂,我沒學過 ruby。

然後就能進行 Jekyll 的範本下載了

jekyll new . 指令中的 . 可以替換成檔案名稱,在目標目錄裡開一個新資料夾並放入範本,不加就是直接在目標目錄建立範本。

如果在上述指令有新增資料夾,請執行 cd foldername 將 foldername 替換成你的名稱,將目標目錄移動到該資料夾。

jekyll serve 便能執行 jekyll 來看一下目前的網站。

操作jekyll

Jekyll 是由 markdown 文件來編寫 html,這對我來說撰寫文章比較方便也好看。

在 Jekyll 中,資料夾架構如下:

1
2
3
4
5
6
7
my-awesome-site
|-- _drafts 草稿資料夾
|-- _layouts 模版資料夾
|-- _plugins 外掛資料夾
|-- _posts 文章資料夾
|-- _site 靜態網頁轉換存放處
|-- _config.yaml 網站設定檔

新增文章只需要把 markdown 檔放到_posts就可以了。

不過必須遵守年-月-份-文章網址名稱(需英文).md的檔名規範才行,不然會失效喔。

除此之外,還需要去 _config.yml 設定你的相關資訊,改成自己的唷。

上傳到自己的github

首先到自己的 Github 新增一個 account.github.io 的專案,將 account 改成你的帳號。

建立後將本來完成的 Jekyll 資料夾,執行 git 指令。

git init 在目標目錄的資料夾底下建立 git 版本控管

git add . 因為在建立 Jekyll 專案時已經加入 .gitignore 檔案,不用一一挑除。

git commit -m "你要的資訊" 進行一次 commit ,沒有 commit 過的專案無法執行 push 指令。

git remote add origin https://github.com/account/account.github.io.git 將 account 替換成你的帳號,或者直接複製在 github 上面的訊息,已設定遠端分支。

git push -u origin master 將本地分支推送到遠端分支,執行時會顯示失敗,並要求輸入帳號密碼,完成後即可上傳。

上傳後便可以在 account.github.io 看到自己的 blog 了。

參考文章

利用Jekyll與Github Page建立自己的Dev-Blog

Jekyll 介紹