1. NexT主题配置文件详解

Hexo版本-3.8.0，NexT版本-5.1.4
NexT主题配置文件详解
1# ---------------------------------------------------------------
2# 主题核心配置
3# ---------------------------------------------------------------
4override: false    # 设置为true，则完全重载默认配置，当你完全不想继承主题配置时很有用
5
6# ---------------------------------------------------------------
7# 站点信息设置
8# ---------------------------------------------------------------
9favicon:     # favicon升级了，细化各种规格。
10  small: /images/favicon-16x16-next.png                
11  medium: /images/favicon-32x32-next.png    # medium类型应用`/favicon.ico`，否则网站图标异常
12  apple_touch_icon: /images/apple-touch-icon-next.png
13  safari_pinned_tab: /images/logo.svg
14  #android_manifest: /images/manifest.json
15  #ms_browserconfig: /images/browserconfig.xml
16
17keywords: "Hexo, NexT"                        # 网站默认关键词
18rss:                            # rss配置。false禁止；留空提供站点提供的；也可以自己指定
19
20footer:                        # footer块配置                                                
21  #since: 2015        # 网站建站年份，如果不配，采用当前年份
22  icon: user            # 年份和版权声明之间的图标
23  copyright:            # 版权声明。如为空，则取站点配置的`author`值。  
24  powered: true        # 显示Hexo的链接（Power by Hexo）
25  theme:                    # 在footer块中显示主题信息
26    enable: true    # 显示主题信息    
27    version: true    # 显示主题的版本。
28  # 可以采用下面定制的文本
29  #custom_text: Hosted by <a target="_blank" href="https://pages.github.com">GitHub Pages</a>
30
31# ---------------------------------------------------------------
32# SEO设置
33# ---------------------------------------------------------------
34
35# 标记为权威网站，有利于SEO搜索。如果打开该标签，务必在站点配置中设置url。
36canonical: true
37seo: false
38
39# 如果index_with_subtitle为true，则在主页标题中增加subtitle。
40# subtitle: Subtitle # 此处也可以覆写，它会替代站点配置文件中的内容
41index_with_subtitle: false
42
43# ---------------------------------------------------------------
44# 菜单设置
45# ---------------------------------------------------------------
46# 用法: `Key: /link/ || icon`
47# Key 菜单名，如果语言文件中有对应项，则用对应项，否则就用菜单名。
48# `||` 前面部分，表示目标链接。
49# `||` 后面部分，表示菜单的FontAwesome图标名。默认为question图标。
50menu:
51  home: / || home                        # 主页链接及其图标
52  #about: /about/ || user                # 关于页链接及其图标
53  #tags: /tags/ || tags                  # 标签页链接及其图标
54  #categories: /categories/ || th        # 分类页链接及其图标
55  archives: /archives/ || archive        # 归档页及其图标
56  #schedule: /schedule/ || calendar
57  #sitemap: /sitemap.xml || sitemap
58  #commonweal: /404/ || heartbeat
59menu_icons:
60  enable: true                           # 是否启用图标
61
62
63# ---------------------------------------------------------------
64# 主题的主题设置
65# ---------------------------------------------------------------
66# 只能选择一套。
67# Schemes
68scheme: Muse
69#scheme: Mist
70#scheme: Pisces
71#scheme: Gemini
72
73# ---------------------------------------------------------------
74# 侧边栏设置
75# ---------------------------------------------------------------
76
77# 社交链接
78# 用法: `Key: permalink || icon`
79# Key 是最终显示的标签，`||` 前是永久链接,`||` 后面是标签的FontAwesome图标，默认glob
80#social:
81  #GitHub: https://github.com/yourname || github
82  #E-Mail: mailto:yourname@gmail.com || envelope
83  #Google: https://plus.google.com/yourname || google
84  #Twitter: https://twitter.com/yourname || twitter
85  #FB Page: https://www.facebook.com/yourname || facebook
86  #VK Group: https://vk.com/yourname || vk
87  #StackOverflow: https://stackoverflow.com/yourname || stack-overflow
88  #YouTube: https://youtube.com/yourname || youtube
89  #Instagram: https://instagram.com/yourname || instagram
90  #Skype: skype:yourname?call|chat || skype
91
92social_icons:
93  enable: true             # 是否在社交链接标签上显示图标
94  icons_only: false        # 只显示图标
95  transition: false        # 是否显示过渡效果
96
97# 友情链接
98links_icon: link                              # 链接图标
99links_title: Links                            # 链接标签文字
100links_layout: block                           # 链接样式
101#links_layout: inline
102#links:                                       # 一个一个的友情链接。用法为`标题： 链接`
103  #Title: http://example.com/
104
105# Sidebar Avatar                              # 侧边栏上个人头像图片。也支持是动态gif。
106#avatar: /images/avatar.gif
107
108# 在侧边栏中是否显示文章标题目录。
109toc:
110  enable: true                                # 是否
111  number: true                                # 是否自动编号
112  wrap: false                                 # 标题目录是否自动换行
113
114
115# 创作声明
116# http://creativecommons.org/
117# Available: by | by-nc | by-nc-nd | by-nc-sa | by-nd | by-sa | zero
118#creative_commons: by-nc-sa
119#creative_commons:
120
121sidebar:
122  # 侧边栏位置: left | right (只有Pisces、Gemini有效).
123  position: left
124  #position: right
125
126  # 侧边栏显示 (只对Muse、Mist有效)  
127  display: post                               # 默认，在post文章扩展时显示。
128  #display: always                            # 对所有页面都显示
129  #display: hide                              # 只有点击按钮显示
130  #display: remove                            # 完全删除，不显示
131
132  # 侧边栏距离顶部菜单条的距离，单位像素(只对Pisces、Gemini有效).
133  offset: 12
134  b2t: false            # 在侧边栏下方是否显示回到顶部(只对Pisces、Gemini有效).
135  scrollpercent: false  # 是否显示滚动百分比
136  onmobile: false       # 是否在窄屏设备上显示侧边栏 (只对 Muse | Mist有效).
137
138# ---------------------------------------------------------------
139# 文章设置（post类型）
140# ---------------------------------------------------------------
141scroll_to_more: true      # 自动折叠<!--more-->下面的正文部分
142save_scroll: false        # 自动为每篇文章保存滚动位置
143
144# Automatically excerpt description in homepage as preamble text.
145excerpt_description: true
146
147# 自动摘要，不建议。请使用<!-- more -->精确控制
148auto_excerpt:
149  enable: false         # 启动开关
150  length: 150           # 从开始往后选取的摘要文字数量。
151
152# 摘要元数据
153post_meta:
154  item_text: true              # 是否显示“发表于”这几个文字
155  created_at: true             # 文章创建日期
156  updated_at: false            # 文章修改日期
157  categories: true             # 文章所属分类
158
159post_wordcount:                # 字数统计。依赖https://github.com/willin/hexo-wordcount
160  item_text: true              # 是否显示文字
161  wordcount: false             # 显示字数
162  min2read: false              # 显示阅读时间
163  totalcount: false            # 显示总数
164  separated_meta: true         # 是否分开
165
166#wechat_subscriber:            # 微信公众号订阅
167  #enabled: true               # 是否启用
168  #qcode:                      # 二维码图片链接
169  #description:                # 描述性文字，会放在二维码上方
170
171# 打赏
172#reward_comment: # 打赏文字
173#wechatpay: /images/wechatpay.jpg   # 微信打赏二维码
174#alipay: /images/alipay.jpg         # 支付宝打赏二维码
175#bitcoin: /images/bitcoin.png       # 比特币打赏二维码
176
177post_copyright:
178  enable: false                     # 文档许可声明
179  license: CC BY-NC-SA 3.0          # 文档声明协议
180  license_url: https://creativecommons.org/licenses/by-nc-sa/3.0/
181
182
183# ---------------------------------------------------------------
184# Misc 主题专用设置
185# ---------------------------------------------------------------
186# Reduce padding / margin indents on devices with narrow width.
187mobile_layout_economy: false
188
189# Android Chrome header panel color ($black-deep).
190android_chrome_color: "#222"
191
192# 定制Logo，只对默认Muse有效。
193# Options:
194#   enabled: [true/false] - # 是否启用
195#   image: url-of-image   - # 图片url
196custom_logo:
197  enabled: false
198  image:
199
200# 代码高亮主题。可选值normal | night | night eighties | night blue | night bright
201highlight_theme: normal
202
203# ---------------------------------------------------------------
204# 字体设置儿
205# - 请从谷歌查找字体
206# - 所有字体必须具有下列样式
207#     light, light italic, normal, normal italic, bold, bold italic
208font:
209  enable: false                  # 是否启用
210  host:                          # 字体host地址
211  # Font options:                # 字体选项
212  # `external: true`             # true，则会从上面的host地址装载
213  # `family: Times New Roman`. 
214  # `size: xx`. 单位是`px`.
215
216  # 在<body>元素中设置全局字体
217  global:
218    external: true
219    family: Lato
220    size:
221
222  # 标题（h1~h6字体，有global字体设置托底）
223  headings:
224    external: true
225    family:
226    size:
227
228  # post文章字体，有global字体设置托底
229  posts:
230    external: true
231    family:
232
233   # logo字体设置，有global字体设置托底
234  logo:
235    external: true
236    family:
237    size:
238
239  # 代码块字体
240  codes:
241    external: true
242    family:
243    size:
244
245
246# ---------------------------------------------------------------
247# 第三方服务设置
248# ---------------------------------------------------------------
249
250# MathJax数学公式设置
251mathjax:
252  enable: false
253  per_page: false
254  cdn: //cdn.bootcss.com/mathjax/2.7.1/latest.js?config=TeX-AMS-MML_HTMLorMML
255
256# Han Support docs: https://hanzi.pro/
257han: false
258
259# Swiftype Search API Key
260#swiftype_key:
261
262#baidu_analytics:          # 百度分析的id
263#duoshuo_shortname:        # 多说的shorname
264
265# Disqus Disqus评论支持
266disqus:
267  enable: false
268  shortname:
269  count: true
270
271# Hypercomments
272#hypercomments_id:
273
274# 畅言
275changyan:                                        
276  enable: false
277  appid:
278  appkey:
279
280
281# 韩国来必力网站评论系统.https://valine.js.org
282valine:
283  enable: false
284  appid:  # your leancloud application appid
285  appkey:  # your leancloud application appkey
286  notify: false # mail notifier , https://github.com/xCss/Valine/wiki
287  verify: false # Verification code
288  placeholder: Just go go # comment box placeholder
289  avatar: mm # gravatar style
290  guest_info: nick,mail,link # custom comment header
291  pageSize: 10 # pagination size
292
293
294# 友言评论
295#youyan_uid: your uid
296
297# LiveRe评论系统。从https://livere.com/insight/myCode获取uid
298#livere_uid: your uid
299
300# Gitment评论系统。https://imsun.net/posts/gitment-introduction/
301# You can get your Github ID from https://api.github.com/users/<Github username>
302gitment:
303  enable: false
304  mint: true # RECOMMEND, A mint on Gitment, to support count, language and proxy_gateway
305  count: true # Show comments count in post meta area
306  lazy: false # Comments lazy loading with a button
307  cleanly: false # Hide 'Powered by ...' on footer, and more
308  language: # Force language, or auto switch by theme
309  github_user: # MUST HAVE, Your Github ID
310  github_repo: # MUST HAVE, The repo you use to store Gitment comments
311  client_id: # MUST HAVE, Github client id for the Gitment
312  client_secret: # EITHER this or proxy_gateway, Github access secret token for the Gitment
313  proxy_gateway: # Address of api proxy, See: https://github.com/aimingoo/intersect
314  redirect_protocol: # Protocol of redirect_uri with force_redirect_protocol when mint enabled
315
316# Baidu Share
317# Available value:
318#    button | slide
319# Warning: Baidu Share does not support https.
320#baidushare:
321##  type: button
322
323# Share
324# This plugin is more useful in China, make sure you known how to use it.
325# And you can find the use guide at official webiste: http://www.jiathis.com/.
326# Warning: JiaThis does not support https.
327#jiathis:
328  ##uid: Get this uid from http://www.jiathis.com/
329#add_this_id:
330
331# Share
332#duoshuo_share: true
333
334# NeedMoreShare2
335# This plugin is a pure javascript sharing lib which is useful in China.
336# See: https://github.com/revir/need-more-share2
337# Also see: https://github.com/DzmVasileusky/needShareButton
338# iconStyle: default | box
339# boxForm: horizontal | vertical
340# position: top / middle / bottom + Left / Center / Right
341# networks: Weibo,Wechat,Douban,QQZone,Twitter,Linkedin,Mailto,Reddit,
342#           Delicious,StumbleUpon,Pinterest,Facebook,GooglePlus,Slashdot,
343#           Technorati,Posterous,Tumblr,GoogleBookmarks,Newsvine,
344#           Evernote,Friendfeed,Vkontakte,Odnoklassniki,Mailru
345needmoreshare2:
346  enable: false
347  postbottom:
348    enable: false
349    options:
350      iconStyle: box
351      boxForm: horizontal
352      position: bottomCenter
353      networks: Weibo,Wechat,Douban,QQZone,Twitter,Facebook
354  float:
355    enable: false
356    options:
357      iconStyle: box
358      boxForm: horizontal
359      position: middleRight
360      networks: Weibo,Wechat,Douban,QQZone,Twitter,Facebook
361
362# Google Webmaster tools verification setting
363# See: https://www.google.com/webmasters/
364#google_site_verification:
365
366# Google Analytics
367#google_analytics:
368
369# Bing Webmaster tools verification setting
370# See: https://www.bing.com/webmaster/
371#bing_site_verification:
372
373# Yandex Webmaster tools verification setting
374# See: https://webmaster.yandex.ru/
375#yandex_site_verification:
376
377# CNZZ count
378#cnzz_siteid:
379
380# Application Insights
381# See https://azure.microsoft.com/en-us/services/application-insights/
382# application_insights:
383
384# Make duoshuo show UA
385# user_id must NOT be null when admin_enable is true!
386# you can visit http://dev.duoshuo.com get duoshuo user id.
387duoshuo_info:
388  ua_enable: true
389  admin_enable: false
390  user_id: 0
391  #admin_nickname: Author
392
393# Post widgets & FB/VK comments settings.
394# ---------------------------------------------------------------
395# Facebook SDK Support.
396# https://github.com/iissnan/hexo-theme-next/pull/410
397facebook_sdk:
398  enable:       false
399  app_id:       #<app_id>
400  fb_admin:     #<user_id>
401  like_button:  #true
402  webmaster:    #true
403
404# Facebook comments plugin
405# This plugin depends on Facebook SDK.
406# If facebook_sdk.enable is false, Facebook comments plugin is unavailable.
407facebook_comments_plugin:
408  enable:       false
409  num_of_posts: 10    # min posts num is 1
410  width:        100%  # default width is 550px
411  scheme:       light # default scheme is light (light or dark)
412
413# VKontakte API Support.
414# To get your AppID visit https://vk.com/editapp?act=create
415vkontakte_api:
416  enable:       false
417  app_id:       #<app_id>
418  like:         true
419  comments:     true
420  num_of_posts: 10
421
422# Star rating support to each article.
423# To get your ID visit https://widgetpack.com
424rating:
425  enable: false
426  id:     #<app_id>
427  color:  fc6423
428# ---------------------------------------------------------------
429
430# Show number of visitors to each article.
431# You can visit https://leancloud.cn get AppID and AppKey.
432leancloud_visitors:
433  enable: false
434  app_id: #<app_id>
435  app_key: #<app_key>
436
437# Another tool to show number of visitors to each article.
438# visit https://console.firebase.google.com/u/0/ to get apiKey and projectId
439# visit https://firebase.google.com/docs/firestore/ to get more information about firestore
440firestore:
441  enable: false
442  collection: articles #required, a string collection name to access firestore database
443  apiKey: #required
444  projectId: #required
445  bluebird: false #enable this if you want to include bluebird 3.5.1(core version) Promise polyfill
446
447# Show PV/UV of the website/page with busuanzi.
448# Get more information on http://ibruce.info/2015/04/04/busuanzi/
449busuanzi_count:
450  # count values only if the other configs are false
451  enable: false
452  # custom uv span for the whole site
453  site_uv: true
454  site_uv_header: <i class="fa fa-user"></i>
455  site_uv_footer:
456  # custom pv span for the whole site
457  site_pv: true
458  site_pv_header: <i class="fa fa-eye"></i>
459  site_pv_footer:
460  # custom pv span for one page only
461  page_pv: true
462  page_pv_header: <i class="fa fa-file-o"></i>
463  page_pv_footer:
464
465
466# Tencent analytics ID
467# tencent_analytics:
468
469# Tencent MTA ID
470# tencent_mta:
471
472
473# Enable baidu push so that the blog will push the url to baidu automatically which is very helpful for SEO
474baidu_push: false
475
476# Google Calendar
477# Share your recent schedule to others via calendar page
478#
479# API Documentation:
480# https://developers.google.com/google-apps/calendar/v3/reference/events/list
481calendar:
482  enable: false
483  calendar_id: <required>
484  api_key: <required>
485  orderBy: startTime
486  offsetMax: 24
487  offsetMin: 4
488  timeZone:
489  showDeleted: false
490  singleEvents: true
491  maxResults: 250
492
493# Algolia Search
494algolia_search:
495  enable: false
496  hits:
497    per_page: 10
498  labels:
499    input_placeholder: Search for Posts
500    hits_empty: "We didn't find any results for the search: ${query}"
501    hits_stats: "${hits} results found in ${time} ms"
502
503# Local search
504# Dependencies: https://github.com/flashlab/hexo-generator-search
505local_search:
506  enable: false
507  # if auto, trigger search by changing input
508  # if manual, trigger search by pressing enter key or search button
509  trigger: auto
510  # show top n results per article, show all results by setting to -1
511  top_n_per_article: 1
512
513
514# ---------------------------------------------------------------
515# 标签设置
516# ---------------------------------------------------------------
517# 对外链采用BASE64进行加密解密
518# 用法: {% exturl text url "title" %}
519# 别名: {% extlink text url "title" %}
520exturl: false    # 是否对外链进行加密解密
521
522# Note tag (bs-callout).
523note:
524  # Note tag style values:
525  #  - simple    bs-callout old alert style. Default.
526  #  - modern    bs-callout new (v2-v3) alert style.
527  #  - flat      flat callout style with background, like on Mozilla or StackOverflow.
528  #  - disabled  disable all CSS styles import of note tag.
529  style: simple
530  icons: false
531  border_radius: 3
532  # Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).
533  # Offset also applied to label tag variables. This option can work with disabled note tag.
534  light_bg_offset: 0
535
536# Label tag.
537label: true
538
539# Tabs tag.
540tabs:
541  enable: true
542  transition:
543    tabs: false
544    labels: true
545  border_radius: 0
546
547
548#! ---------------------------------------------------------------
549#! 下面慎重修改，除非你指定它的意义
550#! ---------------------------------------------------------------
551
552# Use velocity to animate everything.
553motion:
554  enable: true
555  async: false
556  transition:
557    # Transition variants:
558    # fadeIn | fadeOut | flipXIn | flipXOut | flipYIn | flipYOut | flipBounceXIn | flipBounceXOut | flipBounceYIn | flipBounceYOut
559    # swoopIn | swoopOut | whirlIn | whirlOut | shrinkIn | shrinkOut | expandIn | expandOut
560    # bounceIn | bounceOut | bounceUpIn | bounceUpOut | bounceDownIn | bounceDownOut | bounceLeftIn | bounceLeftOut | bounceRightIn | bounceRightOut
561    # slideUpIn | slideUpOut | slideDownIn | slideDownOut | slideLeftIn | slideLeftOut | slideRightIn | slideRightOut
562    # slideUpBigIn | slideUpBigOut | slideDownBigIn | slideDownBigOut | slideLeftBigIn | slideLeftBigOut | slideRightBigIn | slideRightBigOut
563    # perspectiveUpIn | perspectiveUpOut | perspectiveDownIn | perspectiveDownOut | perspectiveLeftIn | perspectiveLeftOut | perspectiveRightIn | perspectiveRightOut
564    post_block: fadeIn
565    post_header: slideDownIn
566    post_body: slideDownIn
567    coll_header: slideLeftIn
568    # Only for Pisces | Gemini.
569    sidebar: slideUpIn
570
571# Fancybox
572fancybox: true
573
574# Progress bar in the top during page loading.
575pace: false
576# Themes list:
577#pace-theme-big-counter
578#pace-theme-bounce
579#pace-theme-barber-shop
580#pace-theme-center-atom
581#pace-theme-center-circle
582#pace-theme-center-radar
583#pace-theme-center-simple
584#pace-theme-corner-indicator
585#pace-theme-fill-left
586#pace-theme-flash
587#pace-theme-loading-bar
588#pace-theme-mac-osx
589#pace-theme-minimal
590# For example
591# pace_theme: pace-theme-center-simple
592pace_theme: pace-theme-minimal
593
594# Canvas-nest
595canvas_nest: false
596
597# three_waves
598three_waves: false
599
600# canvas_lines
601canvas_lines: false
602
603# canvas_sphere
604canvas_sphere: false
605
606# Only fit scheme Pisces
607# Canvas-ribbon
608# size: The width of the ribbon.
609# alpha: The transparency of the ribbon.
610# zIndex: The display level of the ribbon.
611canvas_ribbon:
612  enable: false
613  size: 300
614  alpha: 0.6
615  zIndex: -1
616
617# 脚本提供者设置。
618# 为js文件指定CDN，加快加载速度
619# 注意，CDN版本一致。如果CDN提供https，无别加上https协议。
620vendors:
621  _internal: lib    # 本网站提供脚本的路径，不要轻易修改。
622  
623  jquery:    https://cdn.bootcss.com/jquery/2.1.3/jquery.min.js # 内部版本2.1.3。CDN版本应一致
624
625  fancybox:        # 内部版本2.1.5。
626  fancybox_css:
627  fastclick:       # 内部版本1.0.6。
628  lazyload:        # 内部版本1.9.7。
629  velocity:        # 内部版本1.2.1。
630  velocity_ui:     # 内部版本1.2.1。
631  ua_parser:       # 内部版本0.7.9。
632  fontawesome:     # 内部版本4.6.2
633  algolia_instant_js:    fontawesome:    # 内部版本 1
634  algolia_instant_css:
635  pace:            # 内部版本 1.0.2。
636  pace_css:
637  canvas_nest:     # 内部版本 1.0.0
638  three:           # 3D脚本库，未指定内部版本
639  three_waves:     # 未指定内部版本
640  canvas_lines:    # 未指定内部版本
641  canvas_sphere:   # 未指定内部版本
642  canvas_ribbon:   # 内部版本 1.0.0
643  han:             # 内部版本 3.3.0
644  needMoreShare2:  # 未指定内部版本
645
646# 资源种类
647css: css
648js: js
649images: images
650
651# Theme version
652version: 5.1.4
Hexo+NexT（三）：Next主题配置详解

1. NexT主题配置文件详解

评论区

相关推荐
