扩展配置

中控台

yaml

# Console
console:
  enable: false
  recentComment: # Recent comments
    enable: false
    storage: .2 # Cache time 1: 1 day / .5 : half a day
  card:
    tags: true # Tags
    archive: true # Archive

上方图标底部导航栏其它

yaml

information:
    author: true # 是否显示siteicon
    left:
      # Github: https://github.com/efuo || fab fa-github # Name: link || icon
      # Mail: mailto:o@efu.me || fab fa-envelope
    right:
      # Bilibili: https://space.bilibili.com/1329819902 || fab fa-bilibili
      # Douyin: https://v.douyin.com/iJsLc8jt/ || fab fa-tiktok

yaml

# 底部导航栏
# Bottom navigation bar
group: # 从左至右 / From left to right
  导航:
    归档: /archives/
    分类: /categories/
    标签: /tags/
  服务:
    阿里云: https://aliyun.com/
    51la统计: https://v6.51.la/
    百度统计: https://tongji.baidu.com/
  支持:
    打赏记录: /about/
  协议:
    Cookies: /cookies/
    用户协议: /privacy/
    版权协议: /copyright/

yaml

# 底部随机友链
# Random links at the bottom
# tip：此处的友链是随机显示的，不是固定的
# tip: The links here are displayed randomly, not fixed
# warning: 打开前必须先配置links
# warning: links must be configured before opening
randomlink: false
# 隐私助手右侧弹窗，填写路径后开启
# Privacy assistant right pop-up window, fill in the path to open
privacy: # /privacy/
# 版权
# Copyright
license: # /license/
# 页脚右侧链接，例如：ICP备案号、公安备案号等
# Footer right link, such as: ICP filing number, public security filing number, etc.
links:
  # 为了主题能够得到更多的支持，建议保留主题链接
  # In order for the theme to get more support, it is recommended to keep the theme link
  - name: 主题
    url: https://github.com/everfu/hexo-theme-solitude
  - name: 订阅
    url: /atom.xml

忠告建议

希望你能够保留主题链接，我曾今也想过将它内置固定，但这样会觉得不太好，所以我选择了这种方式，还是希望你能保留支持我的工作。

404 页面

自定义 404 页面

yaml

# 404 页面
# 404 page
errorpage:
  # 图片
  # image
  img: https://7.isyangs.cn/1/65eb24f94fcbd-1.gif
  # 文字
  # text
  text: =awa= 页面走丢了
  # 推荐文章列表
  # Recommended article list
  recommendList: true

音乐胶囊

显示在左下角的音乐播放器，根据注解填写对应的歌单 id 和服务商。

yaml

# 音乐胶囊
# capsule music
capsule:
  enable: false
  id: 8407304077 # 歌单id / playlist id
  server: netease # 播放列表的服务商。netease：网易云 / tencent：腾讯 / kugou：酷狗 / xiami：小米 / baidu：百度 : Music service provider. netease: Netease Cloud / tencent: Tencent / kugou: Kugou / xiaomi: Xiaomi / baidu: Baidu
  type: playlist # 播放列表的类型。song：单曲 / playlist：歌单 / album：专辑 / artist：歌手 : Type of playlist. song: Single / playlist: Playlist / album: Album / artist: Singer

注意

QQ 音乐更换了接口，无法播放。

快捷菜单

yaml

keyboard:
  enable: false # 是否开启键盘控制 / Whether to enable keyboard control
  # 键盘控制配置
  # Keyboard control configuration
  list:
  # name: 按键名称
  # name: Key name
  # key: 按键
  # key: Key
  # func: 方法
  # func: Function
  # sco: sco内置方法
  # sco: sco built-in method
  # url: 跳转链接
  # url: Jump link
  #  - name: 关闭快捷键功能
  #    key: K
  #    func: keyboard
  #  - name: 打开中控台
  #    key: A
  #    sco: showConsole
  #  - name: 播放/暂停音乐
  #    key: M
  #    sco: musicToggle
  #  - name: 打开友情链接
  #    key: L
  #    url: /links/

中控台扩展

yaml

# 中控台扩展：最新评论 + 标签 + 文章
console_plus: false

懒加载

开启懒加载后，图片会在进入可视区域后加载，可以减少网页体积，提高网页加载速度。

yaml

# 懒加载
# lazyload
lazyload:
  enable: false
  # 加载中显示图片
  # Loading display image
  placeholder: /img/loading.gif
  # 加载失败显示图片
  # Loading failed display image
  errorimg: /img/error_load.png

加载动画

在页面加载时会显示一个页面覆盖内容，加载完成消失。

yaml

# 加载动画
loading:
  # 全局加载动画
  fullpage: false
  # 顶部加载胶囊
  pace: true

代码高亮

开启代码高亮后，代码块会有对应的语言提示，但是会增加网页体积，如果你不需要这个功能，可以关闭。

yaml

# 代码高亮增强
# Highlight
highlight:
  enable: true
  limit: 200 # Code line limit
  copy: true # Whether to enable the copy button
  expand: true # Whether to expand by default
  theme: mac # default: default / mac : apple terminal
  color: default # default / solidity / dracula

图片灯箱

fancybox 和 mediumZoom 二选一，一定要关闭 fancybox 才能开启 mediumZoom

yaml

# image lightbox
lightbox: true # 是否开启图片灯箱

# fancybox
# https://fancyapps.com/fancybox/
fancybox: true

# mediumZoom
mediumZoom: false

Open graph

开启后，网站会自动添加 Open Graph 标签，用于社交分享。

yaml

# Open Graph
# https://ogp.me/
# https://developers.facebook.com/docs/sharing/webmasters/
Opengraph:
  enable: false
  options:
    # twitter_card:
    # twitter_image:
    # twitter_id:
    # twitter_site:
    # google_plus:
    # fb_admins:
    # fb_app_id:

字数统计

需要安装 hexo-wordcount 插件。

yaml

# 字数统计
# Word count
# warning：开启前需要安装字数统计插件
# warning: You need to install the word count plugin before turning it on
wordcount: false

busuanzi

yaml

# 访问统计
# Access statistics
busuanzi: false

数学公式

主题支持使用 Latex 数学公式当需要使用数学公式时，在文章的 Front-Matter 添加。

安装 hexo-markdown-it 与 @renbaoshuo/markdown-it-katex

bash

npm un hexo-renderer-marked --save
npm i hexo-markdown-it @renbaoshuo/markdown-it-katex

在配置文件配置并启用 katex 插件

打开主题内 katex 配置项

yaml

# Katex
katex:
  enable: false
  per_page: false # Whether to load on each page
  copytex: false # Whether to enable copy formula

站点验证

yaml

# 站点验证
# Site verification
# 仅需要填写验证代码即可，譬如：codeva-KReTIJu5us
# Only need to fill in the verification code, such as: codeva-KReTIJu5us
verify_site:
  # - name: google-site-verification
  #   content: xxxxxx
  # - name: baidu-site-verification
  #   content: xxxxxxx

CSS 前缀

yaml

# CSS 前缀
# CSS prefix
# 有些 CSS 并不是所有浏览器都支持，需要增加对应的前缀才会生效
# Some CSS is not supported by all browsers, and you need to add the corresponding prefix to take effect
# 开启 css_prefix 后，会自动为一些 CSS 增加前缀。（会增加 20%的体积）
# After opening css_prefix, some CSS will be automatically prefixed. (Will increase 20% of the volume)
css_prefix: false

Inject

yaml

# 插入代码到头部 </head> 之前 和 底部 </body> 之前
# Insert code before </head> and before </body>
# 插入额外代码 如：统计，广告等
# Insert additional code such as: statistics, advertising, etc.
extends:
  head: # 在head中插入 / Insert in head
    # - <script src="https://cdn.bootcdn.net/ajax/libs/pace/1.2.4/pace.min.js"></script>
  body: # 在body中插入 / Insert in body

PWA

PWA 全称为 Progressive Web App，中文译为渐进式 Web APP，其目的是通过各种 Web 技术实现与原生 App 相近的用户体验。纵观现有 Web 应用与原生应用的对比差距，如离线缓存、沉浸式体验等等，可以通过已经实现的 Web 技术去弥补这些差距，最终达到与原生应用相近的用户体验效果。

SWPP 官方文档 & 项目地址

安装插件

bash

npm install hexo-swpp swpp-backends --save

开启主题配置

yaml

# PWA
# https://developer.mozilla.org/zh-CN/docs/Web/Progressive_web_apps
# docs: https://solitude.js.org/config/extra#pwa
pwa:
    enable: false
    manifest: /manifest.json # manifest.json 文件路径
    theme_color: "#006a73" # 主题颜色
    mask_icon: /img/pwa/favicon.ico # 遮罩图标
    apple_touch_icon: /img/pwa/favicon.ico # 苹果触摸图标
    bookmark_icon: /img/pwa/favicon.ico # 书签图标
    favicon_32_32: /img/pwa/favicon_32.ico # 32x32图标
    favicon_16_16: /img/pwa/favicon_16.ico # 16x16图标

在项目根目录新建 sw-rules.js 加入以下内容。

提供一个 SWPP 文件

module.exports.config = {
  /** @type {?ServiceWorkerConfig|boolean} */
  serviceWorker: {
    escape: 0,
    cacheName: 'SolitudeCache',
    debug: false,
  },
  register: {
    onsuccess: undefined,
    onerror: () =>
      console.error(
        'Service Worker 注册失败！可能是由于您的浏览器不支持该功能！'
      ),
    builder: (root, framework, pluginConfig) => {
      const { onerror, onsuccess } = pluginConfig.register;
      return `
            <script>
                (() => {
                    const sw = navigator.serviceWorker;
                    const error = ${onerror && onerror.toString()};
                    if (!sw?.register('${new URL(root).pathname}sw.js')
                        ${onsuccess ? `?.then(${onsuccess.toString()})` : ""}
                        ?.catch(error)
                    ) error()
                })()
            </script>`;
    },
  },
  /** @type {?DomConfig|boolean} */
  dom: {
    /** @type {?VoidFunction} */
    onsuccess: () => {
      caches
        .match(location.href)
        .then((res) => {
          if (res)
            res.json().then((json) => {
              utils &&
                utils.snackbarShow(
                  `已刷新缓存，更新为${json.global + '.' + json.local
                  }版本最新内容`,
                  false,
                  2000
                );
            });
          else console.info('未找到缓存');
        })
        .catch((error) => console.error('缓存匹配出错', error));
    },
  },
  /** @type {?VersionJsonConfig|boolean} */
  json: {
    /** @type {number} */
    maxHtml: 15,
    /** @type {number} */
    charLimit: 1024,
    /** @type {string[]} */
    merge: [],
    exclude: {
      /** @type {RegExp[]} */
      localhost: [],
      /** @type {RegExp[]} */
      other: [],
    },
  },
  /** @type {?ExternalMonitorConfig|boolean} */
  external: {
    /** @type {number} */
    timeout: 5000,
    /** 拉取文件时地并发限制 */
    concurrencyLimit: 100,
    /** @type {({head: string, tail: string}|function(string):string[])[]} */
    js: [],
    /** @type {RegExp[]} */
    stable: [
      /^https:\/\/npm\.elemecdn\.com\/[^/@]+\@[^/@]+\/[^/]+\/[^/]+$/,
      /^https:\/\/cdn\.cbd\.int\/[^/@]+\@[^/@]+\/[^/]+\/[^/]+$/,
      /^https:\/\/cdn\.jsdelivr\.net\/npm\/[^/@]+\@[^/@]+\/[^/]+\/[^/]+$/,
    ],
    replacer: (srcUrl) => {
      if (srcUrl.startsWith('https://cdn.jsdelivr.net/npm/')) {
        const pathname = new URL(srcUrl).pathname;
        return [
          srcUrl,
          `https://cdn.cbd.int/${pathname}`,
          `https://npm.elemecdn.com/${pathname}`,
          `https://fastly.jsdelivr.net/npm/${pathname}`,
        ];
      } else {
        return srcUrl;
      }
    },
  },
};

module.exports.cacheRules = {
  simple: {
    clean: true,
    search: false,
    match: (url, $eject) =>
      url.host === $eject.domain && ['/404.html'].includes(url.pathname),
  },
  cdn: {
    clean: true,
    match: (url) =>
      [
        'cdn.cbd.int',
        'lf26-cdn-tos.bytecdntp.com',
        'lf6-cdn-tos.bytecdntp.com',
        'lf3-cdn-tos.bytecdntp.com',
        'lf9-cdn-tos.bytecdntp.com',
        'cdn.staticfile.org',
        'npm.elemecdn.com',
      ].includes(url.host) &&
      url.pathname.match(/\.(js|css|woff2|woff|ttf|cur)$/),
  },
};

module.exports.getSpareUrls = (srcUrl) => {
  if (srcUrl.startsWith('https://npm.elemecdn.com')) {
    return {
      timeout: 3000,
      list: [
        srcUrl,
        `https://fastly.jsdelivr.net/${new URL(srcUrl).pathname}`,
      ],
    };
  }
};

module.exports.ejectValues = (hexo, rules) => {
  return {
    domain: {
      prefix: 'const',
      value: new URL(hexo.config.url).host,
    },
  };
};

module.exports.skipRequest = (request) => request.url.startsWith("https://i0.hdslb.com") ||
  request.url.startsWith('https://meting.qjqq.cn') ||
  request.url.startsWith('https://api.i-meto.com');

根据需求在 source 文件夹下新建 manifest.json 文件并增加内容，以下是示例：

json

{
    "name": "放养平凡",
    "short_name": "BTA",
    "theme_color": "#b00000",
    "background_color": "#b00000dd",
    "description": "世界为你简单",
    "display": "fullscreen",
    "scope": "/",
    "start_url": "/",
    "lang": "zh-CN",
    "id": "/",
    "icons": [
    {
        "src": "pwa/16.ico",
        "sizes": "16x16",
        "type": "image/png",
        "purpose": "any"
    },
    {
        "src": "pwa/16.ico",
        "sizes": "16x16",
        "type": "image/png",
        "purpose": "maskable"
    },
    {
        "src": "pwa/32.ico",
        "sizes": "32x32",
        "type": "image/png",
        "purpose": "any"
    },
    {
        "src": "pwa/32.ico",
        "sizes": "32x32",
        "type": "image/png",
        "purpose": "maskable"
    },
    {
        "src": "pwa/64.ico",
        "sizes": "64x64",
        "type": "image/png",
        "purpose": "any"
    },
    {
        "src": "pwa/64.ico",
        "sizes": "64x64",
        "type": "image/png",
        "purpose": "maskable"
    },
    {
        "src": "pwa/128.ico",
        "sizes": "128x128",
        "type": "image/png",
        "purpose": "any"
    },
    {
        "src": "pwa/128.ico",
        "sizes": "128x128",
        "type": "image/png",
        "purpose": "maskable"
    },
    {
        "src": "pwa/256.ico",
        "sizes": "256x256",
        "type": "image/png",
        "purpose": "any"
    },
    {
        "src": "pwa/256.ico",
        "sizes": "256x256",
        "type": "image/png",
        "purpose": "maskable"
    }
    ],
    "screenshots": [
    {
        "src": "https://assets.btwoa.com/blogbtwoacom.avif",
        "sizes": "1920x1080",
        "type": "image/png",
        "form_factor": "wide",
        "label": "Fullscreen of BTA"
    },
    {
        "src": "https://assets.btwoa.com/darkblogbtwoacom.avif",
        "sizes": "1920x1080",
        "type": "image/png",
        "form_factor": "wide",
        "label": "Fullscreen of BTA"
    }
    ],
    "splash_pages": null
}

CDN

主题资源已经被 cdnjs 收录，所以大家可以放心食用，如果你有自己的 CDN，可以自定义配置。

yaml

# CDN
# Don't modify the following settings unless you know how they work
# 非必要请不要修改
CDN:
  # The CDN provider of internal scripts (主题内 js 的 cdn 配置)
  # option: local.md/jsdelivr/unpkg/cdnjs/custom
  # Dev version can only choose. ( dev版本只能为 local.md )
  internal: local.md
  # The CDN provider of third party scripts (第三方 js 的 cdn 配置)
  # option: jsdelivr/unpkg/cdnjs/custom
  third_party: custom

  # Add version number to url, true or false
  version: true

  # Custom format
  # For example: https://cdn.staticfile.net/${cdnjs_name}/${version}/${min_cdnjs_file}
  custom_format: https://cdn.staticfile.net/${cdnjs_name}/${version}/${min_cdnjs_file}

  option:
    solitude_css: https://cdn2.codesign.qq.com/icons/7pOrz0WXB5ZWJPX/latest/iconfont.css
    # algolia_search:
    # instantsearch:
    # pjax:
    # twikoo:
    # waline_js:
    # waline_css:
    # sharejs:
    # sharejs_css:
    # katex:
    # katex_copytex:
    # lazyload:
    # aplayer_css:
    # aplayer_js:
    # meting_js:
    # pace_js:
    # swiper_css:
    # swiper_js:
    # busuanzi_js:
    # snackbar_js:

扩展配置 ​

中控台 ​

页脚（Footer） ​

404 页面 ​

音乐胶囊 ​

快捷菜单 ​

中控台扩展 ​

懒加载 ​

加载动画 ​

代码高亮 ​

图片灯箱 ​

Open graph ​

字数统计 ​

busuanzi ​

数学公式 ​

站点验证 ​

CSS 前缀 ​

Inject ​

PWA ​

CDN ​

扩展配置

中控台

页脚（Footer）

404 页面

音乐胶囊

快捷菜单

中控台扩展

懒加载

加载动画

代码高亮

图片灯箱

Open graph

字数统计

busuanzi

数学公式

站点验证

CSS 前缀

Inject

PWA

CDN