【Hexo】安知鱼主题快速安装指南

介绍

image-20241019133027647

安知鱼主题 是基于 Hexo 的一款 简单、美丽 的主题，由 安知鱼 负责开发与维护。

主题 GitHub: https://github.com/anzhiyu-c/hexo-theme-anzhiyu

预览: 👍 AnZhiYu || 🤞 AnZhiYu

文档: 📖 anzhiyu Docs

一款基于hexo-theme-butterfly修改的主題

安装步骤

主题作者安装视频教程：anzhiyu主题安装

更多详细配置：安知鱼主题指南

前置条件

可参考文章： Hexo基本使用

  • Node
  • Git
  • hexo-cli

主题安装

切换到博客根目录

1
cd blog

方式一(Github 推荐):

1
git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

如遇安装不上可以使用以下url代理安装

1
git clone -b main https://ghproxy.com/https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

方式二(Release 推荐):

下载 最新 release 版本 解压到 themes 目录，并将解压出的文件夹重命名为 anzhiyu。

应用主题

打开 Hexo 根目录下的 config.yml, 找到以下配置项，把主题改为anzhiyu

1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: anzhiyu

安装 pug 和 stylus 渲染插件

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

无法安装可以使用cnpm进行安装

1
npm install hexo-renderer-pug hexo-renderer-stylus --save --registry=http://registry.npmmirror.com

覆盖配置

覆盖配置可以使主题配置放置在 anzhiyu 目录之外，避免在更新主题时丢失自定义的配置。

通过 Npm 安装主题的用户可忽略，其他用户建议学习使用。

  • macos/linux 在博客根目录运行
1
cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml
  • windows 复制/themes/anzhiyu/_config.yml此文件到 hexo 根目录，并重命名为_config.anzhiyu.yml

以后如果修改任何主题配置，都只需修改 _config.anzhiyu.yml 的配置即可。

注意：

  • 只要存在于 _config.anzhiyu.yml 的配置都是高优先级，修改原 _config.yml 是无效的。
  • 每次更新主题可能存在配置变更，请注意更新说明，可能需要手动对 _config.anzhiyu.yml 同步修改。
  • 想查看覆盖配置有没有生效，可以通过 hexo g --debug 查看命令行输出。
  • 如果想将某些配置覆盖为空，注意不要把主键删掉，不然是无法覆盖的

重新部署

最后执行Hexo 三连

1
hexo clean && hexo generate && hexo server

可简写为：

1
hexo cl && hexo g && hexo s

效果如下：

image-20241019142638773