【笔记】Hexo的NexT主题配置

发表于 更新于 阅读次数：

前言

Hexo的NexT主题配置，我这里使用的NexT版本是8.8.0，不同版本的主题之间配置稍有不同，具体配置可参见NexT中文官网或NexT主题官方博客

本文是我的个性化设置，请根据注释自定义修改自己的个性化设置

更多第三方插件或功能需要参照对应的其说明文档，这里省略

如果想要加入自己的自定义HTML/CSS/JS，请移步传送门

配置文件

  • 旧版本配置文件所在路径为blog/themes/next/config.yml
  • 新版本配置文件所在路径为/hexo/_config.next.yml

这个文件实质上是从官方的配置模版复制的

如果没有的小伙伴可以从node_modules/hexo-theme-next/目录下拷贝

1
cp node_modules/hexo-theme-next/_config.yml _config.next.yml

或者从themes/next/目录下拷贝

1
cp themes/next/_config.yml _config.next.yml

具体路径需要根据安装方式参考

修改配置文件

  • 以下为本人自行整理的注释翻译，参照注释进行配置即可
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
# ---------------------------------------------------------------
# 主题核心配置设置
# ---------------------------------------------------------------

# 允许缓存内容生成。
cache:
  enable: true

# hexo 生成后删除不需要的文件。
minify: false

# 定义自定义文件路径。
# 添加自定义文件需要在`source/_data/`目录下手动创建新文件
custom_file_path:
  # 根据需要解除注释
  # 不可以手动创建新的自定义组件


# ---------------------------------------------------------------
# 主题方案设置
# ---------------------------------------------------------------

# 主题方案
#  可选值: Muse Mist Pisces Pisces
scheme: Muse

# 深色模式
darkmode: true

# ---------------------------------------------------------------
# 站点信息设置
# ---------------------------------------------------------------

# 图标设置
favicon:
  # 小图标
  small: /imgs/favicon-16x16-next.png
  # 大图标
  medium: /imgs/favicon-32x32-next.png
  # 苹果平台图标
  apple_touch_icon: /imgs/apple-touch-icon-next.png
  # Mac上的Safari显示的图标
  safari_pinned_tab: /imgs/logo.svg
  # 安卓平台图标
  #android_manifest: /manifest.json

#自定义Logo（警告: 不支持scheme Mist）
custom_logo: #/uploads/custom-logo.jpg

# 知识共享 4.0 国际许可。
creative_commons:
  license: by-nc-sa
  size: small
  sidebar: false
  post: false
  language:

# ---------------------------------------------------------------
# 菜单设置
# ---------------------------------------------------------------

menu:
  # 页面名: 页面路径 || 图标名
  home: / || fa fa-home

  # 添加自定义菜单需要使用`hexo new page <pagename>`来创建页面
  typesetting: /typesetting/ || fa fa-sitemap

menu_settings:
  # 启用或禁用图标
  icons: true
  # 启用或禁用徽章
  badges: false

# ---------------------------------------------------------------
# 侧边栏设置
# ---------------------------------------------------------------

sidebar:
  # 侧边栏位置
  # 可选值: left right
  position: right

  # 手动定义侧边栏宽度。默认为:
  # Muse | Mist: 320
  # Pisces | Gemini: 240
  #width: 300

  # 侧边栏的展示方式 (only for Muse | Mist).
  # 可选值: post always hide remove
  #  - post    自动，如果打开的是文章，则自动展开，如果不是，则不展开
  #  - always  无论什么情况都自动展开
  #  - hide    无论什么情况都不展开
  #  - remove  完全移除侧边栏
  display: always

  # 以像素为单位的侧边栏填充。
  padding: 18
  # 侧边栏从顶部菜单栏的像素偏移量 (only for Pisces | Gemini).
  offset: 12

# 侧边栏头像
avatar:
  # 替换默认图片并在此处设置url。
  url: /avatar/avatar.gif
  # 是否为圆形
  rounded: true
  # 是否鼠标移入自动旋转
  rotated: true

# 侧边栏中的文章/类别/标签。
site_state: false

# 社交链接
social:
  # 社交平台: 链接 || 图标名
  GitHub: https://github.com/Feiju12138 || fab fa-github

# 社交图标设置
social_icons:
  # 是否开启
  enable: true
  # 是否只显示图标
  icons_only: false
  # 是否过渡
  transition: false

# 友链标题设置
links_settings:
  # 友链标题的图标
  icon: fa fa-link
  # 友链标题名
  title: 友链
  # 友链展示方式
  #  可选值: block inline
  layout: block

# 具体友链，可以添加多个
links:
  # "超链接文字": 超链接地址
  "LeFlacon - 梦想做个靠谱的好人_(:з」∠)_": https://leflacon.github.io/

# 侧边栏中的目录
toc:
  # 是否开启
  enable: true
  # 是否自动编号
  number: true
  # 标题过长时是否自动换行
  wrap: false
  # 是否自动展开子标题
  expand_all: false
  # 标题级别最大值
  max_depth: 6

# ---------------------------------------------------------------
# 页脚设置
# ---------------------------------------------------------------

# 在页脚显示多语言切换
language_switcher: false

footer:
  # 指定年份（默认值: 当前年份）
  #since: 2021

  # 版权图标
  icon:
    # 图标名
    name: fa fa-heart
    # 是否设置图标动画
    animated: false
    # 图标颜色
    color: "#ff0000"

  # 版权所有者（如果未定义，则默认为Hexo配置文件中的网站作者author）
  copyright:

  # 是否展示: Powered by Hexo & NexT
  powered: false

  # 备案设置
  beian:
    # 是否开启
    enable: false
    # 公安备案的身份证号
    icp:
    # 公安备案的编号
    gongan_id:
    # 公安备案的安全指数
    gongan_num:
    # 公安备案的图标
    gongan_icon_url:

# ---------------------------------------------------------------
# 文章设置
# ---------------------------------------------------------------

# 是否自动摘录主页中的描述作为序言文本
excerpt_description: true

# 是否开启查看更多按钮
read_more_btn: true

# 文章的元素展示设置
post_meta:
  # 是否展示标签
  item_text: true
  # 是否展示创建时间
  created_at: true
  # 修改时间
  updated_at:
    # 是否展示修改时间
    enable: true
    # 其他修改时间
    another_day: true
  # 是否展示分类
  categories: true

# 文章计数器设置
symbols_count_time:
  separated_meta: true
  # 项目文章总计
  item_text_total: false

# 是否使用图标代替`#`来表示帖子底部的标签
tag_icon: false

# 捐赠（赏赞）设置
reward_settings:
  # 是否开启
  enable: true
  # 是否开启动画
  animation: true
  # 文本提示
  #comment: 支持一下

# 捐赠（赏赞）方式，可以添加多个
reward:
  # 捐赠（赏赞）方式名称: 二维码收款图片
  微信/QQ/支付宝: /donate/onlinepay.png

# 关注我的渠道设置
follow_me:
  # 渠道名: 渠道地址 || 图标名
  #Twitter: https://twitter.com/username || fab fa-twitter
  # RSS订阅: 配置文件 || 图标名
  #RSS: /atom.xml || fa fa-rss

# 关于热门文章的设置
related_posts:
  # 是否开启
  enable: false
  # 标题默认值（如果留空，则使用默认值）
  title:
  display_in_home: false
  params:
    maxCount: 5
    #PPMixingRate: 0.0
    #isDate: false
    #isImage: false
    #isExcerpt: false

# 协同编辑设置
post_edit:
  # 是否开启
  enable: false
  url: https://github.com/user-name/repo-name/tree/branch-name/subdirectory-name/ # Link for view source
  #url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/ # Link for fork & edit

# 下一篇文章的箭头
# 可选值: left right false
post_navigation: left

# ---------------------------------------------------------------
# 自定义页面设置
# ---------------------------------------------------------------

# 标签云设置
tagcloud:
  # 最小尺寸
  min: 12
  # 最大尺寸
  max: 30
  # 标签数
  amount: 200
  # 便签顺序
  orderby: name
  # 排序
  order: 1

# 谷歌日历设置
calendar:
  # 谷歌账号
  calendar_id: <required>
  # API KEY
  api_key: <required>
  orderBy: startTime
  showLocation: false
  offsetMax: 72 # Time Range
  offsetMin: 4 # Time Range
  showDeleted: false
  singleEvents: true
  maxResults: 250

# ---------------------------------------------------------------
# 其他主题设置
# ---------------------------------------------------------------

# 是否为字体和插件设置预连接CDN
preconnect: false

# 文章或页面的文本对齐方式设置
text_align:
  # 可选值: start end left right center justify justify-all match-parent
  desktop: justify
  mobile: justify

# 是否减少宽度窄的设备上的填充和边距缩进
mobile_layout_economy: false

# 浏览器标题面板颜色设置
theme_color:
  # 浅色模式下
  light: "#222"
  # 深色模式下
  dark: "#222"

# 滚动条设置
body_scrollbar:
  # 是否将滚动条放在内容上
  overlay: false
  # 是否始终现实滚动条
  stable: false

# 代码块设置
# 所有可用主题: https://theme-next.js.org/highlight/
codeblock:
  # 代码高亮主题第一款
  theme:
    light: atom-one-light
    dark: atom-one-dark
  # 代码高亮主题第二款
  prism:
    light: prism
    dark: prism-dark
  # 添加复制按钮
  copy_button:
    # 是否启动
    enable: true
    # 风格设置
    # 可选值: default flat mac
    style: mac

# 右下角回到顶部按钮设置
back2top:
  # 是否启动
  enable: true
  # 是否只在侧边栏显示回到顶部按钮
  sidebar: false
  # 是否显示滚动条进度百分比
  scrollpercent: true

# 顶部阅读进度条设置
reading_progress:
  # 是否启动
  enable: true
  # 0%的位置
  # 可选值: left right
  start_at: left
  # 进度条位置
  # 可选值: top bottom
  position: top
  # 是否反转
  reversed: false
  # 进度条颜色
  color: "#FF3366"
  # 进度条高度
  height: 3px

# 左上角书签设置
bookmark:
  # 是否启动
  enable: true
  # 书签图标颜色
  color: "#222"
  # 自动保存或手动
  # 可选值: auto manual
  save: manual

# 右上角Github图标
github_banner:
  # 是否启动
  enable: false
  # GitHub项目地址
  permalink: https://github.com/yourname
  # 标题
  title: Follow me on GitHub

# ---------------------------------------------------------------
# 字体设置
# ---------------------------------------------------------------

font:
  # 是否开启手动设置字体
  enable: true

  # 指定字体地址，留空默认为谷歌字体: https://fonts.googleapis.com
  host:

  # 字体选项
  # 是否从以上host加载字体
  # external: true
  # 字体系列（字体名作为值，且不需要引号包裹）
  # family: Times New Roman
  # 字体大小
  # size: x.x

  # 全局字体配置(<body>)
  global:
    # 是否从以上host家在字体
    external: false
    # 字体系列，指定字体名，不需要使用引号
    family: PingFang
    # 字体大小，单位为em，1em=16px
    size:

  # 网站标题字体配置(.site-title)
  title:
    external: false
    family: DroidSansChinese
    size: 2

  # 文章标题字体配置(<h1> ~ <h6>).
  headings:
    external: false
    family: PingFang
    size:

  # 文章内容字体配置 (.post-body).
  posts:
    external: false
    family: PingFang

  # 代码块和代码域字体配置(<code> and code blocks)
  codes:
    external: false
    family: Consolas

# ---------------------------------------------------------------
# SEO搜索引擎优化设置
# 了解详情: https://theme-next.js.org/docs/theme-settings/seo
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# 第三方插件或服务设置
# 了解详情: https://theme-next.js.org/docs/third-party-services/
# 更多插件: https://github.com/next-theme/awesome-next
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# 评论系统设置
# 了解详情: https://theme-next.js.org/docs/third-party-services/comments
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# 发布小部件和内容共享服务设置
# 了解详情: https://theme-next.js.org/docs/third-party-services/post-widgets
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# 统计和分析设置
# 了解详情: https://theme-next.js.org/docs/third-party-services/statistics-and-analytics
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# 站内搜索设置
# 了解详情: https://theme-next.js.org/docs/third-party-services/search-services
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# 聊天系统设置
# 了解详情: https://theme-next.js.org/docs/third-party-services/chat-services
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# Tags设置
# 了解详情: https://theme-next.js.org/docs/tag-plugins/
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# 动画设置
# ---------------------------------------------------------------


# ---------------------------------------------------------------
# CDN加速设置
# 了解详情: https://theme-next.js.org/docs/advanced-settings/vendors
# ---------------------------------------------------------------

完成

推荐文献

  • 推荐一篇很全的NexT主题7.1版本的配置文章

Sirius的博客