讨论区

[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 目录下的内容，那就不实用了。

[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 版本的计划吗

[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]

好的，非常感谢

[cuiruileo]

memos 更新了 api 接口，参考 API文档，对应调整：

- api:https://memos.xaox.cc/api/v1/memo?creatorId=1&limit=10
+ api:https://memos.xaox.cc/api/v1/memos?pageSize=10&filter=creator_id==1

[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 重新加载一下就好了

[Ash-Cpp]

latex加载好慢，要刷新才能加载，是我的网络问题还是就是Bug嘞

[xaoxuu]

你开启了pjax吗？有可能是bug

[Ash-Cpp]

开了的，叫AI改完，latex能加载但是页面又会卡了，

[Ash-Cpp]

可能是mathjax版本问题

[binghai-euler]

我有遇到类似的情况，我基本确定的就是我使用的 mathjax 那个 cdn 在国内加载速度或者连通性有问题。

我没有更新到支持 pjax 的那个版本（我的版本 1.33.1），我在国内的时候打开我的网站发现里面的公式加载很慢甚至加载不出来，调试模式下可以看到 mathajx.js 加载时间很长，但是我回到欧洲后，这个打开就没任何问题了，无论速度还是显示。

所以也许你可以试试本地化一下 mathjax.js

[ThisisXXZ]

想问问文章里面 markdown 表格不居中怎么解决

[xaoxuu]

放到居中的 tabs 组件里面：

{% tabs align:center %}

<!-- tab 效果 -->

| title1 | title2 |
| :-- | :-- |
| text1 | text2 |

{% endtabs %}

[ThisisXXZ]

感谢感谢！

[V-Conet]

mermaid图表无法渲染，本博客样例也无法渲染

[xaoxuu]

新版的bug，你先用1.33.1

[lz732895965]

夜间深色模式的底色太黑了，可以调整为浅灰色吗，或者在哪里可以设置。

[talefou]

大佬，可以请教一下如何像星日语博主一样，在左侧栏中的recent中添加rss功能吗

[talefou]

rss的图标。

还有如何取消页面顶部的

发布于：1 小时前
字数：67 字
时长：1 mins.

这一栏啊，参考说说

[Zzh0513]

求助：Wiki 导航 nav_tabs 配置无效问题

1. 页面文件

路径：./source/wiki/index.md

---
title: 工具箱
layout: wiki
sidebar: true
---

2. 主题配置文件

文件：_config.stellar.yml

# 文档列表页配置
index_wiki:
  base_dir: wiki
  menu_id: wiki
  leftbar: related, recent
  rightbar: toc
  nav_tabs:
    '所有项目': /wiki/

3. 问题

按以上配置后还是不显示 nav_tabs 页面空白且配置不生效，求正确配置方案！。我想要和博主博客中点击项目后一样的显示，这个好看

[geminikowui]

求助：使用hexo-theme-stellar-examples 中的blog模板，发现右边栏不生效
直接下载blog部分代码，然后安装stellar；然后分别修改widgets.yml和_config.stellar.yml，依然不失效
_config.stellar.yml修改点为增加

全局右边栏挂件池定义

widgets:
recent_posts:
layout: list
title: 近期发布
和
site_tree:
home:
sidebar: starter, welcome, recent
rightbar: announcement, recent_posts, tag_cloud
等内容
widgets.yml
重新定义了公告栏