安知鱼主题使用

主题安装

方式一(Github 推荐):

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

方式二(Release 推荐):

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

方式三(npm安装):

1
npm i hexo-theme-anzhiyu

此方法只支持 Hexo 5.0.0 以上版本 通过 npm 安装并不会在 themes 里生成主题文件夹,而是在 node_modules 里生成

应用主题

打开 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

覆盖配置

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

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

  • 复制/themes/anzhiyu/_config.yml此文件到 hexo 根目录,并重命名为_config.anzhiyu.yml

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

注意:

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

本地启动 hexo

1
2
3
hexo cl
hexo g
hexo s

一点小问题

因为博客在几年前就做做了一些配置改动,当时没有记录下来,现在想把之前的博客与原版博客做下对比,须同时开启两个server,就产生了端口占用问题,处理也很简单,在启动命令加上端口号就行。

1
hexo server -p 5000

这时想到怎么更改默认端口,去配置文件中找关键字port?没找到,甚至全局搜索默认端口4000都找不到,那么4000是怎么指定的。

vscode全局搜索默认排除node_modules的文件,最后在blog_anzhiyu\node_modules\hexo-server\index.js下找到

1
2
3
4
5
6
7
8
hexo.config.server = Object.assign({
port: 4000,
log: false,
// `undefined` uses Node's default (try `::` with fallback to `0.0.0.0`)
ip: undefined,
compress: false,
header: true
}, hexo.config.server);

其实也是能在hexo配置文件中改动端口的,没有port,那就加上port

1
2
server:
port: 8080