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

发布于:2025-04-19 ⋅ 阅读:(20) ⋅ 点赞:(0)

场景:在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卡住-CSDN博客
  4. 淘宝 RubyGems 镜像-阿里云开发者社区
  5. https://zhuanlan.zhihu.com/p/616533705
  6. docker实战——构建Jekyll-CSDN博客

网站公告

今日签到

点亮在社区的每一天
去签到