Hexo系列(四) NexT主题配置

翟越

2023-12-01

Hexo 框架允许我们更换合适的主题，以便于构建不同风格的网站，这里介绍目前最常使用的一款主题之一 —— NexT

一、NexT 安装

在正式开始讲解 NexT 安装之前，我们必须明确以下几个概念：

在使用 Hexo 框架建立的网站中，存在两份重要的配置文件，它们的文件名称都是 _config.yml

一份是 站点配置文件，位于 站点根目录 下，用于网站的基础配置

另外一份是 主题配置文件，位于 themes 目录 下，用于主题的相关配置

不同的主题会有不同的主题配置文件，由主题作者所提供

1、下载 NexT

在 站点根目录 中打开 git bash 窗口，使用如下命令下载 NexT 主题文件到 themes 目录 中

$ git clone https://github.com/iissnan/hexo-theme-next themes/next

Cloning into 'themes/next'...
remote: Counting objects: 12033, done.
remote: Total 12033 (delta 0), reused 0 (delta 0), pack-reused 12033
Receiving objects: 100% (12033/12033), 13.00 MiB | 1.37 MiB/s, done.
Resolving deltas: 100% (6991/6991), done.
Checking out files: 100% (351/351), done.

注意：如果出现以下错误

error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

请尝试使用以下命令

$ git clone git://github.com/iissnan/hexo-theme-next themes/next

2、启用 NexT

打开 站点配置文件，将 theme 选项的值改为 next，注意要在属性和值之间要加上一个空格

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next

此时，登陆自己的站点，应该可以看到更改已经成功

二、NexT 配置

1、设置 Scheme

Scheme 是用于 改变网站布局 的一个设置项，NexT 目前提供四种 Scheme：

Muse ：默认 Scheme，黑白主调，大量留白
Mist：Muse 的紧凑版本，整洁有序的单栏外观
Pisces：双栏 Scheme，小家碧玉的清新
Gemini：新增 Scheme

更改时，打开 主题配置文件，通过搜索关键字 Scheme Settings 定位，然后将使用的 scheme 打开注释即可

# ---------------------------------------------------------------
# Scheme Settings
# ---------------------------------------------------------------

# Schemes
#scheme: Muse
#scheme: Mist
scheme: Pisces
#scheme: Gemini

2、设置动态背景

更改时，打开 主题配置文件，通过搜索关键字 Canvas-nest 定位，然后将 canvas_nest 的值改成 true 即可

# Canvas-nest
canvas_nest: true

3、设置侧栏行为

默认情况下，侧栏仅在文章页面（拥有目录列表时）才显示，并放置于右侧位置

可以通过修改 主题配置文件 中的 Sidebar Settings 字段控制侧栏的行为

（1）侧栏位置：position

left：靠左放置
right：靠右放置

（2）侧栏显示时机：display

post：默认行为，在文章页面（拥有目录列表时）显示
always：在所有页面中都显示
hide：在所有页面中都隐藏
remove：完全移除

# Sidebar Position, available value: left | right (only for Pisces | Gemini).
position: left
#position: right

# Sidebar Display, available value (only for Muse | Mist):
#  - post    expand on posts automatically. Default.
#  - always  expand for all pages automatically
#  - hide    expand only when click on the sidebar toggle icon.
#  - remove  Totally remove sidebar including sidebar toggle.
display: post
#display: always
#display: hide
#display: remove

4、设置菜单

（1）设置菜单项

打开 主题配置文件，搜索关键字 Menu Settings 进行定位，各个菜单项通过 # 注释开启或关闭

# ---------------------------------------------------------------
# Menu Settings
# ---------------------------------------------------------------

# When running the site in a subdirectory (e.g. domain.tld/blog), remove the leading slash from link value (/archives -> archives).
# Usage: `Key: /link/ || icon`
# Key is the name of menu item. If translate for this menu will find in languages - this translate will be loaded; if not - Key name will be used. Key is case-senstive.
# Value before `||` delimeter is the target link.
# Value after `||` delimeter is the name of FontAwesome icon. If icon (with or without delimeter) is not specified, question icon will be loaded.
menu:
  home: / || home
  #about: /about/ || user
  #tags: /tags/ || tags
  categories: /categories/ || th
  archives: /archives/ || archive
  #schedule: /schedule/ || calendar
  #sitemap: /sitemap.xml || sitemap
  #commonweal: /404/ || heartbeat

部分菜单项的功能描述如下：

home：主页
about：关于
tags：标签
categories：分类
archives：归档

（2）创建文件夹

这里演示创建 categories 分类页面的文件夹，其它菜单项的添加类似

在 站点根目录 下，打开 git bash，输入命令 $ hexo new page "categories"

$ hexo new page "categories"
INFO  Created: C:\Desktop\test\source\categories\index.md

（3）添加文档头部

这里演示添加 categories 分类页面的文档头部，其它菜单项的添加类似

打开新建的 index.md 文件，在 文档头部 添加以下描述：

---
title: categories
date: 2015-12-04 15:37:22
type: "categories"
comments: false
---

5、设置头像

打开 主题配置文件，搜索关键字 Sidebar Avatar 进行定位，将 avatar 的值设置成头像图片的链接地址即可

# Sidebar Avatar
# in theme directory(source/images): /images/avatar.gif
# in site  directory(source/uploads): /uploads/avatar.gif
avatar: <url>

头像图片的链接地址可以是：

完整的互联网地址：例如，https://www.example.com/avatar.jpg
站点内的相对地址：例如，假设图片命名为 avatar.jpg，存放在 source/images/ 目录下，则链接地址可以写成 /images/avatar.jpg

6、添加社交链接

打开 主题配置文件，搜索关键字 Social Links 进行定位，social 的值按 Key: permalink || icon 格式设置

# Social Links.
# Usage: `Key: permalink || icon`
# Key is the link label showing to end users.
# Value before `||` delimeter is the target permalink.
# Value after `||` delimeter is the name of FontAwesome icon. If icon (with or without delimeter) is not specified, globe icon will be loaded.
social:
  csdn: https://blog.csdn.net/wsmrzx || csdn
  cnblogs: https://www.cnblogs.com/wsmrzx || cnblogs

7、添加文字统计功能

进入 站点根目录，打开 git bash 窗口，输入如下命令安装插件

$ npm install hexo-wordcount --save

然后打开 主题配置文件，进行如下配置

# Post wordcount display settings
# Dependencies: https://github.com/willin/hexo-wordcount
post_wordcount:
  item_text: true
  wordcount: true
  min2read: true
  totalcount: true
  separated_meta: true

8、添加阅读量统计功能

在 主题配置文件 中修改 busuanzi_count 字段启用不蒜子统计功能

# Show PV/UV of the website/page with busuanzi.
# Get more information on http://ibruce.info/2015/04/04/busuanzi/
busuanzi_count:
  # count values only if the other configs are false
  enable: true
  # custom uv span for the whole site
  site_uv: true
  site_uv_header: <i class="fa fa-user"></i>
  site_uv_footer: 
  # custom pv span for the whole site
  site_pv: true
  site_pv_header: <i class="fa fa-eye"></i>
  site_pv_footer: 
  # custom pv span for one page only
  page_pv: true
  page_pv_header: <i class="fa fa-file-o"></i>
  page_pv_footer:

【参考资料】