--- layout: post title: Jekyll环境搭建(Windows 10) description: Jekyll环境搭建(Windows 10) category: tech thumb: IMG_PATH/jekyll.png tags: [jekyll, windows] ---  最近想把想博客改版需要在本地用到Jekyll,不过搭建的过程真的心累...过程中真的是各种问题谷歌百度各种乱七八糟的文章一点都不靠谱,折腾一天给重要给搭建成功了... 整个搭建过程需要用到的软件/安装依赖我先列下 * Rubyinstaller-2.3.3-x64 * DevKit-mingw64-64-4.7.2 * Gem * Bundler ## 安装Ruby  因为Jekyll是基于ruby开发的,首先下载安装ruby,我不推荐下载Ruby2.3以上的版本,不知道怎么回事2.4、2.5、2.6我都试过感觉他们跟自带BUG似的,总是出现一堆莫名其妙的问题。 ruby官网下载地址(下载速度奇慢) * 官网链接:https://rubyinstaller.org/downloads?achuan.io 我用的ruby 2.3.3这里给大家发出来微云的链接 * 微云链接:https://share.weiyun.com/5vv4fjt?achuan.io * 微云密码:achuan 再次声明一下,这里我用的是ruby 2.3.3,其他版本我并不保证。 1. 双击ruby应用程序,进行安装 注意:默认如果有已勾选项,它会自动帮你配置环境变量,但是环境变量如果不立即生效可以用cmd命令刷新环境变量,如果还不行就重启。 ```bash > echo %PATH% ``` 2. 安装完成后测试一下是否安装成功,若输出版本信息即安装成功。 ```bash > ruby -v ``` ## 更换源 通过gem sources查看当前源 ```bash > gem sources -l ``` 删除源默认源,我这个里默认有一个源,官方源,因为它太慢了,我们删掉它 ```bash > gem sources -r https://rubygems.org/ ``` 以前还有淘宝源可以用,不过现在也就已经凉了,下面是我们要替换成国内RubyGems镜像站点 ```bash > gem sources -a https://gems.ruby-china.com ``` ## DevKit的安装与配置  这里我用的是DevKit 64-4.7.2,这里依然提供微云存储 * 微云链接:https://share.weiyun.com/5sROg49?achuan.io * 微云密码:achuan 1. 双击DevKit应用程序,运行它解压到你想要的位置,尽量url短一点因为等会要用到比如;C:DevKit 2. 初始化与配置 ```bash # 进入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这一步非常重要,还请您仔细检查! ``` 3. 安装 ```bash # 安装 > ruby dk.rb install ``` ## Bundler的安装  Bundler是管理Gem一个依赖工具 注意:minima是我在创建Jekyll项目的时候出现的问题,当我使用 jekyll new achuan.io 创建Jjekyll项目时,命令卡死了,随后Ctrl + C 强行停止后 cd achuan.io 使用 bundler show 查看缺少依赖文件 ```bash 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依赖列表 * addressable (2.6.0) * bundler (2.0.1) * colorator (1.1.0) * concurrent-ruby (1.1.5) * em-websocket (0.5.1) * eventmachine (1.2.7) * ffi (1.10.0) * forwardable-extended (2.6.0) * http_parser.rb (0.6.0) * i18n (0.9.5) * jekyll (3.8.5) * jekyll-feed (0.12.1) * jekyll-sass-converter (1.5.2) * jekyll-seo-tag (2.6.0) * jekyll-watch (2.2.1) * kramdown (1.17.0) * liquid (4.0.3) * listen (3.1.5) * mercenary (0.3.6) * minima (2.5.0) * pathutil (0.16.2) * public_suffix (3.0.3) * rb-fsevent (0.10.3) * rb-inotify (0.10.0) * rouge (3.3.0) * ruby_dep (1.5.0) * safe_yaml (1.0.5) * sass (3.7.4) * sass-listen (4.0.0) * tzinfo (2.0.0) * tzinfo-data (1.2019.1) * wdm (0.1.1) ## 安装Jekyll  通过gem install安装jekyll ```bash > gem install jekyll # 分页 > gem install jekyll-paginate # 查看版本号。出现就ok > jekyll -v jekyll 3.8.6 ``` ## 启动Jekyll  写到这里真的不容易,以前在Linux搭建Jekyll没有这么心累,今windows搭建真的...几十个bug疯狂涌出...算了...留着幸福的泪,码着命令... ```bash # 生成一个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`
本地ip:`127.0.0.1`,端口:`4000`。感觉IP+端口麻烦的话,去VirtualHost配置。
如果不太熟悉VirtualHost配置,可以看我以前的文章:[Ubuntu Server部署日记](https://achuan.io/2018-11-08-Ubuntu-Deployment.html?achuan.io 'Ubuntu Server部署日记')。