主题色

支持 HEX & HSL 表示颜色

blog/_config.stellar.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
style:
  ...
  color:
    # 动态颜色（会根据明暗主题重设明度值，只用关心色相和饱和度即可）
    background: 'hsl(212 16% 98%)' # 浅色背景颜色
    block: 'hsl(212 8% 95%)' # 块背景颜色
    code: 'hsl(14 100% 48%)' # 行内代码颜色
    text: 'hsl(0 0% 20%)' # 文本颜色
    # 主题色配置（不会根据明暗动态调整，请设置为通用的颜色）
    theme: 'hsl(192 98% 55%)' # 主题色
    accent: 'hsl(14 100% 57%)' # 强调色
    link: 'hsl(207 90% 54%)' # 超链接颜色
    button: 'hsl(192 98% 55%)' # 按钮颜色
    hover: 'hsl(14 100% 57%)' # 按钮高亮颜色

字体

请注意使用字体的版权问题！

系统字体

blog/_config.stellar.yml
1
2
3
4
5
6
7
8
9
10
11
style:
  font-size:
    root: 16px
    body: .9375rem # 15px
    code: 85% # 14px
    codeblock: 0.8125rem # 13px
  font-family:
    logo: 'system-ui, "Microsoft Yahei", "Segoe UI", -apple-system, Roboto, Ubuntu, "Helvetica Neue", Arial, "WenQuanYi Micro Hei", sans-serif'
    body: 'system-ui, "Microsoft Yahei", "Segoe UI", -apple-system, Roboto, Ubuntu, "Helvetica Neue", Arial, "WenQuanYi Micro Hei", sans-serif'
    code: 'Menlo, Monaco, Consolas, system-ui, "Courier New", monospace, sans-serif'
    codeblock: 'Menlo, Monaco, Consolas, system-ui, "Courier New", monospace, sans-serif'

外部字体

要想引用外部字体，你需要先在 _config.yml 中 inject 引入

举例，引用 Noto Serif SC 在 _config.stellar.yml 中写入

blog/_config.stellar.yml
1
2
3
4
inject:
  head:
    - <link href="https://fonts.googleapis.com/css2?family=Noto+Serif+SC&display=swap" rel="stylesheet">
  script:

并在 _config.stellar.yml 中填写你引入的字体名称

blog/_config.stellar.yml
1
2
3
style:
  font-family:
    body: '"Noto Serif SC", "Microsoft Yahei",..., sans-serif'

选择在线字体：

https://www.googlefonts.cn/https://www.googlefonts.cn/

本地字体

若您想引用本地字体，举例，引用得意黑（SmileySans-Oblique.ttf）这个字体，先将字体放置于 blog/source/font/ 目录下，然后改动一下主题文件

Blog/themes/stellar/source/css/_custom.styl
1
2
3
4
5
@font-face
   font-family: 'Smiley Sans'
   src: url('/font/SmileySans-Oblique.ttf')
   font-weight: normal
   font-style: normal

font-family 是你引入的字体家族名，src 中填写字体文件相对于 source 文件夹的路径

同样，你需要在 _config.stellar.yml 中填写你引入的字体名称（font-family）

blog/_config.stellar.yml
1
2
3
style:
  font-family:
    body: '"Smiley Sans", "Microsoft Yahei",..., sans-serif'

但是我个人并不推荐引用本地字体，相比于英文字体，中文字体囊括了众多的字符，这也无法避免地导致字体文件体积的增加，如果你想使用自己的字体而找不到在线的字体引入链接，可以自行制作字体的 woff2 切片来减少对网页加载速度的影响。

背景图片

此功能在 1.26.4 中支持，可以设置：纯色/渐变色/图片作为背景。未完全适配，慎用！

blog/_config.stellar.yml
1
2
3
4
5
6
style:
  ...
  site:
    background-image: #'url(https://gcore.jsdelivr.net/gh/cdn-x/[email protected]/image/[email protected])'
    blur-px: 100px # 模糊半径
    blur-bg: var(--alpha75) # 模糊颜色

文本对齐方向

blog/_config.stellar.yml
1
2
3
style:
  ...
  text-align: left # justify/left/center/right

代码块复制

blog/_config.stellar.yml
1
2
3
4
5
copycode:
  enable: true
  js: /js/plugins/copycode.js
  default_text: 'Copy' # 按钮显示文字
  success_text: 'Copied' # 复制成功信息

圆角大小

这个功能在 1.18.1 版本后开始支持。

blog/_config.stellar.yml
1
2
3
4
5
6
7
style:
  ...
  border-radius:
    card: 12px # 卡片圆角
    block: 12px # 块圆角
    bar: 6px # 导航栏圆角
    image: 6px # 图片圆角

页面缓入效果

blog/_config.stellar.yml
1
2
3
4
5
6
7
8
# 默认关闭
scrollreveal:
  enable: false
  js: https://gcore.jsdelivr.net/npm/[email protected]/dist/scrollreveal.min.js
  distance: 4px # 执行距离
  duration: 400 # ms # 执行时长
  interval: 100 # ms # 执行间隔（时间）
  scale: 0.1 # 0.1~1 # 执行方式（缩放）

此效果会和图片懒加载插件冲突，导致部分卡片和footer可能加载不出来

图片懒加载

blog/_config.stellar.yml
1
2
3
4
5
# 默认打开
lazyload:
  enable: true # [hexo clean && hexo s] is required after changing this value.
  js: https://gcore.jsdelivr.net/npm/[email protected]/dist/lazyload.min.js
  transition: blur # blur, fade

加载提示

加载动态时间线、动态友链等显示提示

blog/_config.stellar.yml
1
2
3
4
# 默认打开
loading:
  loading: 正在加载
  error: 加载失败，请稍后重试。

渐变色

这个功能在 1.18.2 版本后开始支持。

您可以在 wiki 项目的封面开始按钮处设置渐变色 CSS 代码

blog/_config.stellar.yml
1
2
3
4
5
style:
  ...
  gradient: # https://webgradients.com/
    start: 'linear-gradient(to right, #92fe9d 0%, #00c9ff 50%, #92fe9d 100%)'
    search: 'linear-gradient(to right, #04F3FF, #08FFC6, #DDF730, #FFBD19, #FF1FE0, #C418FF, #04F3FF)'

当然，如果只想设置纯色的话可以直接设置单色，支持 HEX 和 HSL，例如 search: 'hsl(212 16% 98%)'

顶部 tab 栏

这个功能在 1.25.0 版本重构。

blog/_config.stellar.yml
1
2
3
4
site_tree:
  blog:
    nav_tabs: # 近期发布 分类 标签 归档 and ...
      '朋友文章': /friends/rss/ # 这里填写的链接要与对应页面一致，否则可能无法正确高亮

站点地图

页面底部的站点导航，你也可以在 content 中自定义一些文字信息，支持 Markdown 格式。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
footer:
  social:
    # github:
    #   icon: '<img src="https://gcore.jsdelivr.net/gh/cdn-x/[email protected]/social/08a41b181ce68.svg"/>'
    #   url: /
    # music:
    #   icon: '<img src="https://gcore.jsdelivr.net/gh/cdn-x/[email protected]/social/3845874.svg"/>'
    #   url: /
    # unsplash:
    #   icon: '<img src="https://gcore.jsdelivr.net/gh/cdn-x/[email protected]/social/3616429.svg"/>'
    #   url: /
    # comments:
    #   icon: '<img src="https://gcore.jsdelivr.net/gh/cdn-x/[email protected]/social/942ebbf1a4b91.svg"/>'
    #   url: /about/#comments
  sitemap:
    # '博客':
    #   - '[近期](/)'
    #   - '[分类](/categories/)'
    #   - '[标签](/tags/)'
    #   - '[归档](/archives/)'
    # '项目':
    #   - '[开源库](/)'
    # '社交':
    #   - '[友链](/)'
    #   - '[留言板](/)'
    # '更多':
    #   - '[关于本站](/)'
    #   - '[GitHub](/)'
  content: | # 支持 Markdown 格式
    本站由 [{author.name}](/) 使用 [{theme.name} {theme.version}]({theme.tree}) 主题创建。
    本博客所有文章除特别声明外，均采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议，转载请注明出处。
    <span class="jinrishici-sentence"></span>
    <script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script>
  # 主题用户越多，开发者维护和更新的积极性就越高，如果您喜欢本主题，请在适当的位置显示主题信息和仓库链接以表支持。

自定义样式

如果要修改样式，您需要删掉主题的样式文件的 CDN 链接，使用本地文件，然后在 themes/stellar/source/css/_custom.styl 中进行修改。

使用其它 highlight.js 代码高亮主题

Hexo 官方有文档：https://hexo.io/docs/syntax-highlight.html#hljs

Tip: When line_number is set to false, wrap is set to false and hljs is set to true, you can then use highlight.js theme directly in your site.

以 atom-one-dark 主题为例，翻译过来就是 _config.yml 找到 highlight 并修改为：

1
2
3
4
5
6
7
highlight:
  enable: true
  line_number: false
  auto_detect: false
  tab_replace: '    '
  wrap: false
  hljs: true

然后再找到 highlightjs_theme 修改 css 链接：

blog/_config.stellar.yml
1
2
3
style:
  codeblock:
    highlightjs_theme: https://gcore.jsdelivr.net/gh/highlightjs/[email protected]/build/styles/atom-one-dark.min.css

外部文件注入

在主题配置文件中进行修改 inject.head 以在 <head> 标签末尾处注入代码，修改 inject.script 以在 <body> 标签末尾处注入代码。

blog/_config.stellar.yml
1
2
3
4
5
6
7
inject:
  head:
    - <meta name="msapplication-TileColor" content="#2d89ef">
    - <meta name="msapplication-config" content="/assets/favicon/browserconfig.xml">
    - <meta name="theme-color" content="#ffffff">
  script:
    - <script async src="https://gcore.jsdelivr.net/npm/[email protected]/dist/jquery.min.js"></script>

不蒜子统计插件

直接贴到要显示的地方（支持 markdown 的组件）就行：

blog/_config.stellar.yml
1
2
3
4
footer:
  content: |
    <span id="busuanzi_container_site_pv">本站总访问量<span id="busuanzi_value_site_pv"></span>次</span>
    <script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>