windows安装jekyll
windows安装jekyll
步骤:
- 安装 Ruby
- 安装 DevKit
- 安装 Jekyll
1、安装 Ruby
在Windows上使用RubyInstaller安装比较方便,去Ruby官网下载最新版本的RubyInstaller。注意32位和64位版本的区分。
下载官网推荐的ruby+devkit
安装:使用默认路径即可,避免出错;勾选添加到PATH,就不用手动添加环境变量了
安装完成如图:
这里需要勾选安装msys2,后面安装gem和jekyll时会用到:
2. 安装RubyGems
Windows中下载ZIP格式比较方便,下载后解压到任意路径。进入解压目录,打开cmd,输入以下命令:
ruby setup.rb
3. 安装Jekyll
在cmd中输入:
gem install jekyll
4. 安装jekyll-paginate
在cmd中输入:
gem install jekyll-paginate
5. 验证安装完成
在cmd中输入:
jekyll -v
输出版本说明安装完成
6. 安装bundler
在cmd中输入:
gem install bundler
验证:cmd输入:
bundler -v
7. 新建博客模板
安装完成,我们可以用jekyll命令创建一个博客模板,进入一个目录,打开命令行执行:
jekyll new testblog
cd testblog
jekyll serve
在浏览器输入http://127.0.0.1:4000/即可浏览刚刚创建的blog
遇到问题及解决
1. gem install jekyll时报错,而且还是乱码!
C:\User>gem install jekyll
Temporarily enhancing PATH for MSYS/MINGW...
Building native extensions. This could take a while...
ERROR: Error installing jekyll:
ERROR: Failed to build gem native extension.
current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
C:/Ruby25-x64/bin/ruby.exe -r ./siteconf20180308-3672-ueo7ea.rb extconf.rb
creating Makefile
current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
make "DESTDIR=" clean
'make' �����ڲ����ⲿ���Ҳ���ǿ����еij���
���������ļ���
current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
make "DESTDIR="
'make' �����ڲ����ⲿ���Ҳ���ǿ����еij���
���������ļ���
make failed, exit code 1
Gem files will remain installed in C:/Ruby24-x64/bin/ruby_builtin_dlls/Ruby24-x6
4/lib/ruby/gems/2.4.0/gems/http_parser.rb-0.6.0 for inspection.
Results logged to C:/Ruby24-x64/bin/ruby_builtin_dlls/Ruby24-x64/lib/ruby/gems/2
.4.0/extensions/x64-mingw32/2.4.0/http_parser.rb-0.6.0/gem_make.out
参考oneclick/rubyinstaller2的 issue #98。
首先cmd中输入:
chcp 850
切换编码之后安装:
gem install jekyll
下面是报错:
Temporarily enhancing PATH for MSYS/MINGW...
Building native extensions. This could take a while...
ERROR: Error installing jekyll:
ERROR: Failed to build gem native extension.
current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
C:/Ruby25-x64/bin/ruby.exe -r ./siteconf20180308-3672-ueo7ea.rb extconf.rb
creating Makefile
current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
make "DESTDIR=" clean
'make' 不是内部或外部命令,也不是可运行的程序或批处理文件。
current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
make "DESTDIR="
'make' 不是内部或外部命令,也不是可运行的程序或批处理文件。
make failed, exit code 1
Gem files will remain installed in C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_p
arser.rb-0.6.0 for inspection.
Results logged to C:/Ruby25-x64/lib/ruby/gems/2.5.0/extensions/x64-mingw32/2.5.0
/http_parser.rb-0.6.0/gem_make.out
原来是没有make指令,上面的步骤其实已经安装了msys2,所以不会出现问题。对于没有勾选的童鞋,可以在cmd中输入下面命令来安装:
ridk install
安装完成之后再次安装jekyll和jekyll-paginate就ok了。
2. jekyll serve启动报错
首先看看是不是把serve
打成了server
Incremental build: disabled. Enable with --incremental
Generating...
jekyll 3.7.3 | Error: Permission denied @ rb_sysopen - C:/Users/username/NTUSER.DAT
这是因为jekyll默认使用4000端口,而4000是FoxitProtect(福昕阅读器的一个服务)的默认端口。网上有教程说kill掉FoxitProtect的进程,但是我觉得首先这个比较麻烦,其次重启计算机时FoxitProtect是默认启动的,除非关闭这个服务,这样又可能带来其他问题。所以最简单的办法还是指定端口:
jekyll serve -P 5555
参考链接: