快速在 Windows 上搭建 Jekyll 開發(fā)環(huán)境

發(fā)布于 2018-03-04 05:30 更新于 2018-08-12 06:50

Jekyll 是一個(gè)不錯(cuò)的靜態(tài)博客工具，本文將提供快速在 Windows 系統(tǒng)上搭建 Jekyll 開發(fā)環(huán)境的方法。

for 老手

其實(shí)所需的命令只有少數(shù)幾個(gè)而已：

代碼語言：JavaScript代碼運(yùn)行次數(shù)：0運(yùn)行復(fù)制

# 全局命令：安裝 ruby 所需的依賴ridk install# 全局命令：安裝 Jekyllgem install jekyll bundler# 工作目錄命令：安裝博客倉庫中所需的依賴bundle install# 工作目錄命令：將本地博客倉庫跑起來jekyll serve

For 新手下載必要的軟件

考慮到我們的網(wǎng)絡(luò)環(huán)境，為了提升本文的閱讀效率，建議一邊下載一邊閱讀。我為大家提供兩種不同的下載源：1. 官方源；2. 加速源。

官方源 Ruby（挑最新的下載即可）MSYS2（雖然這不是必要的，但能大大提高配置環(huán)境的成功率和速度）加速源（感謝小伙伴林德熙） rubyMSYS2安裝 Ruby 和 Jekyll 分別安裝下載好的 Ruby 和 MSYS2 安裝包，一路下一步，直到兩者都安裝結(jié)束； 一般安裝完 Ruby 后會(huì)自動(dòng)彈出一個(gè)新的命令行安裝界面，我們需要在里面選擇 3，然后回車。

如果上一步?jīng)]有提前下載安裝 MSYS2，那么這里會(huì)因?yàn)楸娝苤木W(wǎng)絡(luò)原因速度奇慢無比，或者以失敗告終。如果沒有彈出命令行安裝界面或者把它關(guān)掉了，那么也可以在任意的命令行中輸入 ridk install 來再次進(jìn)入命令行安裝界面。如果網(wǎng)絡(luò)狀況良好，能夠一次裝成功。（如果不幸失敗。則一直再次選 3 繼續(xù)安裝直到全部成功為止。） Install MSYS2 and MINGW development toolchain succeeded

再打開一個(gè)新的命令行窗口（cmd/powershell/bash/msys2 都行），輸入以下命令安裝 jekyll： gem install jekyll bundler

自此，Jekyll 開發(fā)環(huán)境就搭建完成了。

讓自己的博客跑起來

如果你已經(jīng)有了自己的 Jekyll 博客，希望在本地能夠編譯運(yùn)行，那么就繼續(xù)閱讀本節(jié)。

可能你的博客來源于這些地方：

從 Jekyll Themes 挑選并下載了一款主題；克隆了自己或別人的博客站點(diǎn)，準(zhǔn)備改改自己用；

那么我們開始。首先在博客的根目錄打開命令行，接下來的操作都在命令行中。

安裝依賴包 bundle install 將 Jekyll 服務(wù)跑起來 jekyll serve

這就完成了！

不過，如果上述第 2 個(gè)步驟發(fā)生了錯(cuò)誤，通常是依賴包的版本不匹配所致，運(yùn)行命令更新依賴包：

代碼語言：javascript代碼運(yùn)行次數(shù)：0運(yùn)行復(fù)制

bundle update

隨后再次 jekyll serve 即可。

Ruby 跨版本升級(jí)的坑

如果你之前安裝過 Ruby 的舊版本，現(xiàn)在需要跨大版本號(hào)升級(jí)，那么你會(huì)遇到很多問題：

ruby 命令對(duì)應(yīng)新舊哪個(gè)版本是不明確的如果你覆蓋安裝了 ruby，那么之前安裝自動(dòng)設(shè)置的那些環(huán)境變量（例如 gem）就會(huì)丟失

這會(huì)導(dǎo)致你試圖編譯你的博客時(shí)遇到各種各樣奇怪的錯(cuò)誤。

所以，你需要做的是：

卸載掉之前的 ruby再次安裝 ruby

本文會(huì)經(jīng)常更新，請(qǐng)閱讀原文： https://walterlv.com/post/setup-jekyll-in-windows.html ，以避免陳舊錯(cuò)誤知識(shí)的誤導(dǎo)，同時(shí)有更好的閱讀體驗(yàn)。

本作品采用 知識(shí)共享署名-非商業(yè)性使用-相同方式共享 4.0 國(guó)際許可協(xié)議 進(jìn)行許可。歡迎轉(zhuǎn)載、使用、重新發(fā)布，但務(wù)必保留文章署名 呂毅 （包含鏈接： https://walterlv.com ），不得用于商業(yè)目的，基于本文修改后的作品務(wù)必以相同的許可發(fā)布。如有任何疑問，請(qǐng) 與我聯(lián)系 (walter.lv@qq.com) 。