Jekyll环境搭建(Windows 10) |
|
這些年來
L0
• 2020-03-15 • 回复 0 • 只看楼主
• 举报
|
最近想把想博客改版需要在本地用到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官网下载地址(下载速度奇慢)
我用的ruby 2.3.3这里给大家发出来微云的链接
- 微云链接:https://share.weiyun.com/5vv4fjt?achuan.io
- 微云密码:achuan
再次声明一下,这里我用的是ruby 2.3.3,其他版本我并不保证。
- 双击ruby应用程序,进行安装
注意:默认如果有已勾选项,它会自动帮你配置环境变量,但是环境变量如果不立即生效可以用cmd命令刷新环境变量,如果还不行就重启。
> echo %PATH%
- 安装完成后测试一下是否安装成功,若输出版本信息即安装成功。
> ruby -v
更换源
通过gem sources查看当前源
> gem sources -l
删除源默认源,我这个里默认有一个源,官方源,因为它太慢了,我们删掉它
> gem sources -r https://rubygems.org/
以前还有淘宝源可以用,不过现在也就已经凉了,下面是我们要替换成国内RubyGems镜像站点
> gem sources -a http://gems.ruby-china.com
DevKit的安装与配置
这里我用的是DevKit 64-4.7.2,这里依然提供微云存储
- 微云链接:https://share.weiyun.com/5sROg49?achuan.io
- 微云密码:achuan
- 双击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的安装
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 sourceslisted 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
> gem install jekyll# 分页> gem install jekyll-paginate# 查看版本号。出现就ok> jekyll -vjekyll 3.8.6
启动Jekyll
写到这里真的不容易,以前在Linux搭建Jekyll没有这么心累,今windows搭建真的…几十个bug疯狂涌出…算了…留着幸福的泪,码着命令…
# 生成一个Jekyll模板并进入它> jekyll new achuan.io && achuan.io# 启动Jeykll,默认端口4000> jekyll serve# 成功后显示如下H:\git\achuanya.github.io>jekyll serveConfiguration 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: http://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部署日记 。