本仓库为我的个人博客，主要存放一些技术性文章以及个人笔记。更新频率飘忽不定，尽量每个月尽量更新一篇。
英文版本：https://blog-en.ch3nyang.top/（仅部分文章）
本博客基于 Jekyll 静态网站生成器构建，使用完全自定义的主题 tangerine，并集成了多种实用功能：
| 基础功能 | 内容组织 | 用户体验 | 增强功能 | 扩展插件 |
|---|---|---|---|---|
| 个性主题 | 文章分类 | 响应式设计 | 代码高亮 | GitHub 插件 |
| RSS 订阅 | 文章标签 | 主题切换 | 代码复制 | 图片排版插件 |
| 评论系统 | 文章系列 | 无障碍访问 | 公式支持 | iframe 插件 |
| SEO 优化 | 文章目录 | 文章搜索 | 流程图支持 | 结果预览插件 |
| 性能优化 | 文章归档 | 文章分享 | 内容折叠 | 外部引用插件 |
| 草稿系统 | 版权声明 | 文章总结 | 代码运行插件 | |
| 随笔模板 | 文章推荐 | 全屏显示 | 文件结构插件 | |
| 自动导入插件 | ||||
| 独立网页插件 |
你可以自由地将本博客的主题用于你的博客。
构建前先安装好 Ruby（≥ 3.4.0）和 Jekyll ，然后安装依赖：
bundle install启动本地服务：
jekyll serve然后直接使用 Live Server 预览实时更新。
绝大多数设置都在 _config.yml 文件中，你可以根据自己的需求进行修改。
AI 撰写或修改文章前，请先阅读根目录的 AGENTS.md。其中包含文风、大纲与逐段生成流程、插图约定、元数据和插件语法。
博客文章存放在 _posts 文件夹中，命名格式为 YYYY-MM-DD-title.md。博客文章的文件头应该包含以下信息：
layout: post
title: "原神游玩指南"
date: 2000-01-01 00:00:00 +0800
categories: 游戏 // 只能有一个分类
tags: open-world RPG genshin-impact // 可以有多个标签，用空格分隔
summary: "本文为原神游玩指南，介绍了游戏的基本玩法、角色培养、资源获取等内容，帮助新手玩家快速上手原神。" // 文章摘要，显示在主页
comments: false // 可省略，默认为 true。如果设置为 true，文章会显示评论区；否则不显示
copyrights: original // 可省略，默认为 original。如果设置为 original，文末会显示版权声明；否则不显示
draft: true // 可省略，默认为 false。如果设置为 true，文章不会显示在主页上
archived: true // 可省略，默认为 false。如果设置为 true，文章会被标记为已归档您可能还需要修改 .github 文件夹下的工作流程文件、网站图标 favicon.svg 以及 CNAME，以适应您的需求。
文章中的图片存放在 assets/post/images 文件夹中。如果需要引用图片，请使用相对路径，例如：
scripts 文件夹下提供了脚本，可以帮助对图片进行压缩，也可以自动识别并清楚未使用的图片。如果你需要运行脚本，请先安装好 webp 和 svgo，然后运行：
cd scripts
compress_image.ps1 # 压缩图片
clean_image.ps1 # 清除未使用的图片你可以使用 _test 文件夹下的测试文章进行测试。
使用 result（包括静态输出）、code_runner 或 iframe 的文章会自动添加“实验”标签，在文章列表中突出显示，并可通过标签页集中浏览；也可在文章头部设置 experiment: true 手动纳入，或 experiment: false 排除自动识别。
首页的系列阅读可通过 _config.yml 中的 featured_series 指定详细展示的系列，值须与文章的 series 完全一致；留空、名称无效或该系列不可展示时，自动使用最近更新的系列。其余系列与系列目录页均按各系列最新文章的发布时间倒序排列，系列内部仍按 series_index 排列。生产环境草稿不参与排序，全部归档的系列不展示。
长文阅读位置只保存在当前浏览器，最多保留 30 篇、30 天。再次进入文章时可选择继续阅读或忽略；读到正文末尾会清除该篇记录。
导航中的 RSS 进入 /rss/ 订阅说明页，实际订阅地址仍为 /feed.xml。所有页面均声明 RSS 自动发现链接，支持的阅读器可从说明页找到订阅源；说明页同时明确提示正确地址。
订阅源不再依赖 XSLT，浏览器直访采用独立 CSS。RSS 提供最近 20 篇已发表文章的摘要与完整静态正文：代码、表格、静态输出、目录树与引用保留可读内容；交互演示提供原文章节入口，Mermaid 和公式保留源码。转换只作用于订阅内容，不影响站内插件。
本博客所有文章采用 CC BY-NC-SA 4.0 许可协议。转载请注明出处。
本博客其余代码采用 MIT 许可协议。