hexo-next主题配置方式

发表于 更新于 分类于 阅读次数： Waline： 本文字数： 2.6k 阅读时长 ≈ 2 分钟

主要介绍hexo的配置，和使用next主题时的一些自定义配置，需要先确认版本是否一致。
本文主要基于 hexo 7.0.0 和 next 8.18.2，如果版本不一致，可能会有报错。

hexo安装配置

操作比较简单，可以直接参考官方文档 hexo配置

版本说明

版本依赖

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
$ npm list
hexo-site@0.0.0 D:\Documents\GitHub\hexo
├── @waline/hexo-next@3.0.1
├── hexo-cli@4.3.1
├── hexo-deployer-git@4.0.0
├── hexo-generator-archive@2.0.0
├── hexo-generator-category@2.0.0
├── hexo-generator-index@3.0.0
├── hexo-generator-searchdb@1.4.1
├── hexo-generator-tag@2.0.0
├── hexo-renderer-ejs@2.0.0
├── hexo-renderer-marked@6.1.1
├── hexo-renderer-stylus@3.0.0
├── hexo-server@3.0.0
├── hexo-symbols-count-time@0.7.1
├── hexo-theme-landscape@1.0.0
├── hexo-theme-next@8.18.2
└── hexo@7.0.0

版本升级

  1. 先检查hexo版本， hexo version ，如果不对，可以 npm install -g hexo-cli 全局升级。然后再次查看版本是否升级成功
  2. 使用npm-check，检查项目依赖的插件是否需要升级。
  3. 使用npm-upgrade，升级依赖的插件。
  4. npm update -g，更新全局插件。
1
2
3
4
5
6
7
8
9
10
11
12
npm install -g hexo-cli
hexo version

npm install -g npm-check
npm-check

npm install -g npm-upgrade
npm-upgrade

npm update -g

hexo clean && hexo g && hexo s

Next主题配置

主要是修改themes/next 文件夹内的_config.yml 文件里面的配置

参考官方文档

开启阅读时长

  1. npm安装插件

npm install hexo-symbols-count-time -g

  1. 修改hexo的主配置，添加
1
2
3
4
5
6
7
8
9
symbols_count_time:
  symbols: true
  time: true
  total_symbols: true
  total_time: true
  exclude_codeblock: false
  awl: 3
  wpm: 200
  suffix: "mins."
  1. 查看next的配置文件中的内容
1
2
3
4
symbols_count_time:
  separated_meta: true
  item_text_post: true
  item_text_total: false
  1. 配置完成后，需要执行 hexo clean，否则阅读时长可能会显示 NaN

hexo clean && hexo g && hexo s

搜索功能

  1. 安装插件

npm install hexo-generator-searchdb

  1. 开启next的搜索配置
1
2
3
local_search:
  enable: true

开启访问数统计

开启配置

1
2
busuanzi_count:
  enable: true

添加评论系统

经过网上的查询和综合评估，选择了waline 作为评论系统。

  1. 首先需要注册和部署相关应用， 可以直接参考官方文档 waline get-started

  2. 由于 Next 主题中没有 Waline 的评论配置，需要安装官方的插件，在目录下执行

npm install @waline/hexo-next

  1. 在next主题的配置下面添加, 一定要修改 serverURL 为自己的
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Waline
# For more information: https://waline.js.org, https://github.com/walinejs/waline
waline:
  enable: true #是否开启
  serverURL: 填写第一步部署后获取到的地址 # Waline #服务端地址，我们这里就是上面部署的 Vercel 地址
  placeholder: 请文明评论呀 # #评论框的默认文字
  avatar: mm # 头像风格
  meta: [nick, mail, link] # 自定义评论框上面的三个输入框的内容
  pageSize: 10 # 评论数量多少时显示分页
  lang: zh-cn # 语言, 可选值: en, zh-cn
  # Warning: 不要同时启用 `waline.visitor` 以及 `leancloud_visitors`.
  visitor: false # 文章阅读统计
  comment_count: true # 如果为 false , 评论数量只会在当前评论页面显示, 主页则不显示
  requiredFields: [] # 设置用户评论时必填的信息，[nick,mail]: [nick] | [nick, mail]
  libUrl: # Set custom library cdn url

  1. 重新生成

hexo clean && hexo g && hexo s

登录注册评论后台

Waline 有服务端，支持评论管理。找到评论框，点击 登录 按钮，会弹出一个窗口，找到用户注册，默认第一个注册的用户为管理员，所以部署好一定要记得及时注册。

注册登录之后， 就可以对评论进行管理了。

hexo开启 mermaid

mermaid 可以帮助在markdown中画流程图，时序图等

首先需要在项目目录下面安装依赖

npm i hexo-filter-mermaid-diagrams

然后在配置中开启

1
2
mermaid:
  enable: true

下面就可以在markdown文件中添加对应的内容，页面就会自动渲染了， 如下面的例子

流程图

1
2
3
mermaid
graph TD
Start --> Stop
graph TD
Start --> Stop

时间轴

timeline
      title History of Social Media Platform
      2002 : LinkedIn
      2004 : Facebook
           : Google
      2005 : Youtube
      2006 : Twitter