「八千年前的陶工与今天的 AI，不约而同画出了同一个图形——有些直觉，比文明更古老。」
一个温暖的 Hexo 博客主题，灵感来自 Claude 的配色方案。
米色背景搭配淡橙色方格草稿纸纹理，营造沉浸式阅读体验。
 |
 |
- Claude 风格配色（温暖米色 + 橙色强调）
- 淡橙色方格草稿纸背景
- 文章页单栏布局 + 右侧 TOC 目录（sticky 定位，滚动高亮）
- 首页卡片式文章列表
- 响应式设计（移动端自动隐藏 TOC）
- 霞鹜文楷 GB 字体（CDN 分片加载）
- 支持亮色、暗色主题，自适应切换，并支持手动切换
- 评论系统集成：Waline、Giscus（基于 GitHub Discussions），均可选开启，支持并存
- 数学公式渲染（MathJax v4，可选开启）
将主题克隆到 Hexo 博客的 themes 目录：
cd your-hexo-blog
git clone https://github.com/finch-xu/hexo-theme-warmpaper.git themes/warmpaper安装 EJS 渲染器（如果尚未安装）：
npm install hexo-renderer-ejs --save在博客根目录的 _config.yml 中启用主题：
theme: warmpaper- Node.js >= 14
- Hexo CLI (
npm install -g hexo-cli)
- 创建一个测试用的 Hexo 博客：
hexo init hexo-test-blog
cd hexo-test-blog
npm install
npm install hexo-renderer-ejs --save- 将主题链接到博客的 themes 目录：
# 方式一：符号链接（推荐，修改即时生效）
ln -s /path/to/hexo-theme-warmpaper themes/warmpaper
# 方式二：直接克隆
git clone https://github.com/finch-xu/hexo-theme-warmpaper.git themes/warmpaper- 修改博客
_config.yml：
theme: warmpaper- 创建一些测试文章（确保包含多级标题以测试 TOC）：
hexo new post "测试文章"hexo clean && hexo server访问 http://localhost:4000 预览。修改主题文件后刷新页面即可看到效果。
# 清除缓存（修改模板后建议执行）
hexo clean
# 启动本地预览服务器
hexo server
# 启动服务器并监听文件变化
hexo server --draft
# 生成静态文件
hexo generate
# 清除 + 生成 + 预览（一步到位）
hexo clean && hexo generate && hexo server项目中包含 preview.html，可直接在浏览器中打开预览主题的视觉效果，无需搭建 Hexo 环境。
生成静态文件：
hexo clean && hexo generate生成的文件位于 public/ 目录，可部署到任何静态托管服务（GitHub Pages、Vercel、Netlify 等）。
npm install hexo-deployer-git --save在博客 _config.yml 中配置：
deploy:
type: git
repo: https://github.com/your-username/your-username.github.io.git
branch: main执行部署：
hexo clean && hexo deploy编辑主题目录下的 _config.yml：
# 导航菜单
menu:
Home: /
Archives: /archives
# 个人资料卡片（首页文章列表上方）
profile:
avatar: /images/avatar.png # 头像图片路径
description: "一句话简介" # 个人简介
links: # 社交链接（可配置任意数量）
- name: GitHub
url: https://github.com/yourname
icon: github # 支持: github, email, website, twitter, rss, bilibili, zhihu
- name: Email
url: mailto:your@email.com
icon: email
- name: Website
url: https://yoursite.com
icon: website
# 文章目录（右侧边栏）
toc:
enable: true
max_depth: 3
min_depth: 2
list_number: false
# 数学公式（MathJax v4）— 需 Markdown 渲染器透传 $...$，详见下文「数学公式」
math:
enable: false
# Waline 评论系统
waline:
enable: false
serverURL: 'https://your-server-url'
# 文章摘要链接文字
excerpt_link: Read More
# 页脚版权信息（留空则使用默认）
copyright: ""hexo-theme-warmpaper/
├── _config.yml # 主题配置
├── package.json
├── layout/
│ ├── layout.ejs # 基础 HTML 骨架
│ ├── index.ejs # 首页
│ ├── post.ejs # 文章详情页
│ ├── page.ejs # 独立页面
│ ├── archive.ejs # 归档页
│ ├── category.ejs # 分类页
│ ├── tag.ejs # 标签页
│ └── partial/
│ ├── head.ejs # HTML head
│ ├── header.ejs # 导航栏
│ ├── footer.ejs # 页脚
│ ├── profile.ejs # 个人资料卡片
│ ├── post-card.ejs # 文章卡片
│ ├── pagination.ejs # 分页
│ ├── toc.ejs # 目录侧边栏
│ ├── comment.ejs # Waline 评论模板
│ ├── giscus.ejs # Giscus 评论组件
│ └── math.ejs # MathJax 公式组件
└── source/
├── css/
│ ├── style.css # 主样式表
│ ├── waline.css # Waline 评论样式
│ ├── giscus.css # Giscus 评论样式
│ └── math.css # 数学公式样式
├── images/
│ └── logo.svg # 主题默认 Logo
└── js/
└── main.js # TOC 滚动追踪
主题内置 MathJax v4 渲染 LaTeX 公式，默认关闭。在 _config.yml 中开启：
math:
enable: true- 行内公式用
$ ... $或\( ... \)，块级公式用$$ ... $$或\[ ... \]。 - 单篇覆盖：在文章 front-matter 写
math: true（强制开启）或math: false（单篇关闭）。 - 仅在文章和独立页面加载，首页与列表页不加载。
重要前提：Markdown 渲染器需保留 $...$。 Hexo 默认的 hexo-renderer-marked 会把 x_i 解析成斜体、吞掉 \alpha 的反斜杠，导致公式错乱。请改用支持数学的渲染器，例如：
npm un hexo-renderer-marked
npm i hexo-renderer-markdown-itMathJax 从 jsDelivr CDN 按需加载（已锁定版本
4.1.2并启用 SRI 完整性校验；升级时需同时更新版本号与integrity哈希）。若你此前自行接入过 MathJax / KaTeX，请先移除，避免公式被渲染两遍。
本主题使用以下外部字体资源：
用于全站排版的开源楷体字体（正文、导航栏、TOC 等均统一使用），基于 FONTWORKS Klee One 衍生，符合大陆 G 源字形标准。
- 字体原仓库: https://github.com/lxgw/LxgwWenkaiGB
- Webfont 分片包: https://github.com/CMBill/lxgw-wenkai-gb-web
- CDN (Regular): https://cdn.jsdelivr.net/npm/lxgw-wenkai-gb-web@latest/lxgwwenkaigb-regular/result.css
- CDN (Medium): https://cdn.jsdelivr.net/npm/lxgw-wenkai-gb-web@latest/lxgwwenkaigb-medium/result.css
- 字体许可证: SIL Open Font License 1.1
主题代码基于 MIT License 发布。
引用的字体资源遵循 SIL Open Font License 1.1 许可证。