快速在 Windows 上搭建 Jekyll 开发环境

快速在 Windows 上搭建 Jekyll 开发环境

发布于 2018-03-04 05:30 更新于 2018-08-12 06:50

Jekyll 是一个不错的静态博客工具,本文将提供快速在 Windows 系统上搭建 Jekyll 开发环境的方法。


For 老手

其实所需的命令只有少数几个而已:

# 全局命令:安装 Ruby 所需的依赖
ridk install
# 全局命令:安装 Jekyll
gem install jekyll bundler
# 工作目录命令:安装博客仓库中所需的依赖
bundle install
# 工作目录命令:将本地博客仓库跑起来
jekyll serve

For 新手

下载必要的软件

考虑到我们的网络环境,为了提升本文的阅读效率,建议一边下载一边阅读。我为大家提供两种不同的下载源:1. 官方源;2. 加速源。

  1. 官方源
  2. 加速源(感谢小伙伴林德熙

安装 Ruby 和 Jekyll

  1. 分别安装下载好的 Ruby 和 MSYS2 安装包,一路下一步,直到两者都安装结束;
  2. 一般安装完 Ruby 后会自动弹出一个新的命令行安装界面,我们需要在里面选择 3,然后回车。
  • 如果上一步没有提前下载安装 MSYS2,那么这里会因为众所周知的网络原因速度奇慢无比,或者以失败告终。
  • 如果没有弹出命令行安装界面或者把它关掉了,那么也可以在任意的命令行中输入 ridk install 来再次进入命令行安装界面。
  • 如果网络状况良好,能够一次装成功。(如果不幸失败。则一直再次选 3 继续安装直到全部成功为止。) Install MSYS2 and MINGW development toolchain succeeded
  1. 再打开一个新的命令行窗口(cmd/powershell/bash/msys2 都行),输入以下命令安装 jekyll: gem install jekyll bundler

自此,Jekyll 开发环境就搭建完成了。

让自己的博客跑起来

如果你已经有了自己的 Jekyll 博客,希望在本地能够编译运行,那么就继续阅读本节。

可能你的博客来源于这些地方:

那么我们开始。首先在博客的根目录打开命令行,接下来的操作都在命令行中。

  1. 安装依赖包 bundle install
  2. 将 Jekyll 服务跑起来 jekyll serve

这就完成了!

不过,如果上述第 2 个步骤发生了错误,通常是依赖包的版本不匹配所致,运行命令更新依赖包:

bundle update

随后再次 jekyll serve 即可。

Ruby 跨版本升级的坑

如果你之前安装过 Ruby 的旧版本,现在需要跨大版本号升级,那么你会遇到很多问题:

  • ruby 命令对应新旧哪个版本是不明确的
  • 如果你覆盖安装了 ruby,那么之前安装自动设置的那些环境变量(例如 gem)就会丢失

这会导致你试图编译你的博客时遇到各种各样奇怪的错误。

所以,你需要做的是:

  • 卸载掉之前的 ruby
  • 再次安装 ruby

本文会经常更新,请阅读原文: https://walterlv.com/post/setup-jekyll-in-windows.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 (walter.lv@qq.com)

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏区块链

我们不一样的黑客渗透教程第三课,CVE20177269实战测试

很多人想学黑客知识,却不知如何入门,网上的教程也太繁琐,小白看了也头疼,那还是我来写黑客系列入门教程吧,跟着我做,你能黑客入门的。我已经写了两篇了,第1篇在 《...

44560
来自专栏魏艾斯博客www.vpsss.net

UPUPW 绿色服务器平台安装使用教程 windows 建站不求人

很多人在使用 Windows 服务器搭建网站,windows 服务器版自带的 IIS 和 asp、php 建站环境搭建起来比较麻烦,于是就有了众多第三方软件。魏...

82830
来自专栏Django中文社区

Django开发社交类网站必备的10个第三方应用

Django 的好处就是大而全,不仅内置了 ORM、表单、模板引擎、用户系统等,而且第三方应用的生态也是十分完善,开发中大部分常见的功能都能找到对应的第三方实现...

41670
来自专栏沃趣科技

Oracle集群时间同步

在RAC中集群的时间应该是保持同步的,否则可能导致很多问题,比如:依赖于时间的应用会造成数据的错误,各种日志打印的顺序紊乱,这将会影响问题的诊断,严重的可能会导...

17640
来自专栏FreeBuf

安全运维之如何找到隐匿于last和w命令中的ssh登录痕迹

*本文原创作者:ForrestX386,本文属FreeBuf原创奖励计划,未经许可禁止转载

12220
来自专栏hotqin888的专栏

局域网linux系统CentOS上部署engineercms、docker和onlyoffice实现文档协作

等了好久,这次终于下决心在局域网部署了linux系统,并安装docker和load了onlyoffice,利用engineercms进行资料管理和文档协作。

27530
来自专栏PHP在线

Web安全实战

前言 本章将主要介绍使用Node.js开发web应用可能面临的安全问题,读者通过阅读本章可以了解web安全的基本概念,并且通过各种防御措施抵御一些常规的恶意攻击...

384100
来自专栏SAP最佳业务实践

SAP最佳业务实践:使用看板的生产制造(233)-8经典看板:使用警报的库存转储(完整仓库管理)

image.png 若要对通过完整仓库管理处理过的组件进行转储,可使用此功能。当看板设置为 空 时,此功能将自动触发创建运输请求和运输单。 1、PK13N将可用...

33870
来自专栏小特工作室

Navi.Soft31.微信WinForm框架(含下载地址)

1.概述 1.1应用场景 微信的出现,改变了我们日常生活。而微信公众平台的出现,使我们每个人都可能成为一个品牌,微商的普及、微店越来越多。越来越多的人,借助微信...

30370
来自专栏月色的自留地

在龙芯小本上安装Debain8.10

26240

扫码关注云+社区

领取腾讯云代金券