Windows10下Jekyll博客部署全指南｜解决GitHub模板运行失败问题

场景：在GitHub拉取的一个Jekyll博客网站运行不起来

这是想要实现的效果

这是项目代码

概要

前置要求

• git版本控制工具已安装
• windows10环境
• GitHub可以正常上网

相关问题

• Jekyll博客部署常见错误
• GitHub模板运行失败解决方法
• Windows10环境变量配置
• Ruby版本兼容性问题
• Gem源配置优化
• Bundle install依赖修复
• Jekyll serve报错排查

安装Ruby

安装环境和工具

Downloads

一直点确认，更换安装位置，自动进行系统环境变量配置

下载完成需要一点时间

键盘按下数字3，一直下载，出现退出命令，按键盘回车关闭窗口

执行安装命令

进入ruby的安装目录，在文件夹输入cmd

gem install jekyll bundler

bug：黑窗口没反应

因为拉取的下载源在国外，是官方站很慢。移除旧源，改用新源即可。

淘宝的上不去我换了一个。有其他的也可以自己换。

gem sources
gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.com
gem sources -l
gem sources --remove https://rubygems.org/
gem sources -l
*** CURRENT SOURCES ***
https://gems.ruby-china.com

$ 接下来安装
gem install 你想安装的gem

安装Jekyll

下载

 gem install jekyll bundler

下载这个我等待了十分钟左右

查看是否下载成功

jekyll -v
bundler -v

创建一个testweb网站

jekyll new testweb
cd testweb
bundle exec jekyll serve --port 8080

创建完成

在浏览器输入 http://127.0.0.1:8080 

现在就可以在github找一下模板来添加内容，下面这个是我fork的一个。

https://github.com/May16138cccccccccccccccc/al-folio-fork?tab=readme-ov-file

来源：我的博客
我的其他文章：

1. Java零基础指南：从环境配置到核心语法与实战技巧
2. Windows 10专业版Docker安装全攻略｜WSL2配置+汉化+镜像加速一站式指南
3. Redis使用场景

参考资料

1. https://zhuanlan.zhihu.com/p/672713591
2. Windows 上的 Jekyll | Jekyll • 简单、支持博客、静态网站 中文
3. 解决gem install jekyll 不能运行的问题_gem卡住-优快云博客
4. 淘宝 RubyGems 镜像-阿里云开发者社区
5. https://zhuanlan.zhihu.com/p/616533705
6. docker实战——构建Jekyll-优快云博客