【Hexo系列】【6】NexT主题使用

news2024/11/15 23:22:11

本期将为大家讲解Hexo NexT主题的使用。

1. NexT介绍

NexT是Hexo的知名第三方主题,黑白极简风格四合一,有相当多的使用者,维护也相当给力,数年来一直都在频繁更新。

Next主题官网:https://github.com/next-theme/hexo-theme-next

官网效果图:

image-20240724153831623

2. NexT安装

2.1 下载主题

建议你使用clone最新版本的方式,之后的更新可以通过 git pull 来快速更新, 而不用再次下载压缩包替换。

切换到博客的主题根目录下打开Git Bash并执行以下命令:

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

下载完成后,会在项目themes目录下生成next文件夹。

image-20240724154529500

如果没有修改代码的需求可以直接通过npm来安装。

npm install hexo-theme-next

2.2 切换主题

与所有 Hexo 主题启用的模式一样。当 克隆/下载 完成后,打开 站点配置文件, 找到 theme 字段,并将其值更改为 next

theme: next

到此,NexT 主题安装完成。

2.3 验证主题

启动服务并访问http://localhost:4000查看效果.

hexo clean && hexo s

image-20240724154906095

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-zero
  license: by-nc-sa
  # 可用值:big | small
  size: small
  sidebar: false
  post: false
  # 如果您希望使用知识共享许可协议的翻译版本,可以设置一个语言值,例如 deed.zh
  # 知识共享许可协议提供 39 种语言版本,您可以在 https://creativecommons.org 上找到您需要的特定和正确的缩写
  language:

# 开放图谱设置
# 参见:https://hexo.io/docs/helpers#open-graph
open_graph:
  enable: true
  options:
    #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: true
  badges: false

# ---------------------------------------------------------------
# 侧边栏设置
# 参见:https://theme-next.js.org/docs/theme-settings/sidebar
# ---------------------------------------------------------------

sidebar:
  # 侧边栏位置。可用值:left | right
  position: 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-skype

social_icons:
  enable: true
  icons_only: false
  transition: false

# 友情链接设置
links_settings:
  icon: fa fa-globe
  # 可用值:block | inline
  layout: block

links:
  #标题: 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: false

footer:
  # 指定网站建立的年份。如果没有定义,将使用当前年份。
  #since: 2021

  # 年份和版权信息之间的图标。
  icon:
    # Font Awesome 中的图标名称。参见:https://fontawesome.com/icons
    name: 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.cn
  beian:
    enable: false
    icp:
    # 公安备案编号中的数字。
    gongan_id:
    # 完整的公安备案编号。
    gongan_num:
    # 公安备案图标的 URL。登录并参见:https://beian.mps.gov.cn/web/business/businessHome/website
    gongan_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: true
  created_at: true
  updated_at:
    enable: true
    another_day: true
  categories: true

# 文章字数统计显示设置
# 依赖项:https://github.com/next-theme/hexo-word-counter
symbols_count_time:
  separated_meta: true
  item_text_total: false

# 使用图标代替符号 # 来标示文章底部的标签
tag_icon: false

# 捐赠(赞助)设置
# front-matter 变量(不支持动画)。
reward_settings:
  # 如果为 true,则默认在每篇文章中显示捐赠按钮。
  enable: false
  animation: false

reward:
  #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: false
  icon: fa fa-signs-post

# 文章编辑
# 轻松浏览和在线编辑博客源代码。
post_edit:
  enable: false
  url: 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 # 最小字体大小,单位 px
  max: 30 # 最大字体大小,单位 px
  amount: 200 # 标签总数
  orderby: name # 标签排序方式
  order: 1 # 排序顺序

# Google 日历
# 通过日历页面与他人分享您的近期日程。
calendar:
  calendar_id: <required> # 您的 Google 账户邮箱
  api_key: <required>
  orderBy: startTime
  showLocation: false
  offsetMax: 72 # 时间范围
  offsetMin: 4 # 时间范围
  showDeleted: false
  singleEvents: true
  maxResults: 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-parent
  desktop: justify
  mobile: justify

# 在宽度较窄的设备上减少填充/边距缩进。
mobile_layout_economy: false

# 浏览器头部面板颜色。
theme_color:
  light: "#222"
  dark: "#222"

# 覆盖浏览器的默认行为。
body_scrollbar:
  # 将滚动条置于内容上方。
  overlay: false
  # 即使内容没有溢出,也要显示滚动条。
  stable: false

codeblock:
  # 代码高亮主题
  # 所有可用主题:https://theme-next.js.org/highlight/
  theme:
    light: default
    dark: stackoverflow-dark
  prism:
    light: prism
    dark: prism-dark
  # 在代码块上添加复制按钮
  copy_button:
    enable: false
    # 可用值:default | flat | mac
    style:
  # 折叠代码块
  fold:
    enable: false
    height: 500

back2top:
  enable: true
  # 侧边栏中的返回顶部
  sidebar: false
  # b2t 按钮中的滚动百分比标签
  scrollpercent: false

# 阅读进度条
reading_progress:
  enable: false
  # 可用值:left | right
  start_at: left
  # 可用值:top | bottom
  position: top
  reversed: false
  color: "#37c6c0"
  height: 3px

# 书签支持
bookmark:
  enable: false
  # 自定义书签的颜色。
  color: "#222"
  # 如果是自动,关闭页面或点击书签图标时将保存阅读进度。
  # 如果是手动,只有点击书签图标时才保存。
  save: auto

# 右上角的“在 GitHub 上关注我”横幅。
github_banner:
  enable: false
  permalink: 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: true
    family: Lato
    size:

  # 网站标题 (.site-title) 的字体设置。
  title:
    external: true
    family:
    size:

  # 标题 (<h1> 到 <h6>) 的字体设置。
  headings:
    external: true
    family:
    size:

  # 文章 (.post-body) 的字体设置。
  posts:
    external: true
    family:

  # `<code>` 和代码块的字体设置。
  codes:
    external: true
    family:

# ---------------------------------------------------------------
# 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: simple
  icons: false
  # 现代和平面风格背景颜色的偏移量(现代:-12 | 12; 平面:-18 | 6)。
  # 偏移量也应用于标签变量。此选项可以与禁用的笔记标签一起使用。
  light_bg_offset: 0

# 标签页
tabs:
  # 使具有长内容的标签页导航栏粘在顶部。
  sticky: false
  transition:
    tabs: false
    labels: true

# PDF 标签
pdf:
  enable: false
  # 默认高度
  height: 500px

# Mermaid 标签
mermaid:
  enable: false
  # 可用主题:default | dark | forest | neutral
  theme:
    light: default
    dark: 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: false

  mathjax:
    enable: false
    # 可用值:none | ams | all
    tags: none

  katex:
    enable: false
    # 参见:https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
    copy_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: false
  archive: false
  # 默认(true)将在加载事件触发后初始化 quicklink。
  delay: true
  # 通过毫秒自定义浏览器执行预加载的时间。
  timeout: 3000
  # 默认(true)将尝试使用 fetch() API(如果支持的话,而不是 link[rel=prefetch])。
  priority: true

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

# 使用 Animate.css 使一切动起来。
# 更多信息:https://animate.style
motion:
  enable: true
  async: false
  transition:
    # 所有可用的过渡变体:https://theme-next.js.org/animate/
    menu_item: fadeInDown
    post_block: fadeIn
    post_header: fadeInDown
    post_body: fadeInDown
    coll_header: fadeInLeft
    # 仅适用于 Pisces | Gemini。
    sidebar: fadeInUp

# 页面加载期间顶部的进度条。
# 更多信息:https://github.com/CodeByZach/pace
pace:
  enable: false
  # 所有可用颜色:
  # black | blue | green | orange | pink | purple | red | silver | white | yellow
  color: 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 | minimal
  theme: minimal

# 使用 HTML5 canvas 在您的网站上生成一个彩带。
# 更多信息:https://github.com/hustcc/ribbon.js
canvas_ribbon:
  enable: false
  size: 300 # 彩带的宽度
  alpha: 0.6 # 彩带的透明度
  zIndex: -1 # 彩带的显示级别

# ---------------------------------------------------------------
# 评论设置
# 参见:https://theme-next.js.org/docs/third-party-services/comments
# ---------------------------------------------------------------

# 多评论系统支持
comments:
  # 可用值:tabs | buttons
  style: tabs
  # 选择默认显示的评论系统。
  # 可用值:disqus | disqusjs | changyan | livere | gitalk | utterances
  active:
  # 设置 `true` 表示记住访问者选择的评论系统。
  storage: true
  # 延迟加载所有评论系统。
  lazyload: false
  # 修改任何 naves 的文本或顺序,这里有一些示例。
  nav:
    #disqus:
    #  text: Load Disqus
    #  order: -1
    #gitalk:
    #  order: -2

# Disqus
# 更多信息:https://disqus.com
disqus:
  enable: false
  shortname:
  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: false
  appid:
  appkey:
  # 显示评论数量
  count: true

# LiveRe 评论系统
# 您可以从 https://livere.com/insight/myCode (普通网站)获取您的 uid
livere_uid:

# Gitalk
# 更多信息:https://gitalk.github.io
gitalk:
  enable: false
  github_id: # GitHub 仓库所有者
  repo: # 存储问题的仓库名称
  client_id: # GitHub 应用程序客户端 ID
  client_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-TW
  language:

# Utterances
# 更多信息:https://utteranc.es
utterances:
  enable: false
  repo: user-name/repo-name # Github 仓库所有者和名称
  # 可用值:pathname | url | title | og:title
  issue_term: pathname
  # 可用值:github-light | github-dark | preferred-color-scheme | github-dark-orange | icy-dark | dark-blue | photon-dark | boxy-light
  theme: 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: false
  buttons:
    - 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/ga4
  measure_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: false
  server_url: # https://www.example.com/
  site_id: # <your site id>

# Umami Analytics
# 参见:https://umami.is/
umami:
  enable: false
  script_url: # https://umami.example.com/script.js
  website_id: # <your website id>
  host_url: # <your umami site url>

# Plausible Analytics
# 参见:https://plausible.io/
plausible:
  enable: false
  script_url: # https://plausible.io/js/script.js
  site_domain: # www.example.com

# 显示每篇文章的访问者数量。
# 您可以访问 https://www.leancloud.cn 来获取 AppID 和 AppKey。
leancloud_visitors:
  enable: false
  app_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: false
  collection: articles # 需要的字符串集合名称,用于访问 firestore 数据库
  apiKey: # 需要
  projectId: # 需要

# 使用 busuanzi 显示网站/页面的浏览量/访客。
# 更多信息:http://ibruce.info/2015/04/04/busuanzi/
busuanzi_count:
  enable: false
  total_visitors: true
  total_visitors_icon: fa fa-user
  total_views: true
  total_views_icon: fa fa-eye
  post_views: true
  post_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: false
  hits:
    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: false
  icon: fa fa-comment # Font Awesome 中的图标名称,设置为 `false` 禁用图标。
  
# Chatra 是一个功能性的、易于使用的适用于网站的聊天软件。
# 更多信息:https://chatra.com
# 控制面板:https://app.chatra.io/settings/general
chatra:
  enable: false
  async: true
  id: # 访问控制面板以获取您的 ChatraID
  #embed: # 开发人员专用的未完成实验性功能。参见:https://chatra.com/help/api/#injectto

# Tidio 是一个功能强大的、一站式的客户服务工具。
# 更多信息:https://www.tidio.com
# 控制面板:https://www.tidio.com/panel/dashboard
tidio:
  enable: false
  key: # 公开密钥,从控制面板获取。参见: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主题自带了许多语言。

image-20240724163905617

编辑**站点配置文件**,修改语言设置。

language: zh-CN

image-20240723183636553

3.3 选择 Scheme

Scheme 是 NexT 提供的一种特性,借助于 Scheme,NexT 为你提供多种不同的外观。同时,几乎所有的配置都可以 在 Scheme 之间共用。目前 NexT 支持四种 Scheme:

  • Muse - 默认 Scheme,这是 NexT 最初的版本,黑白主调,大量留白
  • Mist - Muse 的紧凑版本,整洁有序的单栏外观
  • Pisces - 双栏 Scheme,小家碧玉似的清新
  • Gemini - 新增的主题(还没发现具体差别)

Scheme 的切换通过更改 主题配置文件,搜索 scheme 关键字,将你需用启用的 scheme 前面注释 # 去除即可。

3.4 设置导航菜单

效果图:

image-20240724195105831

NexT菜单配置包括三个部分,第一是菜单项(名称和链接),第二是菜单项的显示文本,第三是菜单项对应的图标。NexT 使用的是 Font Awesome 提供的图标, Font Awesome 提供了 600+ 的图标,可以满足绝大的多数的场景,同时无须担心在 Retina 屏幕下 图标模糊的问题。

编辑 themes/next/_config.yml,修改以下内容:

  1. 设定菜单内容,对应的字段是 menu。菜单内容的设置格式是:item name: link。其中 item name 是一个名称,这个名称并不直接显示在页面上,它将用于匹配图标以及翻译。

    # 使用:`键: /链接/ || 图标`
    # 键是菜单项的名称。如果此项目有可用的翻译,将加载翻译后的文本,否则将使用键名称。键是区分大小写的。
    # 值在 `||` 分隔符之前是目标链接,值在 `||` 分隔符之后是 Font Awesome 图标名称。
    # 外部 URL 应该以 http:// 或 https:// 开头
    menu:
      home: / || fa fa-home
      gift: /gift/ || fa fa-gift
      hotel: /hotel/ || fa fa-hotel
      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
    

NexT 默认的菜单项有(标注 ! 的项表示需要手动创建这个页面):

键值设定值显示文本(简体中文)
homehome: /主页
archivesarchives: /archives归档页
categoriescategories: /categories分类页 !
tagstags: /tags标签页 !
aboutabout: /about关于页面 !
commonwealcommonweal: /404.html公益 404 !
  1. 设置菜单项的显示文本。在上一步中设置的菜单的名称并不直接用于界面上的展示。

    Hexo 在生成的时候将使用 这个名称查找对应的语言翻译,并提取显示文本。这些翻译文本放置在 NexT 主题目录下的 languages/{language}.yml{language} 为你所使用的语言)。

    以简体中文为例,若你需要添加一个菜单项,比如 something。那么就需要修改简体中文对应的翻译文件 languages/zh-CN.yml,在 menu 字段下添加一项:

    menu:
      home: 首页
      archives: 归档
      categories: 分类
      tags: 标签
      about: 关于
      search: 搜索
      schedule: 日程表
      sitemap: 站点地图
      commonweal: 公益 404
      gift: 礼品
      hotel: 酒店
    

    image-20240724194556168

    请注意键值(如 home)的大小写要严格匹配。

  2. 设定菜单项的图标。enable 可用于控制是否显示图标,你可以设置成 false 来去掉图标。

    # 启用/禁用菜单图标/项目徽章。
    menu_settings:
      icons: false
      badges: false
    

3.5 设置侧边栏

效果图:

image-20240724200031271

默认情况下,侧栏仅在文章页面(拥有目录列表)时才显示,并放置于左侧位置。

可以通过修改 主题配置文件 中的 sidebar 字段来控制侧栏的行为。侧栏的设置包括两个部分,其一是侧栏的位置, 其二是侧栏显示的时机。

  1. 设置侧栏的位置,修改 sidebar.position 的值,支持的选项有:
  • left - 靠左放置
  • right - 靠右放置

编辑 themes/next/_config.yml,修改以下内容:

sidebar:
  # 侧边栏位置。可用值:left | right
  position: left
  1. 设置侧栏显示的时机,修改 sidebar.display 的值,支持的选项有:
  • post - 默认行为,在文章页面(拥有目录列表)时显示
  • always - 在所有页面中都显示
  • hide - 在所有页面中都隐藏(可以手动展开)
  • remove - 完全移除
sidebar:
  display: always

3.6 设置头像

效果图:

image-20240724200654207

编辑 主题配置文件, 修改字段 avatar, 值设置成头像的链接地址。其中,头像的链接地址可以是:

  • 完整的互联网 URI,如:http://example.com/avatar.png
  • 站点内的地址,主题或站点的source目录下。注意:是站点根目录的source文件夹里。
avatar:
  # 替换默认图片并在这里设置 URL。
  url: /images/next_icon.png

3.7 侧边栏社交链接

效果图:

image-20240724234551254

  1. 链接放置在 social 属性下,一行一个链接。其键值格式是 显示文本: 链接地址 || 图标。

    # 社交链接
    # 使用:`键: 永久链接 || 图标`
    # 键是最终用户看到的链接标签。
    # 值在 `||` 分隔符之前是目标永久链接,值在 `||` 分隔符之后是 Font Awesome 图标名称。
    social:
      微信: https://github.com/yourname || fab fa-weixin
      GitHub: https://github.com/yourname || fab fa-github
      E-Mail: mailto:yourname@gmail.com || fa fa-envelope
      微博: 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-skype
    
  2. 设定链接的图标,对应的字段是 social_icons。

    其键值格式是 匹配键: Font Awesome 图标名称, 匹配键 与上一步所配置的链接的 显示文本 相同(大小写严格匹配),图标名称 是 Font Awesome 图标的名字。enable 选项用于控制是否显示图标,你可以设置成 false 来去掉图标。

    social_icons:
      enable: true
      icons_only: false
      transition: false
    

    可以在https://github.com/FortAwesome查询 Font Awesome的图标。

3.8 设置友情链接

效果图:

image-20240724235134218

编辑 主题配置文件 ,配置如下:

links:
  #标题: https://example.com
  0ks: https://0ks.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

image-20240724235647320

3.10 订阅微信公众号

效果图:

image-20240725000032828

在每篇文章的末尾显示微信公众号二维码,扫一扫,轻松订阅博客。

在微信公众号平台下载您的二维码,并将它存放于主题 source/images/ 目录下。

然后编辑 主题配置文件,配置如下:

follow_me:
  Twitter: https://twitter.com/username || fab fa-twitter
  Telegram: https://t.me/channel_name || fab fa-telegram
  WeChat: /images/next_icon.png || fab fa-weixin
  RSS: /atom.xml || fa fa-rss

3.11 设置阅读全文

效果图:

image-20240725000255611

在首页显示一篇文章的部分内容,并提供一个链接跳转到全文页面是一个常见的需求。在首页显示文章的摘录并显示 阅读全文 按钮,可以通过以下方法:

  • 在文章中使用 <!-- more --> 手动进行截断,Hexo 提供的方式 推荐
  • 在文章的 front-matter 中添加 description,并提供文章摘录

建议使用 <!-- more -->(即第一种方式),除了可以精确控制需要显示的摘录内容以外, 这种方式也可以让 Hexo 中的插件更好的识别。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2091036.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

Mysql基础练习题 584.寻找用户推荐人 (力扣)

找出那些 没有被 id 2 的客户 推荐 的客户的姓名。 建表插入数据&#xff1a; Create table If Not Exists Customer (id int, name varchar(25), referee_id int) Truncate table Customer insert into Customer (id, name, referee_id) values (1, Will, None) insert int…

大模型技术如何重塑物流供应链

一、大模型技术与物流供应链的融合现状 在物流供应链领域&#xff0c;大模型技术正逐渐崭露头角&#xff0c;并在各个环节实现了初步渗透。在需求预测环节&#xff0c;大模型凭借其强大的数据处理和分析能力&#xff0c;能够整合多种复杂的数据源&#xff0c;如历史销售数据、…

Unet改进14:添加SEAttention||减少冗余计算和同时存储访问

本文内容:在不同位置添加SEAttention注意力机制 目录 论文简介 1.步骤一 2.步骤二 3.步骤三 4.步骤四 论文简介 卷积算子是卷积神经网络(cnn)的核心组成部分,它使网络能够通过融合每层局部接受域内的空间和通道信息来构建信息特征。之前的广泛研究已经调查了这种关系的…

主流AI绘画工具-StableDiffusion本地部署方法(mac电脑版本)

Stable Diffusion是一款强大的AI生成图像模型&#xff0c;它可以基于文本描述生成高质量的图像。对于想要在本地运行此模型的用户来说&#xff0c;使用Mac电脑部署Stable Diffusion是一个非常吸引人的选择&#xff0c;特别是对于M1或M2芯片的用户。本文将详细介绍如何在Mac上本…

零基础入门天池镜像提交--windows场景VirtualBox虚拟机安装linux系统并ssh远程登录,直至镜像的制作及提交

背景&#xff1a;由于本人只有一台windows,天池上的比赛需要提交镜像&#xff0c;自己试了好多方法给windows安装linux&#xff0c;但是始终没安装成功。最终采用在利用VirtualBox安装linux虚拟机&#xff0c;使用MobaXterm进行ssh登陆linux&#xff0c;镜像的制作、push、提交…

单片机-初识单片机(keil安装以及编写简单驱动)(一)

目录 一、嵌入式介绍 1.嵌入式系统&#xff1a; 2.嵌入式操作系统 3.单片机&#xff1a; 二、STM32F103ZET6简介 1.单片机的组成&#xff1a; 2.单片机外观&#xff1a; 3.ARM公司 4.ST公司--意法半导体 三、资料部分 1.安装工具&#xff1a; 2.破解软件&#xff1…

【学习笔记之vue】const fileFilter = options?.fileFilter || (() => true);

运行vue3时出现下面这个问题&#xff0c;大概就是不能识别出es6的格式 ERROR SyntaxError: Unexpected token . F:\front\node_modules\unimport\dist\shared\unimport.af6409e3.cjs:976const fileFilter options?.fileFilter || (() > true);检查了一下现node版本是12版…

Self-study Python Fish-C Note19 P62to63

类和对象 (part 2) 本节主要介绍 类和对象的构造函数、重写、钻石继承、Mixin及案例源码剖析&#xff08;原视频P62-63)\ 构造函数 之前我们在函数章节里说&#xff0c;函数是可以通过参数来进行个性化定制的。类在实例化的时候其实也是支持个性化定制对象的。 定义类的时候…

Vue.js入门系列(十八):利用浏览器本地存储实现TodoList数据持久化

个人名片 &#x1f393;作者简介&#xff1a;java领域优质创作者 &#x1f310;个人主页&#xff1a;码农阿豪 &#x1f4de;工作室&#xff1a;新空间代码工作室&#xff08;提供各种软件服务&#xff09; &#x1f48c;个人邮箱&#xff1a;[2435024119qq.com] &#x1f4f1…

基于Python的机器学习系列(17):梯度提升回归(Gradient Boosting Regression)

简介 梯度提升&#xff08;Gradient Boosting&#xff09;是一种强大的集成学习方法&#xff0c;类似于AdaBoost&#xff0c;但与其不同的是&#xff0c;梯度提升通过在每一步添加新的预测器来减少前一步预测器的残差。这种方法通过逐步改进模型&#xff0c;能够有效提高预测准…

欧洲游戏市场的文化和语言特征

欧洲游戏市场是一个由无数文化和语言特征塑造的丰富多样的景观。作为世界上最大、最多样化的游戏地区之一&#xff0c;欧洲为旨在创造与广大受众产生共鸣的内容的开发者带来了独特的挑战和机遇。 欧洲市场最引人注目的方面之一是语言的多样性。欧盟有24种官方语言和众多地区方…

开源软件指南

目录 什么是开源软件 开源软件的历史和哲学 什么是开源许可证 开源许可证的类型 ​编辑 开源合规性 版权和知识产权合规性 安全合规性 什么是开源软件政策 开源软件安全 库存和软件物料清单(SBOM) 依赖项更新 开源漏洞扫描 二进制存储库管理器 开源软件的当前趋势…

C#语言实现最小二乘法算法

最小二乘法&#xff08;Least Squares Method&#xff09;是一种常用的拟合方法&#xff0c;用于在数据点之间找到最佳的直线&#xff08;或其他函数&#xff09;拟合。以下是一个用C#实现简单线性回归&#xff08;即一元最小二乘法&#xff09;的示例代码。 1. 最小二乘法简介…

【kubernetes】金丝雀部署

概念&#xff1a; 金丝雀发布&#xff08;又称灰度发布、灰度更新&#xff09;&#xff1a;金丝雀发布一般先发1台&#xff0c;或者一个小比例&#xff0c;例如2%的服务器&#xff0c;主要做流量验证用&#xff0c;也称为金丝雀 (Canary) 测试 &#xff08;国内常称灰度测试&a…

一文读懂Linux用户密码管理

目录 前言1. 基本知识2. 命令行 前言 作为全栈人员&#xff0c;对于Linux的账号密码管理也要熟知 下述文章直奔主题&#xff0c;直接讲解知识点 1. 基本知识 修改密码、查看密码哈希值、管理密码到期时间等 用户的密码和相关信息主要存储在两个文件中&#xff1a; /etc/pa…

随笔九、SARADC按键程控测试

目录 1. 泰山派环境 2. 按键3分析 3. 编程测试 1. 泰山派环境 泰山派开发板上有3个按键 按键1是电源按键PWRON&#xff0c;实测按几下会导致开发板重启 按键2是复位按键RESET&#xff0c;按下立马复位重启 按键3是升级按键RECOVER&#xff0c;配合RESET按键可以使开发板进…

现在做项目不看能力!

有人还在执着于能力&#xff0c;但当你多接触一些高手之后&#xff0c;你会发现他们想问题想得很透彻&#xff0c;什么能力&#xff0c;其实不重要。能力是辅助的&#xff0c;在互联网赚钱机会是更重要的&#xff0c;能力不是重点&#xff0c;优先的是执行力。执行力才是第一生…

泛微E9开发 获取浏览按钮的显示值

获取浏览按钮的显示值 1、显示效果2、实现方法3、标准API3.1.获取浏览按钮的显示值3.1.1.格式3.1.2.参数说明3.1.3.案例 3.2. 获取选择框字段的显示值3.2.1.获取选择框字段的显示值3.2.2.格式3.2.3.参数说明3.2.4.案例 1、显示效果 2、实现方法 <script>debugger;var tb…

IO练习:用信号实现司机和售票员问题

【1】问题描述 1&#xff09;售票员捕捉SIGINT&#xff08;代表开车&#xff09;信号&#xff0c;向司机发送SIGUSR1信号&#xff0c;司机打印&#xff08;lets gogogo&#xff09; 2&#xff09;售票员捕捉SIGQUIT&#xff08;代表停车&#xff09;信号&#xff0c;向司机发送…

x-cmd pkg | lazydocker - Docker 和 docker-compose 的 Terminal UI

目录 简介快速上手功能特点竞品和相关项目进一步探索 简介 lazydocker 是由 Jesse Duffield 用 Go 语言开发的 Docker 和 docker-compose 的 Terminal UI 管理工具。它提供 docker 的终端图形界面&#xff0c;支持鼠标操作和键盘快捷键&#xff0c;能实时监控 docker 容器&…