Skip to content

Commit d6dac11

Browse files
committed
docs(yohaku): 说明第三方服务富化由 mx-core enrichment 接管
LinkCard / OG / TMDB / GitHub 等外部内容富化已由 Mix Space Core 后端 enrichment 服务接管,主题侧不再需要 GH_TOKEN / TMDB_API_KEY 等环境变量;凭据统一于后台「第三方服务集成」配置。
1 parent 29f76c1 commit d6dac11

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

content/docs/themes/yohaku/config.mdx

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,30 @@ Yohaku 的配置沿用 Shiro 的配置体系,在 Mix Space 后台「配置与
1111
Yohaku 复用了 `shiro` 这个配置键名,如果你从 Shiro 迁移到 Yohaku,无需更改配置名称。
1212
</Callout>
1313

14+
## 第三方服务集成
15+
16+
LinkCard 解析、Open Graph 抓取,以及 TMDB、GitHub、Bangumi、NeoDB、arXiv、LeetCode、网易云音乐、QQ 音乐等外部内容的富化,全部由 Mix Space Core 后端的 enrichment 服务接管。
17+
18+
<Callout type="info">
19+
主题侧**不再需要**配置 `GH_TOKEN``TMDB_API_KEY` 等环境变量。所有第三方凭据统一在后台「设置 → 第三方服务集成」中维护。
20+
</Callout>
21+
22+
进入后台「设置 → 第三方服务集成」,按主题中实际使用到的链接卡片类型,启用并填入对应凭据:
23+
24+
| Provider | 字段 | 说明 |
25+
| --- | --- | --- |
26+
| GitHub | `token` | 解析仓库、Issue、PR、Discussion、Commit 卡片,规避匿名访问的 rate limit |
27+
| TMDB | `apiKey` | 解析 TMDB 影视链接 |
28+
| Bangumi | `enabled` | 解析 Bangumi 番剧 / 书籍链接 |
29+
| NeoDB | `enabled` | 解析 NeoDB 条目链接 |
30+
| arXiv | `enabled` | 解析 arXiv 论文链接 |
31+
| LeetCode | `enabled` | 解析 LeetCode 题目链接 |
32+
| 网易云音乐 | `enabled` | 解析网易云音乐歌曲 / 歌单链接 |
33+
| QQ 音乐 | `enabled` | 解析 QQ 音乐歌曲 / 歌单链接 |
34+
| Open Graph | `enabled` | 抓取通用网页的 OG 元数据 |
35+
36+
后端完成富化并缓存后,主题端直接读取已结构化的数据进行渲染。
37+
1438
## 页脚信息 (`footer`)
1539

1640
此部分定义页脚的部分信息,主要包括备案、建站年份和页脚导航三部分。

0 commit comments

Comments
 (0)