本文主要是介绍【Hexo系列】【6】NexT主题使用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
本期将为大家讲解Hexo NexT主题的使用。
1. NexT介绍
NexT是Hexo的知名第三方主题,黑白极简风格四合一,有相当多的使用者,维护也相当给力,数年来一直都在频繁更新。
Next主题官网:https://github.com/next-theme/hexo-theme-next
官网效果图:
2. NexT安装
2.1 下载主题
建议你使用clone最新版本的方式,之后的更新可以通过 git pull 来快速更新, 而不用再次下载压缩包替换。
切换到博客的主题根目录下打开Git Bash
并执行以下命令:
git clone https://github.com/next-theme/hexo-theme-next.git themes/next
下载完成后,会在项目themes目录下生成next文件夹。
如果没有修改代码的需求可以直接通过npm来安装。
npm install hexo-theme-next
2.2 切换主题
与所有 Hexo 主题启用的模式一样。当 克隆/下载 完成后,打开 站点配置文件
, 找到 theme
字段,并将其值更改为 next
。
theme: next
到此,NexT 主题安装完成。
2.3 验证主题
启动服务并访问http://localhost:4000查看效果.
hexo clean && hexo s
3. NexT配置
NexT的主题配置文件
是themes/next/_config.yml
。
3.1 配置说明
以下是themes/next/_config.yml
文件的翻译版本,可以复制进去替换原文件
# ---------------------------------------------------------------
# 主题核心配置设置
# 参见:https://theme-next.js.org/docs/theme-settings/
# ---------------------------------------------------------------# 允许缓存内容生成。
cache:enable: true# 生成 Hexo 后删除不必要的文件。
minify: false# 定义自定义文件路径。
# 在 `source/_data` 目录下创建自定义文件并取消下面需要的文件的注释。
custom_file_path:#head: source/_data/head.njk#header: source/_data/header.njk#sidebar: source/_data/sidebar.njk#postMeta: source/_data/post-meta.njk#postBodyStart: source/_data/post-body-start.njk#postBodyEnd: source/_data/post-body-end.njk#footer: source/_data/footer.njk#bodyEnd: source/_data/body-end.njk#variable: source/_data/variables.styl#mixin: source/_data/mixins.styl#style: source/_data/styles.styl# ---------------------------------------------------------------
# 方案设置
# ---------------------------------------------------------------# 方案
scheme: Muse
#scheme: Mist
#scheme: Pisces
#scheme: Gemini# 暗黑模式
darkmode: false# ---------------------------------------------------------------
# 网站信息设置
# ---------------------------------------------------------------favicon:# 小图标small: /images/favicon-16x16-next.png# 中图标medium: /images/favicon-32x32-next.png# Apple 触摸图标apple_touch_icon: /images/apple-touch-icon-next.png# Safari 固定标签页图标safari_pinned_tab: /images/logo.svg# Android 清单#android_manifest: /manifest.json# 自定义 Logo(警告:Mist 方案不支持)
custom_logo: #/uploads/custom-logo.png# 知识共享 4.0 国际许可协议。
# 参见:https://creativecommons.org/about/cclicenses/
creative_commons:# 可用值:by | by-nc | by-nc-nd | by-nc-sa | by-nd | by-sa | cc-zerolicense: by-nc-sa# 可用值:big | smallsize: smallsidebar: falsepost: false# 如果您希望使用知识共享许可协议的翻译版本,可以设置一个语言值,例如 deed.zh# 知识共享许可协议提供 39 种语言版本,您可以在 https://creativecommons.org 上找到您需要的特定和正确的缩写language:# 开放图谱设置
# 参见:https://hexo.io/docs/helpers#open-graph
open_graph:enable: trueoptions:#twitter_card: <twitter:card>#twitter_id: <twitter:creator>#twitter_site: <twitter:site>#twitter_image: <twitter:image>#google_plus: <g+:profile_link>#fb_admins: <fb:admin_id>#fb_app_id: <fb:app_id># ---------------------------------------------------------------
# 菜单设置
# ---------------------------------------------------------------# 使用:`键: /链接/ || 图标`
# 键是菜单项的名称。如果此项目有可用的翻译,将加载翻译后的文本,否则将使用键名称。键是区分大小写的。
# 值在 `||` 分隔符之前是目标链接,值在 `||` 分隔符之后是 Font Awesome 图标名称。
# 外部 URL 应该以 http:// 或 https:// 开头
menu:#home: / || fa fa-home#about: /about/ || fa fa-user#tags: /tags/ || fa fa-tags#categories: /categories/ || fa fa-th#archives: /archives/ || fa fa-archive#schedule: /schedule/ || fa fa-calendar#sitemap: /sitemap.xml || fa fa-sitemap#commonweal: /404/ || fa fa-heartbeat# 启用/禁用菜单图标/项目徽章。
menu_settings:icons: truebadges: false# ---------------------------------------------------------------
# 侧边栏设置
# 参见:https://theme-next.js.org/docs/theme-settings/sidebar
# ---------------------------------------------------------------sidebar:# 侧边栏位置。可用值:left | rightposition: left# 侧边栏宽度。# 适用于 Muse | Mist 和 Pisces | Gemini 的移动设备。width_expanded: 320# 适用于 Pisces | Gemini 的桌面设备。width_dual_column: 240# 侧边栏显示。# 适用于 Muse | Mist 和 Pisces | Gemini 的移动设备。# 可用值:# - post 自动展开文章。默认。# - always 自动展开所有页面。始终。# - hide 仅在点击侧边栏切换图标时展开。# - remove 完全移除侧边栏,包括侧边栏切换。display: post# 侧边栏内边距(像素)。padding: 18# 侧边栏偏移量,从顶部菜单栏开始(仅适用于 Pisces | Gemini)。offset: 12# 侧边栏头像
avatar:# 替换默认图片并在这里设置 URL。url: #/images/avatar.gif# 如果为 true,则头像将显示为圆形。rounded: false# 如果为 true,则头像将随着光标旋转。rotated: false# 侧边栏中的文章/分类/标签。
site_state: true# 社交链接
# 使用:`键: 永久链接 || 图标`
# 键是最终用户看到的链接标签。
# 值在 `||` 分隔符之前是目标永久链接,值在 `||` 分隔符之后是 Font Awesome 图标名称。
social:#GitHub: https://github.com/yourname || fab fa-github#E-Mail: mailto:yourname@gmail.com || fa fa-envelope#Weibo: https://weibo.com/yourname || fab fa-weibo#Twitter: https://twitter.com/yourname || fab fa-twitter#FB Page: https://www.facebook.com/yourname || fab fa-facebook#StackOverflow: https://stackoverflow.com/yourname || fab fa-stack-overflow#YouTube: https://youtube.com/yourname || fab fa-youtube#Instagram: https://instagram.com/yourname || fab fa-instagram#Skype: skype:yourname?call|chat || fab fa-skypesocial_icons:enable: trueicons_only: falsetransition: false# 友情链接设置
links_settings:icon: fa fa-globe# 可用值:block | inlinelayout: blocklinks:#标题: https://example.com# 侧边栏中的目录
toc:enable: true# 自动为目录添加列表编号。number: true# 如果为 true,则当标题宽度超过侧边栏宽度时,所有单词将放在下一行。wrap: false# 如果为 true,则显示文章中所有级别的目录,而不是仅显示激活部分。expand_all: false# 生成目录的最大标题深度。max_depth: 6# ---------------------------------------------------------------
# 页脚设置
# 参见:https://theme-next.js.org/docs/theme-settings/footer
# ---------------------------------------------------------------# 在页脚显示多语言切换器。
language_switcher: falsefooter:# 指定网站建立的年份。如果没有定义,将使用当前年份。#since: 2021# 年份和版权信息之间的图标。icon:# Font Awesome 中的图标名称。参见:https://fontawesome.com/iconsname: fa fa-heart# 如果您想让图标动起来,设为 true。animated: false# 更改图标的颜色,使用十六进制代码。color: "#ff0000"# 如果未定义,则使用 Hexo `_config.yml` 中的 `author`。# 设置为 `false` 以禁用版权声明。copyright:# 显示由 Hexo & NexT 驱动powered: true# 中国用户的 ICP 备案和公安信息。参见:https://beian.miit.gov.cn,https://beian.mps.gov.cnbeian:enable: falseicp:# 公安备案编号中的数字。gongan_id:# 完整的公安备案编号。gongan_num:# 公安备案图标的 URL。登录并参见:https://beian.mps.gov.cn/web/business/businessHome/websitegongan_icon_url:# ---------------------------------------------------------------
# 文章设置
# 参见:https://theme-next.js.org/docs/theme-settings/posts
# ---------------------------------------------------------------# 使用 front-matter 中的 `description` 指定文章摘要。
excerpt_description: true# 按钮
# 如果为 true,则会在摘要部分显示按钮。
read_more_btn: true# 文章元数据显示设置
post_meta:item_text: truecreated_at: trueupdated_at:enable: trueanother_day: truecategories: true# 文章字数统计显示设置
# 依赖项:https://github.com/next-theme/hexo-word-counter
symbols_count_time:separated_meta: trueitem_text_total: false# 使用图标代替符号 # 来标示文章底部的标签
tag_icon: false# 捐赠(赞助)设置
# front-matter 变量(不支持动画)。
reward_settings:# 如果为 true,则默认在每篇文章中显示捐赠按钮。enable: falseanimation: falsereward:#wechatpay: /images/wechatpay.png#alipay: /images/alipay.png#paypal: /images/paypal.png#bitcoin: /images/bitcoin.png# 通过 Telegram 频道、Twitter 等关注我
# 使用:`键: 永久链接 || 图标`(Font Awesome)
follow_me:#Twitter: https://twitter.com/username || fab fa-twitter#Telegram: https://t.me/channel_name || fab fa-telegram#WeChat: /images/wechat_channel.png || fab fa-weixin#RSS: /atom.xml || fa fa-rss# 相关热门文章
# 依赖项:https://github.com/sergeyzwezdin/hexo-related-posts
related_posts:enable: falseicon: fa fa-signs-post# 文章编辑
# 轻松浏览和在线编辑博客源代码。
post_edit:enable: falseurl: https://github.com/user-name/repo-name/tree/branch-name/subdirectory-name/ # 查看源代码的链接#url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/ # 用于 fork & 编辑的链接# 如果存在,在文章页脚显示上一篇和下一篇文章
# 可用值:left | right | false
post_navigation: left# ---------------------------------------------------------------
# 自定义页面设置
# 参见:https://theme-next.js.org/docs/theme-settings/custom-pages
# ---------------------------------------------------------------# 标签云设置
tagcloud:min: 12 # 最小字体大小,单位 pxmax: 30 # 最大字体大小,单位 pxamount: 200 # 标签总数orderby: name # 标签排序方式order: 1 # 排序顺序# Google 日历
# 通过日历页面与他人分享您的近期日程。
calendar:calendar_id: <required> # 您的 Google 账户邮箱api_key: <required>orderBy: startTimeshowLocation: falseoffsetMax: 72 # 时间范围offsetMin: 4 # 时间范围showDeleted: falsesingleEvents: truemaxResults: 250# ---------------------------------------------------------------
# 其他主题设置
# 参见:https://theme-next.js.org/docs/theme-settings/miscellaneous
# ---------------------------------------------------------------# 预加载样式并为字体和插件预连接 CDN。
# 更多信息:https://www.w3.org/TR/resource-hints/#preconnect
preconnect: false# 设置文章/页面中的文本对齐方式。
text_align:# 可用值:start | end | left | right | center | justify | justify-all | match-parentdesktop: justifymobile: justify# 在宽度较窄的设备上减少填充/边距缩进。
mobile_layout_economy: false# 浏览器头部面板颜色。
theme_color:light: "#222"dark: "#222"# 覆盖浏览器的默认行为。
body_scrollbar:# 将滚动条置于内容上方。overlay: false# 即使内容没有溢出,也要显示滚动条。stable: falsecodeblock:# 代码高亮主题# 所有可用主题:https://theme-next.js.org/highlight/theme:light: defaultdark: stackoverflow-darkprism:light: prismdark: prism-dark# 在代码块上添加复制按钮copy_button:enable: false# 可用值:default | flat | macstyle:# 折叠代码块fold:enable: falseheight: 500back2top:enable: true# 侧边栏中的返回顶部sidebar: false# b2t 按钮中的滚动百分比标签scrollpercent: false# 阅读进度条
reading_progress:enable: false# 可用值:left | rightstart_at: left# 可用值:top | bottomposition: topreversed: falsecolor: "#37c6c0"height: 3px# 书签支持
bookmark:enable: false# 自定义书签的颜色。color: "#222"# 如果是自动,关闭页面或点击书签图标时将保存阅读进度。# 如果是手动,只有点击书签图标时才保存。save: auto# 右上角的“在 GitHub 上关注我”横幅。
github_banner:enable: falsepermalink: https://github.com/yourname# ---------------------------------------------------------------
# 字体设置
# ---------------------------------------------------------------
# 在 Google Fonts (https://fonts.google.com) 上查找字体
# 这里设置的所有字体都将具有以下样式:
# light | light italic | normal | normal italic | bold | bold italic
# 请注意,设置太多字体会导致网站运行缓慢
# ---------------------------------------------------------------# Web 安全字体推荐用于 `global`(和 `title`):
# Arial | Tahoma | Helvetica | Times New Roman | Courier New | Verdana | Georgia | Palatino | Garamond | Comic Sans MS | Trebuchet MS
# ---------------------------------------------------------------font:enable: false# 字体主机的 URI,例如 https://fonts.googleapis.com (默认)。host:# 字体选项:# `external: true` 将从上述 `host` 加载此字体家族。# `family: Times New Roman`。不要使用任何引号。# `size: x.x`。使用 `em` 作为单位。默认:1 (16px)# 全局字体设置用于 `<body>` 内的所有元素。global:external: truefamily: Latosize:# 网站标题 (.site-title) 的字体设置。title:external: truefamily:size:# 标题 (<h1> 到 <h6>) 的字体设置。headings:external: truefamily:size:# 文章 (.post-body) 的字体设置。posts:external: truefamily:# `<code>` 和代码块的字体设置。codes:external: truefamily:# ---------------------------------------------------------------
# SEO 设置
# 参见:https://theme-next.js.org/docs/theme-settings/seo
# ---------------------------------------------------------------# 如果为 true,网站副标题将被添加到首页标题中。
# 记得在 Hexo `_config.yml` 中设置您的网站副标题(例如 subtitle: 副标题)
index_with_subtitle: false# 自动添加外部 URL 并使用 Base64 加密 & 解密。
# 如果为 true,每个外部 URL 将附加一个图标。
exturl: false
exturl_icon: true# Google 网站管理员工具验证。
# 参见:https://developers.google.com/search
google_site_verification:# Bing 网站管理员工具验证。
# 参见:https://www.bing.com/webmasters
bing_site_verification:# Yandex 网站管理员工具验证。
# 参见:https://webmaster.yandex.ru
yandex_site_verification:# 百度网站管理员工具验证。
# 参见:https://ziyuan.baidu.com/site
baidu_site_verification:# ---------------------------------------------------------------
# 标签设置
# 参见:https://theme-next.js.org/docs/tag-plugins/
# ---------------------------------------------------------------# 笔记标签(bootstrap 呼叫框)
note:# 笔记标签风格值:# - simple bootstrap 旧警告样式。默认。# - modern bootstrap 新(v2-v3)警告样式。# - flat 带有背景的平面呼叫框样式,如 Mozilla 或 StackOverflow。# - disabled 禁用笔记标签的所有 CSS 样式导入。style: simpleicons: false# 现代和平面风格背景颜色的偏移量(现代:-12 | 12; 平面:-18 | 6)。# 偏移量也应用于标签变量。此选项可以与禁用的笔记标签一起使用。light_bg_offset: 0# 标签页
tabs:# 使具有长内容的标签页导航栏粘在顶部。sticky: falsetransition:tabs: falselabels: true# PDF 标签
pdf:enable: false# 默认高度height: 500px# Mermaid 标签
mermaid:enable: false# 可用主题:default | dark | forest | neutraltheme:light: defaultdark: dark# WaveDrom 标签
wavedrom:enable: false# ---------------------------------------------------------------
# 第三方插件和服务商设置
# 参见: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/math-equations
# 警告:请根据文档安装/卸载相关渲染器。
# 服务端插件:https://github.com/next-theme/hexo-filter-mathjax
# ---------------------------------------------------------------math:# 默认(false)将在需求时加载 mathjax / katex 脚本。# 也就是说,它仅渲染 front-matter 中有 `mathjax: true` 的页面。# 如果你设为 true,它将为每一页加载 mathjax / katex 脚本。every_page: falsemathjax:enable: false# 可用值:none | ams | alltags: nonekatex:enable: false# 参见:https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-texcopy_tex: false# ---------------------------------------------------------------
# 外部库
# 参见:https://theme-next.js.org/docs/third-party-services/external-libraries
# ---------------------------------------------------------------# 轻松启用网站上的快速 Ajax 导航。
# 更多信息:https://github.com/next-theme/pjax
pjax: false# FancyBox 是一个工具,它提供了一种美观、优雅的方式来为图片添加缩放功能。
# 更多信息:https://fancyapps.com/fancybox/
fancybox: false# Medium Zoom 是一个 JavaScript 库,用于像 Medium 一样缩放图片。
# 警告:不要同时启用 `fancybox` 和 `mediumzoom`。
# 更多信息:https://medium-zoom.francoischalifour.com
mediumzoom: false# Vanilla JavaScript 插件,用于延迟加载图片。
# 更多信息:https://apoorv.pro/lozad.js/demo/
lazyload: false# 自动在 CJK 和半角字符之间插入空白。
# 更多信息:https://github.com/vinta/pangu.js
# 服务端插件:https://github.com/next-theme/hexo-pangu
pangu: false# 根据用户视口中的内容预加载链接。
# 更多信息:https://getquick.link
# front-matter 变量(不支持主页归档)。
quicklink:enable: false# 主页和归档页可以通过下面的 home 和 archive 选项进行控制。# 此配置项独立于 `enable`。home: falsearchive: false# 默认(true)将在加载事件触发后初始化 quicklink。delay: true# 通过毫秒自定义浏览器执行预加载的时间。timeout: 3000# 默认(true)将尝试使用 fetch() API(如果支持的话,而不是 link[rel=prefetch])。priority: true# ---------------------------------------------------------------
# 动画设置
# ---------------------------------------------------------------# 使用 Animate.css 使一切动起来。
# 更多信息:https://animate.style
motion:enable: trueasync: falsetransition:# 所有可用的过渡变体:https://theme-next.js.org/animate/menu_item: fadeInDownpost_block: fadeInpost_header: fadeInDownpost_body: fadeInDowncoll_header: fadeInLeft# 仅适用于 Pisces | Gemini。sidebar: fadeInUp# 页面加载期间顶部的进度条。
# 更多信息:https://github.com/CodeByZach/pace
pace:enable: false# 所有可用颜色:# black | blue | green | orange | pink | purple | red | silver | white | yellowcolor: blue# 所有可用主题:# big-counter | bounce | barber-shop | center-atom | center-circle | center-radar | center-simple# corner-indicator | fill-left | flat-top | flash | loading-bar | mac-osx | material | minimaltheme: minimal# 使用 HTML5 canvas 在您的网站上生成一个彩带。
# 更多信息:https://github.com/hustcc/ribbon.js
canvas_ribbon:enable: falsesize: 300 # 彩带的宽度alpha: 0.6 # 彩带的透明度zIndex: -1 # 彩带的显示级别# ---------------------------------------------------------------
# 评论设置
# 参见:https://theme-next.js.org/docs/third-party-services/comments
# ---------------------------------------------------------------# 多评论系统支持
comments:# 可用值:tabs | buttonsstyle: tabs# 选择默认显示的评论系统。# 可用值:disqus | disqusjs | changyan | livere | gitalk | utterancesactive:# 设置 `true` 表示记住访问者选择的评论系统。storage: true# 延迟加载所有评论系统。lazyload: false# 修改任何 naves 的文本或顺序,这里有一些示例。nav:#disqus:# text: Load Disqus# order: -1#gitalk:# order: -2# Disqus
# 更多信息:https://disqus.com
disqus:enable: falseshortname:count: true# DisqusJS
# 更多信息:https://disqusjs.skk.moe
disqusjs:enable: false# Disqus API 的 API 端点(https://disqus.com/api/docs/)。# 如果您能够连接到 Disqus API,则留空 api。否则,您需要一个反向代理。# 例如:# api: https://disqus.skk.moe/disqus/api:apikey: # 从 https://disqus.com/api/applications/ 注册新应用程序shortname: # 参见:https://disqus.com/admin/settings/general# Changyan
# 更多信息:https://changyan.kuaizhan.com
changyan:enable: falseappid:appkey:# 显示评论数量count: true# LiveRe 评论系统
# 您可以从 https://livere.com/insight/myCode (普通网站)获取您的 uid
livere_uid:# Gitalk
# 更多信息:https://gitalk.github.io
gitalk:enable: falsegithub_id: # GitHub 仓库所有者repo: # 存储问题的仓库名称client_id: # GitHub 应用程序客户端 IDclient_secret: # GitHub 应用程序客户端密钥admin_user: # GitHub 仓库所有者和协作者,只有这些人才能初始化 gitHub 问题distraction_free_mode: true # 类似 Facebook 的无干扰模式# 当官方代理不可用时,您可以更改为您自己的代理地址proxy: https://cors-anywhere.azm.workers.dev/https://github.com/login/oauth/access_token # 这是官方代理地址# Gitalk 的显示语言取决于用户的浏览器或系统环境# 如果您希望访问您网站的每个人看到统一的语言,您可以设置一个强制语言值# 可用值:en | es-ES | fr | ru | zh-CN | zh-TWlanguage:# Utterances
# 更多信息:https://utteranc.es
utterances:enable: falserepo: user-name/repo-name # Github 仓库所有者和名称# 可用值:pathname | url | title | og:titleissue_term: pathname# 可用值:github-light | github-dark | preferred-color-scheme | github-dark-orange | icy-dark | dark-blue | photon-dark | boxy-lighttheme: github-light# Isso
# 更多信息:https://isso-comments.de
isso: # <data_isso># ---------------------------------------------------------------
# 帖子小部件和内容共享服务
# 参见:https://theme-next.js.org/docs/third-party-services/post-widgets
# ---------------------------------------------------------------# AddToAny Share。参见:https://www.addtoany.com
addtoany:enable: falsebuttons:- facebook- twitter# ---------------------------------------------------------------
# 统计和分析
# 参见:https://theme-next.js.org/docs/third-party-services/statistics-and-analytics
# ---------------------------------------------------------------# Google Analytics
# 参见:https://analytics.google.com
google_analytics:tracking_id: # <app_id># 默认情况下,NexT 会在您的网站上加载一个外部的 gtag.js 脚本。# 如果您只需要页面浏览功能,请将以下选项设置为 true 以获得更好的性能。only_pageview: false# 仅当您使用 `only_pageview` 模式时才需要,https://developers.google.com/analytics/devguides/collection/protocol/ga4measure_protocol_api_secret:# Baidu Analytics
# 参见:https://tongji.baidu.com
baidu_analytics: # <app_id># Growingio Analytics
# 参见:https://www.growingio.com
growingio_analytics: # <project_id># Cloudflare Web Analytics
# 参见:https://www.cloudflare.com/web-analytics/
cloudflare_analytics:# Microsoft Clarity Analytics
# 参见:https://clarity.microsoft.com/
clarity_analytics: # <project_id># Matomo Analytics
# 参见:https://matomo.org/
matomo:enable: falseserver_url: # https://www.example.com/site_id: # <your site id># Umami Analytics
# 参见:https://umami.is/
umami:enable: falsescript_url: # https://umami.example.com/script.jswebsite_id: # <your website id>host_url: # <your umami site url># Plausible Analytics
# 参见:https://plausible.io/
plausible:enable: falsescript_url: # https://plausible.io/js/script.jssite_domain: # www.example.com# 显示每篇文章的访问者数量。
# 您可以访问 https://www.leancloud.cn 来获取 AppID 和 AppKey。
leancloud_visitors:enable: falseapp_id: # <your app id>app_key: # <your app key># 适用于来自中国区域的应用程序server_url: # <your server url># 依赖项:https://github.com/theme-next/hexo-leancloud-counter-security# 如果您不关心 leancloud 计数器的安全性,并且只想直接使用它# (无需 hexo-leancloud-counter-security 插件),则将 `security` 设置为 `false`。security: true# 使用另一种工具来显示每篇文章的访问量/访客。
# 访问 https://console.firebase.google.com/u/0/ 来获取 apiKey 和 projectId。
# 访问 https://firebase.google.com/docs/firestore/ 来获取有关 firestore 的更多信息。
firestore:enable: falsecollection: articles # 需要的字符串集合名称,用于访问 firestore 数据库apiKey: # 需要projectId: # 需要# 使用 busuanzi 显示网站/页面的浏览量/访客。
# 更多信息:http://ibruce.info/2015/04/04/busuanzi/
busuanzi_count:enable: falsetotal_visitors: truetotal_visitors_icon: fa fa-usertotal_views: truetotal_views_icon: fa fa-eyepost_views: truepost_views_icon: far fa-eye# ---------------------------------------------------------------
# 搜索服务
# 参见:https://theme-next.js.org/docs/third-party-services/search-services
# ---------------------------------------------------------------# Algolia Search
# 更多信息:https://www.algolia.com
algolia_search:enable: falsehits:per_page: 10# 本地搜索
# 依赖项:https://github.com/next-theme/hexo-generator-searchdb
local_search:enable: false# 每篇文章显示前 n 个结果,设置为 -1 显示所有结果top_n_per_article: 1# 解码 HTML 字符串为可读格式。unescape: false# 页面加载时预加载搜索数据。preload: false# ---------------------------------------------------------------
# 聊天服务
# 参见:https://theme-next.js.org/docs/third-party-services/chat-services
# ---------------------------------------------------------------# 一个按钮,用于在侧边栏打开指定的聊天小部件。
# 首先,您需要启用并配置聊天服务。
chat:enable: falseicon: fa fa-comment # Font Awesome 中的图标名称,设置为 `false` 禁用图标。# Chatra 是一个功能性的、易于使用的适用于网站的聊天软件。
# 更多信息:https://chatra.com
# 控制面板:https://app.chatra.io/settings/general
chatra:enable: falseasync: trueid: # 访问控制面板以获取您的 ChatraID#embed: # 开发人员专用的未完成实验性功能。参见:https://chatra.com/help/api/#injectto# Tidio 是一个功能强大的、一站式的客户服务工具。
# 更多信息:https://www.tidio.com
# 控制面板:https://www.tidio.com/panel/dashboard
tidio:enable: falsekey: # 公开密钥,从控制面板获取。参见:https://www.tidio.com/panel/settings/developer# ---------------------------------------------------------------
# CDN 设置
# 参见:https://theme-next.js.org/docs/advanced-settings/vendors
# ---------------------------------------------------------------vendors:# NexT 内部脚本的 CDN 服务提供商。# 可用值:local | jsdelivr | unpkg | cdnjs | custom# 警告:如果您使用的是 NexT 的最新 master 分支,请设置 `internal: local`internal: local# 第三方插件的默认 CDN 服务提供商。# 可用值:local | jsdelivr | unpkg | cdnjs | custom# `plugins: local` 的依赖项:https://github.com/next-theme/plugins plugins: cdnjs# 自定义 CDN URL# 例如:# custom_cdn_url: https://cdn.jsdelivr.net/npm/${npm_name}@${version}/${minified} # custom_cdn_url: https://cdnjs.cloudflare.com/ajax/libs/${cdnjs_name}/${version}/${cdnjs_file} custom_cdn_url:# 资源
# 使用 CDN 加速静态文件的传输
# 当 vendors.internal 设置为 local 时,js 选项才有效。
css: css
js: js
images: images
3.2 更改语言
首先我们要将英语改为中文;NexT主题自带了许多语言。
编辑**站点配置文件
**,修改语言设置。
language: zh-CN
3.3 选择 Scheme
Scheme 是 NexT 提供的一种特性,借助于 Scheme,NexT 为你提供多种不同的外观。同时,几乎所有的配置都可以 在 Scheme 之间共用。目前 NexT 支持四种 Scheme:
Muse
- 默认 Scheme,这是 NexT 最初的版本,黑白主调,大量留白Mist
- Muse 的紧凑版本,整洁有序的单栏外观Pisces
- 双栏 Scheme,小家碧玉似的清新Gemini
- 新增的主题(还没发现具体差别)
Scheme 的切换通过更改 主题配置文件
,搜索 scheme 关键字,将你需用启用的 scheme 前面注释 # 去除即可。
3.4 设置导航菜单
效果图:
NexT菜单配置包括三个部分,第一是菜单项(名称和链接),第二是菜单项的显示文本,第三是菜单项对应的图标。NexT 使用的是 Font Awesome 提供的图标, Font Awesome 提供了 600+ 的图标,可以满足绝大的多数的场景,同时无须担心在 Retina 屏幕下 图标模糊的问题。
编辑 themes/next/_config.yml
,修改以下内容:
-
设定菜单内容,对应的字段是
menu
。菜单内容的设置格式是:item name: link
。其中item name
是一个名称,这个名称并不直接显示在页面上,它将用于匹配图标以及翻译。# 使用:`键: /链接/ || 图标` # 键是菜单项的名称。如果此项目有可用的翻译,将加载翻译后的文本,否则将使用键名称。键是区分大小写的。 # 值在 `||` 分隔符之前是目标链接,值在 `||` 分隔符之后是 Font Awesome 图标名称。 # 外部 URL 应该以 http:// 或 https:// 开头 menu:home: / || fa fa-homegift: /gift/ || fa fa-gifthotel: /hotel/ || fa fa-hotelabout: /about/ || fa fa-usertags: /tags/ || fa fa-tagscategories: /categories/ || fa fa-th#archives: /archives/ || fa fa-archive#schedule: /schedule/ || fa fa-calendar#sitemap: /sitemap.xml || fa fa-sitemap#commonweal: /404/ || fa fa-heartbeat
NexT 默认的菜单项有(标注 ! 的项表示需要手动创建这个页面):
键值 | 设定值 | 显示文本(简体中文) |
---|---|---|
home | home: / | 主页 |
archives | archives: /archives | 归档页 |
categories | categories: /categories | 分类页 ! |
tags | tags: /tags | 标签页 ! |
about | about: /about | 关于页面 ! |
commonweal | commonweal: /404.html | 公益 404 ! |
-
设置菜单项的显示文本。在上一步中设置的菜单的名称并不直接用于界面上的展示。
Hexo 在生成的时候将使用 这个名称查找对应的语言翻译,并提取显示文本。这些翻译文本放置在 NexT 主题目录下的
languages/{language}.yml
({language}
为你所使用的语言)。以简体中文为例,若你需要添加一个菜单项,比如
something
。那么就需要修改简体中文对应的翻译文件languages/zh-CN.yml
,在menu
字段下添加一项:menu:home: 首页archives: 归档categories: 分类tags: 标签about: 关于search: 搜索schedule: 日程表sitemap: 站点地图commonweal: 公益 404gift: 礼品hotel: 酒店
请注意键值(如 home)的大小写要严格匹配。
-
设定菜单项的图标。enable 可用于控制是否显示图标,你可以设置成 false 来去掉图标。
# 启用/禁用菜单图标/项目徽章。 menu_settings:icons: falsebadges: false
3.5 设置侧边栏
效果图:
默认情况下,侧栏仅在文章页面(拥有目录列表)时才显示,并放置于左侧位置。
可以通过修改 主题配置文件
中的 sidebar
字段来控制侧栏的行为。侧栏的设置包括两个部分,其一是侧栏的位置, 其二是侧栏显示的时机。
- 设置侧栏的位置,修改
sidebar.position
的值,支持的选项有:
- left - 靠左放置
- right - 靠右放置
编辑 themes/next/_config.yml
,修改以下内容:
sidebar:# 侧边栏位置。可用值:left | rightposition: left
- 设置侧栏显示的时机,修改
sidebar.display
的值,支持的选项有:
post
- 默认行为,在文章页面(拥有目录列表)时显示always
- 在所有页面中都显示hide
- 在所有页面中都隐藏(可以手动展开)remove
- 完全移除
sidebar:display: always
3.6 设置头像
效果图:
编辑 主题配置文件
, 修改字段 avatar
, 值设置成头像的链接地址。其中,头像的链接地址可以是:
- 完整的互联网 URI,如:http://example.com/avatar.png
- 站点内的地址,主题或站点的source目录下。注意:是站点根目录的
source
文件夹里。
avatar:# 替换默认图片并在这里设置 URL。url: /images/next_icon.png
3.7 侧边栏社交链接
效果图:
-
链接放置在
social
属性下,一行一个链接。其键值格式是 显示文本: 链接地址 || 图标。# 社交链接 # 使用:`键: 永久链接 || 图标` # 键是最终用户看到的链接标签。 # 值在 `||` 分隔符之前是目标永久链接,值在 `||` 分隔符之后是 Font Awesome 图标名称。 social:微信: https://github.com/yourname || fab fa-weixinGitHub: https://github.com/yourname || fab fa-githubE-Mail: mailto:yourname@gmail.com || fa fa-envelope微博: https://weibo.com/yourname || fab fa-weiboTwitter: https://twitter.com/yourname || fab fa-twitterFB Page: https://www.facebook.com/yourname || fab fa-facebookStackOverflow: https://stackoverflow.com/yourname || fab fa-stack-overflowYouTube: https://youtube.com/yourname || fab fa-youtubeInstagram: https://instagram.com/yourname || fab fa-instagramSkype: skype:yourname?call|chat || fab fa-skype
-
设定链接的图标,对应的字段是 social_icons。
其键值格式是 匹配键: Font Awesome 图标名称, 匹配键 与上一步所配置的链接的 显示文本 相同(大小写严格匹配),图标名称 是 Font Awesome 图标的名字。enable 选项用于控制是否显示图标,你可以设置成 false 来去掉图标。
social_icons:enable: trueicons_only: falsetransition: false
可以在https://github.com/FortAwesome查询 Font Awesome的图标。
3.8 设置友情链接
效果图:
编辑 主题配置文件
,配置如下:
links:#标题: https://example.com7WE: https://7we.cn/Hexo: https://hexo.io/zh-cn/NexT: https://theme-next.iissnan.com/Hexo Admin: https://github.com/jaredly/hexo-admin
3.9 站点建立时间
这个时间将在站点的底部显示,例如 © 2015 - 2019
。编辑 主题配置文件
,配置如下:
footer:# 指定网站建立的年份。如果没有定义,将使用当前年份。since: 2021
3.10 订阅微信公众号
效果图:
在每篇文章的末尾显示微信公众号二维码,扫一扫,轻松订阅博客。
在微信公众号平台下载您的二维码,并将它存放于主题 source/images/ 目录下。
然后编辑 主题配置文件
,配置如下:
follow_me:Twitter: https://twitter.com/username || fab fa-twitterTelegram: https://t.me/channel_name || fab fa-telegramWeChat: /images/next_icon.png || fab fa-weixinRSS: /atom.xml || fa fa-rss
3.11 设置阅读全文
效果图:
在首页显示一篇文章的部分内容,并提供一个链接跳转到全文页面是一个常见的需求。在首页显示文章的摘录并显示 阅读全文
按钮,可以通过以下方法:
- 在文章中使用
<!-- more -->
手动进行截断,Hexo 提供的方式 推荐。 - 在文章的 front-matter 中添加 description,并提供文章摘录
建议使用
<!-- more -->
(即第一种方式),除了可以精确控制需要显示的摘录内容以外, 这种方式也可以让 Hexo 中的插件更好的识别。
这篇关于【Hexo系列】【6】NexT主题使用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!