[English | 中文]
一个简洁优雅的 Hexo 博客主题，设计灵感来自王垠的个人网站
- 项目动机：《博客主题共享计划（草稿）》
- 设计灵感：https://www.yinwang.org
- 在线演示：https://smallyunet.github.io/hexo-theme-yinwang-demo/
- 🌐 多语言支持（中文/英文）
- 📱 响应式设计
- 🏷️ 标签云页面
- 📝 微博页面（基于 GitHub Issues）
- 📊 分类页面
- 👤 关于页面
- 📄 自定义页面支持
- 🔢 字数统计
- 📐 LaTeX 公式渲染支持
在使用本主题前，请确保：
-
多语言设置：修改博客项目
_config.yml文件中的language字段：en- 英文zh-cn- 中文
-
页面类型说明：支持以下自定义页面类型
tags- 标签页categories- 分类页about- 关于页display- 展示页micro-blog- 微博页
-
图标配置：将
favicon.svg等图标文件放在博客项目的source文件夹下（不是主题的 source 目录） -
问题反馈：使用过程中遇到问题，欢迎在 Issues 中讨论或提交 PR
# 如果还没有博客项目，先创建一个
hexo init my-blog
cd my-blog
npm install
# 如果已有项目，直接进入项目目录
cd your-blog-directory将本主题下载或克隆到博客项目的 themes 目录下：
git clone https://github.com/smallyunet/hexo-theme-yinwang.git themes/hexo-theme-yinwangnpm install --save hexo-renderer-pug
npm install --save hexo-wordcount-sy编辑博客根目录的 _config.yml 文件：
# 启用主题
theme: hexo-theme-yinwang
# 禁用默认代码高亮（主题有自己的高亮方案）
highlight:
enable: false
# 设置博客标题
subtitle: 你的博客标题复制主题配置文件到博客根目录（可选）：
cp themes/hexo-theme-yinwang/_config.yml _config.theme.ymlhexo clean && hexo server为了简化安装过程，我们提供了预配置的模板项目：
模板特性：
- ✅ LaTeX 公式渲染
- ✅ 微博页面
- ✅ 标签云页面
- ✅ 分类页面
- ✅ 关于页面
- ✅ 外链支持
git clone https://github.com/smallyunet/hexo-theme-yinwang-demo.git my-blog
cd my-blog
npm install
hexo server微博页面可以展示基于 GitHub Issues 的微博内容。
在主题配置文件中设置：
github:
owner: your-username # GitHub 用户名
repo: your-repo-name # 仓库名
micro_blogs:
- year: 2023
issue: 1 # Issue 编号
issue_years: [] # 自动获取的年份，留空则手动指定hexo new page micro-blog编辑 source/micro-blog/index.md：
---
title: 微博
date: 2023-07-26 11:03:03
type: micro-blog
---# 方式1：配置文件中设置 issue_years 后自动获取
hexo generate
# 方式2：手动指定��份
hexo generate 2023hexo new page tags编辑 source/tags/index.md：
---
title: 标签云
date: 2022-08-30 18:07:20
type: tags
---hexo new page categories编辑 source/categories/index.md：
---
title: 分类
date: 2022-08-30 18:07:20
type: categories
---hexo new page about编辑 source/about/index.md：
---
title: 关于
date: 2022-08-30 18:07:20
type: about
---
在这里写关于你的内容...主题提供了丰富的配置选项，以下是完整的配置示例：
# 导航菜单（路径开头不带斜杠）
menu:
博客: ''
微博: micro-blog
标签云: tags
关于: about
# 分页设置（建议页数大于1时开启）
paginator: false
# 头部设置
header:
blank: false # 头部链接是否在新标签页打开
# 文章列表设置
list:
date: true # 是否显示文章日期
wordcount: true # 是否显示字数统计
# 页脚设置
footer:
display: false # 是否显示页脚
href: "" # 页脚链接（如ICP备案链接）
text: "© your-domain.com" # 页脚文字内容
# 文章页面设置
post:
title_h1: false # 文章标题是否使用 h1 标签
blank: false # 文章链接是否在新标签页打开
backHome: false # 文章末尾是否显示"返回首页"
backhome_right: false # "返回首页"是否右对齐
backHome_hr: false # "返回首页"前是否显示分割线
backHome_prefix: "↶ " # "返回首页"前缀
backHome_content: "返回首页" # "返回首页"文字内容
backHome_suffix: "" # "返回首页"后缀
show_tags: true # 文章末尾是否显示标签
# 标签云设置
tags:
all: true # 标签云页面是否显示全部标签
# 微博设置
github:
owner: your-username # GitHub 用户名
repo: your-repo-name # 仓库名
micro_blogs:
- year: 2023
issue: 1 # Issue 编号
issue_years: [] # 自动获取年份列表
# Google Analytics（可选）
google_analysis:
enable: false
id: G-XXXXXXXXXXX- 导航菜单：可以自定义导航栏的菜单项和对应页面
- 文章设置：控制文章页面的���示效果和功能
- 微博功能：基于 GitHub Issues 实现微博功能
- 样式定制：多数样式都可以通过配置文件调整
主题支持 LaTeX 数学公式渲染，推荐使用以下插件：
npm install hexo-filter-mathjax --save在博客的 _config.yml 中添加：
mathjax:
tags: none # 或 'ams' 或 'all'
single_dollars: true # 启用单个$符号
cjk_width: 0.9 # 相对 CJK 字符的宽度
normal_width: 0.6 # 相对正常字符的宽度
append_css: true # 将 CSS 添加到每个页面
every_page: false # 如果为 true，每个页面都会渲染 MathJax，不管是否有公式在文章中使用数学公式：
行内公式：$E = mc^2$
块级公式：
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建你的特性分支 (
git checkout -b feature/AmazingFeature) - 提交你的修改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开一个 Pull Request
- 发现 Bug？请在 Issues 中报告
- 有功能建议？欢迎在 Issues 中讨论
- 需要帮助？可以在 Issues 中提问
本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。
- 设计灵感来自 王垠的个人网站
- 感谢所有贡献者和使用者的支持
如果这个主题对你有帮助，请考虑给个 ⭐️ Star！