Hexo7迁移指南

前言

Hexo 7已正式发布，本文针对于v6向v7迁移的用户。

破坏性更改

Node.js要求

Hexo7的Node.js要求版本不低于14

标签移除

external_link

在7.0中，移除了布尔类型的external_link选项，现在推荐使用以下方式进行配置

external_link:
  enable: true # 在新标签中打开链接
  field: site # 对整个网站（site）生效或仅对文章（post）生效	
  exclude: '' # 需要排除的域名。主域名和子域名如 www 需分别配置

use_date_for_updated

use_date_for_updated选项已经在v7.0.0+中被移除。请改为使用updated_option: 'date'。

日期 / 时间格式

https://hexo.io/zh-cn/docs/configuration#%E6%97%A5%E6%9C%9F-x2F-%E6%97%B6%E9%97%B4%E6%A0%BC%E5%BC%8F

front-matter的link选项

front-matter中，link选项被移除。

部分标签移出Hexo的内置标签

hexo7中不再内置以下4个标签

gist
youtube
jsfiddle
vimeo

如果仍然需要这些标签，可以引入hexo-tag-embed继续在Hexo中使用它们。

1	npm i hexo-tag-embed

代码高亮

代码高亮相关代码被重构，且其配置也发生了改变，目前代码高亮由syntax_highlighter
选项控制，且其值可以为：highlight.js、prismjs或空字符串

在7.0之前，我们代码高亮的配置是这样的

highlight:
  enable: true
  auto_detect: false
  line_number: true
  line_threshold: 0
  tab_replace: ''
  exclude_languages:
    - example
  wrap: true
  hljs: false
prismjs:
  enable: false
  preprocess: true
  line_number: true
  line_threshold: 0
  tab_replace: ''

在7.0之后，enable的功能就由syntax_highlighter负责

# syntax_highlighter:              # 表示不使用任何高亮
syntax_highlighter: highlight.js   # 表示使用highlight.js
# syntax_highlighter: prismjs      # 表示使用prismjs
highlight:
  auto_detect: false
  line_number: true
  line_threshold: 0
  tab_replace: ''
  exclude_languages:
    - example
  wrap: true
  hljs: false
prismjs:
  preprocess: true
  line_number: true
  line_threshold: 0
  tab_replace: ''