RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

"Where Cyber-Aesthetics Meets Scientific Precision"

🌐 访问站点 • 🎨 设计理念 • 🛠️ 技术栈 • 🧪 操作指南 • ⚖️ 治理与规范

📖 项目愿景 (Project Vision)

RaineBlog 是一个基于 Hugo 构建的高性能个人技术博客，它是对 "数字园艺 (Digital Gardening)" 的一次深度实践。

本项目致力于融合 赛博朋克美学 (Cyber Aesthetics) 与 严谨科学表达 (Scientific Precision)。通过对 PaperMod 主题的深度重构与 Hugo 构建管线的极限优化，建立一个具备出版级数学渲染能力、毫秒级交互响应以及全方位 SEO 优化的沉浸式阅读空间。

🎨 设计理念 (Design Philosophy)

我们不只是在展示文字，而是在构建一种视觉秩序。

排版美学：采用 'Aleo', "FZNewShuSong" 等衬线字体，建立中西文混排的最佳视觉基准。
玻璃拟态 (Glassmorphism)：利用 backdrop-filter 营造轻盈的层次感，融合疗愈系视觉元素。
暗色模式 (OLED Ready)：深度定制的 OLED 纯黑主题，提供极高对比度且不伤眼的阅读体验。
微交互设计：非线性的过渡动画与反馈逻辑，让静态站点具备生命力。

🛠️ 核心技术矩阵 (Technical Stack)

维度	技术选型	功能说明
SSG 引擎	Hugo Extended (0.132+)	基于 Go 的极速构建，支持原生 Math 转换与 PostCSS
UI 基座	PaperMod (Customized)	深度定制的极简主题，增强了无障碍性与 SEO 权重
数学渲染	Hugo Native Math + KaTeX	采用 Goldmark Passthrough + `transform.ToMath` 极速渲染
SEO 增强	Advanced JSON-LD	自研 `seo_advanced` 局部模板，完整覆盖 Schema.org
搜索系统	Fuse.js (Client-side)	零后端依赖的轻量级模糊搜索，保障隐私与速度
评论交互	Giscus	基于 GitHub Discussions 的现代化、无服务器评论系统
多态输出	AMP / RSS / LLMS	针对移动端、阅读器及 AI 模型优化的多种内容格式

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

确保您的开发环境安装了 Hugo Extended Edition。

# 查看版本，确保版本号 >= 0.132.0 (推荐最新版)
hugo version

2. 本地开发

# 递归克隆以包含主题子模块
git clone --recursive https://github.com/raineblog/raineblog.github.io.git
cd raineblog.github.io
# 启动开发服务器 (自动处理草稿与热重载)
hugo server -D

3. 生产构建

# 执行极限压缩与资源指纹化构建
hugo --minify --gc --cleanDestinationDir

📂 仓库拓扑结构 (Project Structure)

raineblog.github.io/
├── assets/css/extended/ # 🎨 自定义样式层 (样式覆盖)
├── content/ # 📝 核心内容库 (Markdown/Math)
├── layouts/ # 🏗️ 结构定制层
│ ├── _default/_markup/ # 数学公式渲染逻辑
│ ├── partials/ # SEO、Giscus、KaTeX 等组件
│ └── index.llms.txt # AI 模型友好的内容入口
├── static/ # 🖼️ 图片、Favicon 等静态资源
├── themes/PaperMod/ # 基础主题子模块
└── hugo.yaml # ⚙️ 核心全局配置文件

⚖️ 治理与规范 (Governance & Contributions)

维护声明

本项目由 RainPPR 个人独立维护。我希望这个项目能够保持其极简与专注的特质，因此在贡献方面有明确的界限：

接受 (Accepted):
- 🐛 Bug 修复: 样式错乱、死链、构建错误等。
- ✍️ 文档纠错: 拼写错误、逻辑不通、过时信息。
原则上不接受 (Declined):
- ✨ 新功能请求: 为了降低维护复杂度，暂不接受功能性添加。

如果您发现了一个问题，欢迎提交 Issue 或 Pull Request。感谢您的理解与支持！

许可协议

文案/内容: CC BY 4.0 (署名 4.0 国际)
代码/组件: MIT License

🤖 智能体声明 (AI Manifest)

这一文档由 Antigravity (Google DeepMind) 驱动的智能体生成。通过对仓库全量源代码的深度静态分析，自动识别了技术栈特性（如 Hugo Passthrough、AMP 输出、LLMS 格式等），并结合用户预设的维护准则构建此文档。

生成详情：

模型: Gemini 2.0 Flash (Thinking Mode)
智能体: Antigravity v1.2
最后更新: 2026-01-28
验收状态: 人工审核通过 ✅

_{如果这个项目对你有启发，欢迎点一个 ⭐ Star。}

Name		Name	Last commit message	Last commit date
.github		.github
archetypes		archetypes
assets/css/extended		assets/css/extended
content		content
data		data
images		images
layouts		layouts
static		static
themes		themes
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.mailmap		.mailmap
.markdownlint.json		.markdownlint.json
LICENSE		LICENSE
README.md		README.md
hugo.yaml		hugo.yaml

Name		Name	Last commit message	Last commit date
.github		.github
archetypes		archetypes
assets/css/extended		assets/css/extended
content		content
data		data
images		images
layouts		layouts
static		static
themes		themes
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.mailmap		.mailmap
.markdownlint.json		.markdownlint.json
LICENSE		LICENSE
README.md		README.md
hugo.yaml		hugo.yaml

Name		Name	Last commit message	Last commit date
.github		.github
archetypes		archetypes
assets/css/extended		assets/css/extended
content		content
data		data
images		images
layouts		layouts
static		static
themes		themes
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.mailmap		.mailmap
.markdownlint.json		.markdownlint.json
LICENSE		LICENSE
README.md		README.md
hugo.yaml		hugo.yaml

Name		Name	Last commit message	Last commit date
.github		.github
archetypes		archetypes
assets/css/extended		assets/css/extended
content		content
data		data
images		images
layouts		layouts
static		static
themes		themes
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.mailmap		.mailmap
.markdownlint.json		.markdownlint.json
LICENSE		LICENSE
README.md		README.md
hugo.yaml		hugo.yaml

Name		Name	Last commit message	Last commit date
.github		.github
archetypes		archetypes
assets/css/extended		assets/css/extended
content		content
data		data
images		images
layouts		layouts
static		static
themes		themes
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.mailmap		.mailmap
.markdownlint.json		.markdownlint.json
LICENSE		LICENSE
README.md		README.md
hugo.yaml		hugo.yaml

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

📖 项目愿景 (Project Vision)

🎨 设计理念 (Design Philosophy)

🛠️ 核心技术矩阵 (Technical Stack)

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

2. 本地开发

3. 生产构建

📂 仓库拓扑结构 (Project Structure)

⚖️ 治理与规范 (Governance & Contributions)

维护声明

许可协议

🤖 智能体声明 (AI Manifest)

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

📖 项目愿景 (Project Vision)

🎨 设计理念 (Design Philosophy)

🛠️ 核心技术矩阵 (Technical Stack)

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

2. 本地开发

3. 生产构建

📂 仓库拓扑结构 (Project Structure)

⚖️ 治理与规范 (Governance & Contributions)

维护声明

许可协议

🤖 智能体声明 (AI Manifest)

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

RaineBlog

🌌 探索赛博美学、前沿技术与科学计算的数字花园 🌌

📖 项目愿景 (Project Vision)

🎨 设计理念 (Design Philosophy)

🛠️ 核心技术矩阵 (Technical Stack)

🧪 环境编排与指南 (Operational Guide)

1. 环境准备

2. 本地开发

3. 生产构建

📂 仓库拓扑结构 (Project Structure)

⚖️ 治理与规范 (Governance & Contributions)

维护声明

许可协议

🤖 智能体声明 (AI Manifest)

About

Resources

Stars