介绍
安知鱼主题 是基于 Hexo 的一款 简单、美丽 的主题,由 安知鱼 负责开发与维护。
主题 GitHub: https://github.com/anzhiyu-c/hexo-theme-anzhiyu
文档: 📖 anzhiyu Docs
一款基于hexo-theme-butterfly修改的主題
安装步骤
主题作者安装视频教程:anzhiyu主题安装
更多详细配置:安知鱼主题指南
前置条件
可参考文章: Hexo基本使用
- Node
- Git
- hexo-cli
主题安装
切换到博客根目录
bash
cd blog
方式一(Github 推荐):
bash
git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu
如遇安装不上可以使用以下url代理安装
bash
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
yaml
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: anzhiyu
安装 pug 和 stylus 渲染插件
bash
npm install hexo-renderer-pug hexo-renderer-stylus --save
无法安装可以使用cnpm进行安装
bash
npm install hexo-renderer-pug hexo-renderer-stylus --save --registry=http://registry.npmmirror.com
覆盖配置
覆盖配置可以使主题配置
放置在 anzhiyu 目录之外,避免在更新主题时丢失自定义的配置。
通过 Npm 安装主题的用户可忽略,其他用户建议学习使用。
- macos/linux 在博客根目录运行
bash
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 三连
bash
hexo clean && hexo generate && hexo server
可简写为:
bash
hexo cl && hexo g && hexo s
效果如下: