这是一篇大水文

前置

在经历了几天与审美疲劳的斗争之后，我决定将我博客的主题从 Butterfly 切换为Solitude。

其实 Hexo 切换主题还是非常简单的。

安装

克隆仓库

1
git clone -b main https://github.com/everfu/hexo-theme-solitude.git themes/solitude

注意
由于应用主题之前已经安装了 pug 以及 stylus 的渲染器，因此不需要重复安装。

应用主题

使用 Nano 或 VS Code 打开hexo根目录下的_config.yml，修改其中的主题配置：

1
theme: solitude

配置

注意
强烈建议对当前的博客文件夹进行备份，如果出问题还可以还原！

优化流程

对于macOS / Linux

1
cp -rf ./themes/solitude/_config.yml ./_config.solitude.yml

对于 Windows

1
copy .\themes\solitude\_config.yml .\_config.solitude.yml

原主题的操作

此时，可以将原有的_config.butterfly.yml移到其他位置以供参考。

迁移配置

Solitude的配置文件与Butterfly有很大的不同，但总体结构相似。

对于之前配置文件中部分配置的内容，可以直接照搬部分值，但是不要改变结构。

此处列举评论与搜索功能的迁移。（我使用的是algolia和twikoo）

迁移搜索

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# --------------------------- start ---------------------------
# Search
search:
  enable: true
  # type: 使用的搜索引擎 / search engine
  type: algolia # local / algolia
  tags:
    # - Solitude
    # - Hexo
  algolia:
    # hits:
    #   per_page: 6
  local:
    preload: false
    CDN: # url: search.xml
# --------------------------- end ---------------------------

直接将enable改为true，type改成algolia即可

迁移评论

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# --------------------------- start ---------------------------
# Comment
# 评论
comment:
  # Which commenting system to use(e.g. waline or waline,twikoo)
  # 使用哪个评论系统（例如： waline or waline,twikoo）
  use: twikoo # waline, twikoo, valine, artalk, giscus # Up to two comment systems can be turned on at the same time
  # Whether to display the hot comment switch.
  # 是否显示热门评论开关
  commentBarrage: false
  # Lazy load
  # 懒加载评论区
  lazyload: false
  # Whether to display the comment count
  # 显示评论数
  count: true
  # PV
  pv: false
  # Avatar
  avatar: https://gravatar.com/avatar
  # Hot comment tips
  # 热评提示
  hot_tip:
    enable: false
    # Number of hot comments
    count: 3
  # recent comments(⚠️ Comments need to be configured first.)
  # 最新评论(⚠️ 需要先配置评论)
  newest_comment:
    enable: true
    storage: .5 # 缓存时间 1: 1天 / .5 : 半天 / Cache time 1: 1 day .5 : half a day
    limit: 5 # 评论数 / Number of comments
# Twikoo: https://solitude.js.org/comment/twikoo
twikoo: # https://twikoo.js.org/
  envId: https://***.***/
  region: # Environment locale, default is ap-shanghai, Tencent cloud environment fill ap-shanghai or ap-guangzhou; Vercel environment do not fill the.
  style: true # Use custom styles when turned on
  accessToken: # AccessToken
  option: # twikoo option
# Waline: https://solitude.js.org/comment/waline
waline: # https://waline.js.org/
  envId: # url: https://waline.wzsco.top
  pageview: false # Whether to enable page access statistics
  option: # waline configuration item
# Valine: https://solitude.js.org/comment/valine
valine:
  appId:
  appKey:
  serverURLs: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in)
  avatar: # https://valine.js.org/avatar.html
  visitor: false
  style: true # Use custom styles when turned on
  option: # options list
# Artalk: https://solitude.js.org/comment/artalk
# Artalk: https://solitude.js.org/zh/comment/artalk
artalk:
  server: # server url
  site: # site name
  option: # options
# Giscus: https://solitude.js.org/comment/giscus
giscus:
  repo: # GitHub repository name
  repo_id: # GitHub repository ID
  category_id: # GitHub repository category ID
  theme:
    light: light
    dark: dark
  option:
# --------------------------- end ---------------------------

将use改为twikoo,找到 valine 的配置填入之前的envId即可。

Solitude似乎提供了更多的配置选项，可以按需修改。

后续

对于其它有较大区别的配置，请自行对照原来的配置修改。

附

Solitude官方文档