Ubuntu 18.04 安裝 Jekyll

Sean

2020 年 4 月 13 日

IPFS

前言

Jekyll 是一種 Static Site Generator（靜態頁面產生器），Github 的 Github page 就是基於這樣的技術。

今天來演示如何在 Ubuntu 下安裝 Jekyll。

安裝 Jekyll

基本上這個部分，官網就已經很清楚了，照做而已。

首先，安裝 Ruby 和相依的開發工具

sudo apt-get install ruby-full build-essential zlib1g-dev

由於要避免以 root 身份安裝 Ruby Gems，因此需要設置一個 gem 安裝目錄，並配置環境變數。

echo ‘# Install Ruby Gems to ~/gems’ >> ~/.bashrc
echo ‘export GEM_HOME=“$HOME/gems”’ >> ~/.bashrc
echo ‘export PATH=“$HOME/gems/bin:$PATH”’ >> ~/.bashrc
source ~/.bashrc

最後，安裝 Jekyll，這樣就完成了。

gem install jekyll bundler

建立 Blog

接下來，可以新建或複製一個 Jekyll website 或 Blog。

若是要新建立一個 Jekyll 網站，輸入以下，就會新增一個命名為 myblog 的資料夾。

jekyll new myblog

切換到資料夾下，運行 Jekyll

bundle exec jekyll serve

以上是官方的正統做法。

調整及設置外掛

而我 Git clone 了我部落格使用的主題，並在本機運行，接下來將會因為使用的主題不同，而多少有所差異，以下經驗分享。

顯示 Could not find gem ‘GitHub-pages’ ，表示找不到 GitHub-pages 這個外掛。

於是安裝 GitHub-pages 這個外掛，並再運行一次

gem install github-pages

You have already activated i18n 1.8.2, but your Gemfile requires i18n 0.9.5. Prepending `bundle exec` to your command may solve this.

因為我一開始是輸入 jekyll serve --host=0.0.0.0 ，而新版已經改為 bundle exec jekyll serve，所以應該加入 bundle exec 才對。

bundle exec jekyll serve --host=0.0.0.0

至於後面會多加上 --host=0.0.0.0 ，是因為我在虛擬機（Vagrant）建立測試環境，必須監聽 0.0.0.0.。

雖然運行成功，但也有收到這個錯誤訊息。

Deprecation: The 'gems' configuration option has been renamed to 'plugins'. Please update your config file accordingly.

這是因為，原本我的 _config.yml 中的外掛設定使用以下這樣舊版的寫法

gems: [jekyll-paginate]

新版寫法，只要改為plugins 就可以了。

# gems: [jekyll-paginate]
plugins:
- jekyll-paginate

接下來，由於我想要產生 sitemap，因此安裝 jekyll-sitemap 這一個外掛。

gem install jekyll-sitemap

安裝後，並在 _config.yml 設定，就大功完成了。

# Gems
# from PR#40, to support local preview for Jekyll 3.0
# make sure you have this gem installed
# `$ gem install jekyll-paginate`
plugins:
- jekyll-paginate
- jekyll-sitemap

實際在網頁後面輸入 sitemap.xml 就可以看到 sitemap 了。