【Windows 筆記】 Jekyll 本地預覽
2020/01/03 Windows Jekyll

blog 使用 Jekyll 建立,所以在 windows 上進行相關環境建置。紀錄一點心得和碰到的錯誤並分享解決的方法,使用 macOS 的朋友可以參考 這裡

安裝 Ruby

下載地址 下載並安裝 選擇第一個 with devkit 的 64 位元版本(除非你電腦 32 位元)

img

添加環境路徑

RUBY 安裝

安裝完成後出現 MSYS2 setup

img

點選 finish,跳出 ruby installer for windows

img

這邊直接按 enter 進入安裝,安裝完成後同樣的指令會再問你一次,直接按 Enter 自動跳離 terminal

安裝 Jekyll

安裝 Jekyll 之前請先將 VSCode 等等的編譯器或是 terminal 重新開啟在執行以下動作

輸入

gem install jekyll

img

切換到 blog 目錄下,查看是否有 Gemflie 文件

img

且內容如下

# frozen_string_literal: true
source "https://rubygems.org"
gem "github-pages", group: :jekyll_plugins

如果沒有以上文件,自行創建,並貼上內容程式碼 輸入

gem install bundler

img

接著輸入

bundler install

img

接著輸入

jekyll s

出現錯誤

img

找了解決辦法,輸入

bundle exec jekyll s

卻出現這錯誤

img

這是因為模板預設系統時間的問題,我們到 Gemfile ,加入這行指令

gem 'tzinfo-data', platforms: [:x64_mingw,:mingw, :mswin]

像這樣

img

再次執行

bundle exec jekyll s

可以運作了,但是可以看到圖中黃字訊息

img

查了一下,這是個警告不是 error 雖然可以運作,但是避免養虎為患,找了解決辦法 將下面指令加入 _config.yml

github: [metadata]

要 Push 前記得 comment 掉

加入後如圖

img

在執行一次

bundle exec jekyll s

img

搞定,完美執行,如果你跟我一樣用 VSCode, Ctrl 按住點 server address 連結 http://xxx.xxx.xx ,就能開啟 Blog 離線預覽