讨论区

[utterances-bot]

一个实用简约主义的 Hexo 主题 - XAOXUU

这是一个全新的内置 wiki 系统的 hexo 主题，拥有简约而精美的视觉设计和丰富的标签插件。

https://xaoxuu.com/wiki/stellar/

[xaoxuu]

Welcome to Stellar!

[Reqwey]

站内搜索吧，没必要，扔了吧

[Reqwey]

倒是暗黑模式开关写一个呗

[xaoxuu]

@linhk1606 博客可以不要，但是 wiki 必须要有搜索

[xaoxuu]

@linhk1606 暗黑模式是通过 front-matter 开启的：

dark: true

[biaoxiaoa]

安装主题，设置为stellar。启动后开打页面 终端中会报错

[xaoxuu]

@biaoxiaoa 需要安装一个插件：

npm i hexo-related-popular-posts

[lovedva]

我不安这个反而不会出错。。。救命啊

[biaoxiaoa]

我配置了两条，但显示了3条。怎样把第一条删除。求指导！谢谢！

[xaoxuu]

这个可能是和默认的合并了，你可以先不使用 welcome 改一下名字，我晚点有时间修复一下。

[biaoxiaoa]

关于welcome的问题，我尝试了下不配置，会显示默认的内容。怎样关闭welcome这个功能。


我设置了1个menu，但是运行起来后显示2个。

[xaoxuu]

@biaoxiaoa 实测这样可以：

隐藏默认的菜单按钮：

sidebar:
  menu:
    post: '[btn.blog](/)'
    wiki: ''

隐藏welcome：

welcome:
  layout: markdown
  title: ''
  content: []

效果图：

这个问题已经提了bug，将在下个版本进行修复： #4

[MCSeekeri]

Algolia出过一个专门针对wiki的搜索服务,也许可以兼容这个...
https://docsearch.algolia.com/
虽然需要申请但很快就能通过,应该没什么问题...

[biaoxiaoa]

评论功能怎么关闭

[xaoxuu]

@biaoxiaoa 什么评论都不选就是关闭的：

hexo-theme-stellar/_config.yml

Line 70 in 97005fa

service: # utterances, valine

[xaoxuu]

@MCSeekeri 我填 xaoxuu.com 申请过，直接被拒了。填 xaoxuu.com/wiki/ 的话担心即使过了可能搜不到博客内容只能搜到 wiki 目录下的内容，那就不实用了。

[sout123]

---

references:

• '心跳之旅—💗—iOS用手机摄像头检测心率(PPG)'
• 'PPG光电容积脉搏波描记法技术概况'
  ...

---

这种参考资料我使用的时候效果没有文档给出的那种效果，而是普通的markdown链接，位于https://xaoxuu.com/wiki/stellar/pages/里的教程。是否更新了语法？

[thun888]

请提供最小复现仓库

[sout123]

是我配置错了还是你漏了，如果是我配置问题，麻烦能提供一下教程吗？谢谢！

…

---原始邮件--- 发件人: ***@***.***> 发送时间: 2025年9月15日(周一) 晚上7:17 收件人: ***@***.***>; 抄送: ***@***.******@***.***>; 主题: Re: [xaoxuu/hexo-theme-stellar] 讨论区 (Discussion #226) 哈哈配置错了，home没写😭 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***>

[sout123]

https://github.com/sout123/-- 第一次用git

…

---原始邮件--- 发件人: ***@***.***> 发送时间: 2025年9月15日(周一) 晚上7:50 收件人: ***@***.***>; 抄送: ***@***.******@***.***>; 主题: Re: [xaoxuu/hexo-theme-stellar] 讨论区 (Discussion #226) 请提供最小复现仓库 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***>

[thun888]

--- 之间表示这是front-matter字段内容，要写在 front-matter 里才生效，可以参考

front-matter 全部字段索引

其次，git仓库不要用中文名，会变成--的

[YUEXIABUG]

请问一下，我现在想设置顶部 tab 栏，以引入 tab 栏的配置，但在页面中却没有显示。我看文档说在 1.25.0 后重构，请问现在该如何配置？

[GhostFox9102]

我遇到了一个新的问题，我部署好主题后发现点击左侧边栏的logo头像会跳转到about页面，我应该如何去创建这个页面，我hexo new了一个about页面后发现部署后导航不到这个页面

[infinitesum]

hexo new 是用来创建新文章的，而你需要做的是创建一个新的页面，正确的做法是在 _posts 文件夹同级别目录下新建一个 about 文件夹，再新建一个 index.md 文件

[GhostFox9102]

了解了，多谢指教

[gogongxt]

请问下有没有当前站点对应的 config 配置可以参考，自己配很难配出想要的效果。
另外咱们有交流群吗

[fcbyoung]

您好，请问可以在主页添加内置的音乐播放器吗，audio音乐标签好像只能实现在单篇文章内插入网易云音乐歌单的功能

[6am600]

免费实现AI摘要生成，https://bambooo.top/2025/11/24/aisummary/，有需要的朋友可以瞅瞅

[thun888]

可以分享在 探索号 里

[Timor2016]

想问下，目前 GitHub Issues 限制了请求速率，这个需要怎么处理啊

[thun888]

https://github.com/xaoxuu/ghapi-json-generator

[fcbyoung]

麻烦问下各位，我正确加载了stellar组件，网页显示也正常，只是本地目录下找不到_config.stellar.yml这个文件，这个是什么情况

[thun888]

自己新建

具体的看下文档就明白了

[Timor2016]

问下 memos 有支持 0.24 版本的计划吗

[Timor2016]

API 已经不同了，按照 [使用「memos」极简版](https://xaoxuu.com/wiki/stellar/third-party/memos/ 这个文档请求是报错的

[tovarsh]

提供一下你memos公开的接口, 填到timeline.api的值

[Timor2016]

https://mymemos.zeabur.app/ 您可以试一下

[tovarsh]

看了一会儿, zerbur的版本是 latest, 不支持users/1过滤, 也不支持creator==1过滤, 部署时候可以抄zeabur官方的yaml然后image的后缀latest改成neosmemo/memos:stable即可, 不然只支持public过滤. 是api的缺陷,不是主题.

• zeabur-memos-yaml
• memos官方指导

[Timor2016]

好的，非常感谢

[Nu11Cat]

[xaoxuu]

不是的，这里有两个例子： https://xaoxuu.com/wiki/stellar/examples/#%E5%BC%80%E6%BA%90-demo-%E7%A4%BA%E4%BE%8B 还有其他用法可以自己探索

[Nu11Cat]

不是的，这里有两个例子： https://xaoxuu.com/wiki/stellar/examples/#%E5%BC%80%E6%BA%90-demo-%E7%A4%BA%E4%BE%8B 还有其他用法可以自己探索

是这样的，我想要实现类似 [https://lingjun.life/ ] 的效果，即自定义首页，以及把“近期发布”改为/post/路径（差不多就是照搬这个网站的设计），但是首页根目录总是“最近发布”的博客列表，就算我把public的根index.html强制换成另一个“首页”界面的index.html也会在我点击“最近发布”的时候撞车“主页”被覆盖（如 [http://nu11cat.cn/] 的效果），本人实在愚钝，如果指点一二不胜感激

[tovarsh]

我想问一下，只能博客列表作为首页吗？

1. 修改根目录的config.yaml
   目的是将hexo官方的近期发布迁移至一个虚拟的路径, 不必为它新建文件夹, 之前的近期文章列表就到了/lately

index_generator:
  path: lately
  per_page: 10
  order_by: -date

2. 在source下面新建index.md文件
   这一步是自己写首页, 会被hexo主题渲染, 注意format要有permalink: / 以下是参考

---
title: '自定义首页'
menu_id: social
nav_tabs: true # 这就意味着页面会显示首页文章导航栏
breadcrumb: false
permalink: /   # 确保就是根路径（保险起见加上）
---
我是主页啦

3. 修改根目录的config.stellar.yaml
   目的是新增一个导航栏button, 以后熟悉了你可以迁移到左侧的导航栏

# 站点主结构树
site_tree:
  # ...
  index_blog:
    nav_tabs:
      '首页': /

• 已经完成了, 但要注意这个'首页'是在原nav的最后面, 可以去issue提交一个TODO谁有空改改这个文件, 让nav可以改变顺序, 设计代码文件如下 nav_tabs_blog.ejs

• 效果图

[Nu11Cat]

我想问一下，只能博客列表作为首页吗？

1. 修改根目录的config.yaml
   目的是将hexo官方的近期发布迁移至一个虚拟的路径, 不必为它新建文件夹, 之前的近期文章列表就到了/lately

index_generator:
  path: lately
  per_page: 10
  order_by: -date

2. 在source下面新建index.md文件
   这一步是自己写首页, 会被hexo主题渲染, 注意format要有permalink: / 以下是参考

---
title: '自定义首页'
menu_id: social
nav_tabs: true # 这就意味着页面会显示首页文章导航栏
breadcrumb: false
permalink: /   # 确保就是根路径（保险起见加上）
---
我是主页啦

3. 修改根目录的config.stellar.yaml
   目的是新增一个导航栏button, 以后熟悉了你可以迁移到左侧的导航栏

# 站点主结构树
site_tree:
  # ...
  index_blog:
    nav_tabs:
      '首页': /

• 已经完成了, 但要注意这个'首页'是在原nav的最后面, 可以去issue提交一个TODO谁有空改改这个文件, 让nav可以改变顺序, 设计代码文件如下 nav_tabs_blog.ejs
• 效果图

好的，谢谢！

[seramat]

请问我在文章中cover/banner/poster用了同一张图片地址，但是在文章页面顶部没有显示图片，这是什么原因呢？

[seramat]

谢谢回复🙏。我改成这样了，但是文章顶部还是没有显示图片，

[tovarsh]

是正确的, 按你的描述cover有效果, banner的占位高度体现了, 可能是图片CDN原因? 可以具体看看浏览器的日志, 或者都换这个图片地址排除一下 https://origin.picgo.net/2025/10/08/PixPin_2025-10-08_21-20-13b5aa0a187e68e25e.webp

[seramat]

解决了。是我的“_config.stellar.yml” 问题，在楼主github重新下载了。
另外又有个问题，我不小心在“_config.stellar.yml”编辑了这个参数，

canonical:
originalHost: # 主站点域名主机，例如 xaoxuu.com
officialHosts: # 官方主机列表，每行一个，例如 xaoxuu.vercel.app
- localhost

现在打开主页都有“非法警告”，之后参数取消了，主页还是有这个警告信息，怎么去掉啊？

[tovarsh]

canonical:
  originalHost: blog.thatcoder.cn
  officialHosts:
    - en.blog.thatcoder.cn

originalHost写你的主站， officialHosts写备用站，注意格式

[seramat]

好的，谢谢。

[seramat]

还有一个问题，我这个tianliGPT 的AI摘要为什么是英文？哪里设置呢？

[YaHeii]

当我开启hexo-related-popular-posts，并使用related防在侧边栏时，报错：The "path" argument must be of type string. Received null
at Object.join (node:path:528:7)等等
使用AI分析：这个插件比较老旧（看你的 npm warn 就知道有很多废弃依赖），它在计算“相关文章”时，如果找不到缓存路径或者图片的路径配置，就会传递 null 给 Node.js 的 path.join 函数，从而导致崩溃。
请问应该如何解决

[SeqCrafter]

可能是没开评论的原因，你打开评论功能再试试

[YaHeii]

请问您指的是评论插件配置么，我已经开启了beaudar评论插件，但是情况没有被改善

[xaoxuu]

执行一下 hexo cl 然后再看看报错不？这个插件我记得修改了内容之后都得 clean 一下再重新运行

[SeqCrafter]

执行一下 hexo cl 然后再看看报错不？这个插件我记得修改了内容之后都得 clean 一下再重新运行

我发现我的报错是这个,是因为我的 node-25.2.1 版本太高了吗

FATAL 
TypeError: Cannot read properties of undefined (reading 'prototype')
    at Object.<anonymous> (/Users/panxiaoguang/Documents/hexo-blog/XiaoHanys/node_modules/buffer-equal-constant-time/index.js:37:35)
    at Module._compile (node:internal/modules/cjs/loader:1760:14)
    at Object..js (node:internal/modules/cjs/loader:1892:10)
    at Module.load (node:internal/modules/cjs/loader:1480:32)
    at Module._load (node:internal/modules/cjs/loader:1299:12)
    at TracingChannel.traceSync (node:diagnostics_channel:328:14)
    at wrapModuleLoad (node:internal/modules/cjs/loader:245:24)
    at Module.require (node:internal/modules/cjs/loader:1503:12)
    at require (node:internal/modules/helpers:152:16)
    at Object.<anonymous> (/Users/panxiaoguang/Documents/hexo-blog/XiaoHanys/node_modules/jwa/index.js:1:21)
    at Module._compile (node:internal/modules/cjs/loader:1760:14)
    at Object..js (node:internal/modules/cjs/loader:1892:10)
    at Module.load (node:internal/modules/cjs/loader:1480:32)
    at Module._load (node:internal/modules/cjs/loader:1299:12)
    at TracingChannel.traceSync (node:diagnostics_channel:328:14)
    at wrapModuleLoad (node:internal/modules/cjs/loader:245:24)
    at Module.require (node:internal/modules/cjs/loader:1503:12)
    at require (node:internal/modules/helpers:152:16)
    at Object.<anonymous> (/Users/panxiaoguang/Documents/hexo-blog/XiaoHanys/node_modules/jws/lib/sign-stream.js:4:13)
    at Module._compile (node:internal/modules/cjs/loader:1760:14)
    at Object..js (node:internal/modules/cjs/loader:1892:10)
    at Module.load (node:internal/modules/cjs/loader:1480:32)

[YaHeii]

的确，使用hexo cl -> hexo g 重新加载一下就好了