Sean

記憶交給文字,創意留給腦袋。 旅居台北的軟體工程師,寫作的同時,也是對這個世界的探索。

Ubuntu 18.04 安裝 Jekyll

發布於

前言

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 了。

參考資料

Jekyll on Ubuntu

Jekyll Sitemap Generator Plugin使用指南

看不過癮?

一鍵登入,即可加入全球最優質中文創作社區