最近想把想博客改版需要在本地用到Jekyll,不过搭建的过程真的心累...过程中真的是各种问题谷歌百度各种乱七八糟的文章一点都不靠谱,折腾一天给重要给搭建成功了...
整个搭建过程需要用到的软件/安装依赖我先列下
因为Jekyll是基于ruby开发的,首先下载安装ruby,我不推荐下载Ruby2.3以上的版本,不知道怎么回事2.4、2.5、2.6我都试过感觉他们跟自带BUG似的,总是出现一堆莫名其妙的问题。
ruby官网下载地址(下载速度奇慢)
我用的ruby 2.3.3这里给大家发出来微云的链接
再次声明一下,这里我用的是ruby 2.3.3,其他版本我并不保证。
> echo %PATH%
> ruby -v
通过gem sources查看当前源
> gem sources -l
删除源默认源,我这个里默认有一个源,官方源,因为它太慢了,我们删掉它
> gem sources -r https://rubygems.org/
以前还有淘宝源可以用,不过现在也就已经凉了,下面是我们要替换成国内RubyGems镜像站点
> gem sources -a https://gems.ruby-china.com
这里我用的是DevKit 64-4.7.2,这里依然提供微云存储
双击DevKit应用程序,运行它解压到你想要的位置,尽量url短一点因为等会要用到比如;C:DevKit
初始化与配置
# 进入DevKit目录并执行命令,初始化生成 config.yml
> ruby dk.rb init
进入DevKit目录并编辑config.yml
# 用cmd命令记事本来编辑config.yml
> notepad config.yml
# Example:
#
# ---
# - C:/ruby19trunk
# - C:/ruby192dev
#
---
- H:/environment/Ruby23-x64
注意:“- H:/environment/Ruby23-x64”,其中的“-”也是符号!配置config.yml这一步非常重要,还请您仔细检查!
# 安装
> ruby dk.rb install
Bundler是管理Gem一个依赖工具 注意:minima是我在创建Jekyll项目的时候出现的问题,当我使用 jekyll new achuan.io 创建Jjekyll项目时,命令卡死了,随后Ctrl + C 强行停止后 cd achuan.io 使用 bundler show 查看缺少依赖文件
Could not find gem 'minima (~> 2.0) x64-mingw32' in any of the gem sources
listed in your Gemfile.
# 它说我在gem源中找不到 “minima”, 然后我就安装了,不过装好后又出现这样的tzinfo-data和wdm...提前列出以防大家走弯路。
> gem install bundler
# gem 依赖文件
> gem install minima
> gem install tzinfo-data
> gem install wdm
下面是gem依赖列表
通过gem install安装jekyll
> gem install jekyll
# 分页
> gem install jekyll-paginate
# 查看版本号。出现就ok
> jekyll -v
jekyll 3.8.6
写到这里真的不容易,以前在Linux搭建Jekyll没有这么心累,今windows搭建真的...几十个bug疯狂涌出...算了...留着幸福的泪,码着命令...
# 生成一个Jekyll模板并进入它
> jekyll new achuan.io && achuan.io
# 启动Jeykll,默认端口4000
> jekyll serve
# 成功后显示如下
H:\git\achuanya.github.io>jekyll serve
Configuration file: H:/git/achuanya.github.io/_config.yml
Source: H:/git/achuanya.github.io
Destination: H:/git/achuanya.github.io/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 1.196 seconds.
Please add the following to your Gemfile to avoid polling for changes:
gem 'wdm', '>= 0.1.0' if Gem.win_platform?
Auto-regeneration: enabled for 'H:/git/achuanya.github.io'
Server address: https://127.0.0.1:4001/
Server running... press ctrl-c to stop.
打开浏览器输入:127.0.0.1:4000
<br>
本地ip:127.0.0.1
,端口:4000
。感觉IP+端口麻烦的话,去VirtualHost配置。<br>
如果不太熟悉VirtualHost配置,可以看我以前的文章:Ubuntu Server部署日记。