hexo next主题配置

71 阅读3分钟

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

hexo安装配置

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

版本说明

版本依赖

$ 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,更新全局插件。
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的主配置,添加
symbols_count_time:
  symbols: true
  time: true
  total_symbols: true
  total_time: true
  exclude_codeblock: false
  awl: 3
  wpm: 200
  suffix: "mins."
  1. 查看next的配置文件中的内容
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的搜索配置
local_search:
  enable: true

开启访问数统计

开启配置

busuanzi_count:
  enable: true

添加评论系统

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

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

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

npm install @waline/hexo-next

  1. 在next主题的配置下面添加, 一定要修改 serverURL 为自己的
# 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 有服务端,支持评论管理。找到评论框,点击 登录 按钮,会弹出一个窗口,找到用户注册,默认第一个注册的用户为管理员,所以部署好一定要记得及时注册。

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