Jekyll 搭建静态网站

Jekyll 是一个简单的免费的静态网页生成工具，不需要数据库支持，可以配合第三方服务，可以免费部署在 Github 上，而且可以绑定自己的域名。

简介

• Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过一个转换器（如 Markdown）和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上，也就是说，你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。
• 官方网站：http://jekyllcn.com/
• 中文文档：https://www.wenjiangs.com/doc/jekyll-home

依赖

安装 Jekyll 相当简单，但是你得先做好一些准备工作。开始前你需要确保你在系统里已经有如下配置。

• Ruby（including development headers, Jekyll 2 需要 v1.9.3 及以上版本，Jekyll 3 需要 v2 及以上版本）
• RubyGems
• NodeJS, 或其他 JavaScript 运行环境（Jekyll 2 或更早版本需要 CoffeeScript 支持）。
• Python

安装方法

• 官方 Windows 安装文档

安装 Ruby

• 下载 Ruby

• 下载后安装，注意 ：Ruby 的安装路径不能有空格，类似 Program Files 这种地方是不可以的
• 之后会自动配置一些东西 MSYS2.

• 测试，执行 gem -v 能看到版本说明 Ruby 安装成功

$ gem -v
3.2.33

安装 Jekyll

• 执行命令

gem install jekyll bundler

创建 Demo

• 执行命令

jekyll new my-awesome-site
cd my-awesome-site
bundle install
bundle add webrick  # 如果 Ruby 3+ 需要执行此命令
bundle exec jekyll serve

• 打开浏览器 http://localhost:4000 ，可以看到示例页面

更换主题

• Jekyll 支持很多主题，列表
• 我们以 jekyll-theme-yat 主题 为例

• 在 Gemfile 文件添加：

gem "jekyll-theme-yat"

• 在 _config.yml 文件添加

theme: jekyll-theme-yat

• 执行命令渲染：

bundle

• 运行服务

bundle exec jekyll serve

• 进入 http://127.0.0.1:4000/

参考资料

• http://jekyllcn.com/
• https://www.wenjiangs.com/doc/jekyll-home
• https://blog.csdn.net/huyuchengus/article/details/121002469
• https://github.com/jeffreytse/jekyll-theme-yat/
• https://www.jianshu.com/p/48e1d76fd36b
• https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll

文章链接：
https://www.zywvvd.com/notes/tools/jekyll/usage/