shuijiao_jekyll_theme
| 关于 | 搜索 | 归档 | 标签 | RSS

关于

shuijiao_jekyll_theme

一款基于 kotet/ultralight 主题修改的极简 Jekyll 主题。主题名称来自于我给我弟弟取的小名，水饺。

主题特性

部署到 Cloudflare Pages

与部署到 GitHub Pages 不同的是，部署到 Cloudflare Pages 时免费用户也支持使用私密 Github 仓库进行部署，并且可以自己设置网址（如：[你想要的名字].pages.dev）

  • 为仓库点上 Star ，点击 Code→Download ZIP 下载主题源代码

  • 点击自己的头像，点击菜单中的 Repositories ，点击 New 创建一个新仓库以存储主题源代码和你写的文章

  • 点击 uploading an existing file ，把主题源代码上传到你的 Github 仓库

  • 打开 https://dash.cloudflare.com/，登录或注册 Cloudflare 账号

  • 点击侧边栏中的 计算（Workers）→ Workers 和 Pages ，点击 创建应用程序→Pages→导入现有 Git 存储库。如果你没有在 Cloudflare 绑定你的 Github 账号，按照提示进行绑定

  • 选择你上传了主题源代码的 GitHub 仓库，点击开始设置

  • 设置项目名称，默认是你 GitHub 仓库的名字。你设置的项目名称将作为你博客的网址，如你将你的项目名称设置为 doin ，那么你博客的网址就是 doin.pages.dev

  • 在 构建设置 将 框架预设 设置为 Jekyll，新建名为 BUNDLE_WITHOUT 的环境变量，值为 ""，点击 保存并部署

  • 此时大概率会在 正在构建应用程序 报错，如果出现这种情况点击 继续处理项目→继续 ，点击 设置→构建系统版本 ，将 生产系统版本 和 预览系统版本 都改为 版本2

  • 点击 部署 ，在 所有部署 一栏可以看到你刚刚的部署记录，点击那一行部署记录右侧的 三个点，点击 重试部署

  • 部署成功！你的博客已经上线了。

自定义

博客部署成功之后，你需要对你的博客进行自定义。首先回到你的 GitHub 仓库，打开 _config.yml 文件，点击代码上方的小铅笔修改 _config.yml 的变量。以下是对主要变量内容的说明：

title: 你博客的标题，这将显示在顶栏和页面标题中
description: 博客描述
feed_items: RSS显示的文章数量，默认500

如果你想要自定义顶栏链接，那么你需要在仓库根目录创建一个新的 .md 文件，文件可以任意命名。以下是此 .md 文件的模板：

---
layout: page
title: 关于 #页面标题
nav_order: 2 #在顶栏中的显示顺序，数值越小越靠左，计数从2开始
permalink: /about/ #页面链接
---
#页面内容（可选，依需求而定）

发布文章

Jekyll博客使用Markdown语法。虽然你可以直接在不使用编辑器的情况下使用Markdown语法，但我还是建议你下载一个编辑器，目前我正在使用MarkText。在发布文章时，你需要将文件上传到你的Github博客仓库下的_posts文件夹中，按照年-月-日-标题.md的格式命名，例如2025-11-1-about.md。

以下是.md文件的模板：

---
layout: post 
title:  "test" #标题
tags: jekyll #标签
mathjax: on #开启/关闭Mathjax
---

致谢

本博客主题基于 kotet/ultralight 修改，修改过程得到了 知乎直答 和 Kimi 的帮助。