hexo使用的备忘

升级 Hexo & Next 到最新版

遇到的问题和变更

• Hexo 依赖项安装失败
  source-map-resolve 库已废弃，npm v8.3.2安装失败，导致依赖项自动删除。
  使用 pnpm 代替 npm，正常安装。

• 主题 Next 通过 git 安装引用失败
  安装 Next github 的安装，启动 hexo s 失败，报错 next 的一些 js 文件
  加载失败。
  切换使用 npm 安装主题，在根目录增加配置文件 _config.next.yml 后，可正常启动。原因是主题 Hexo 在版本5.*.*后，主题配置文件需要放到根目录，命名格式：_config.[name].yml。

• config.yml 配置参数变更

  • auto_excerpt not working

    自 NexT 7.6.0 版本之后，auto_excerpt 功能就从 NexT 的配置文件中移除了。

  • hexo 文章更新时间不准确
    日期 / 时间格式 中配置 updated_option 为 date。如果不生效，需要清除缓存 hexo clean。

hexo 的常见问题

hexo 下的分类和表签无法显示

步骤一

新建一个页面，命名为 tags。命令如下：
$ hexo new page "tags"

步骤二

编辑新建的页面，将页面类型设置为 tags，主题将自动为这个页面显示标签云。页面内容如下：

---
title: Tagcloud
date: xxxx-xx-xx xx:xx:xx
type: 'tags'
---

步骤三

在菜单中添加链接。编辑主题配置文件，添加 tags 到 menu 中，如：

menu:
  home: /
  archives: /archives
  tags: /tags

本问题摘自知乎石金融答者的答案

多个 tags 分割

可通过如下方式：

tags:
- tagName1
- tagName2
- tagName3

新版Next主题语言设置问题

# language: zh-Hans # 旧版使用方式
language: zh-CN # 新版写法