执行摘要
在 docs_new/docs.json 中新增 "canonical": "https://docs.sglang.io" 配置,解决 Google 搜索结果误指向 lmsysorg.mintlify.app 的 SEO 问题。改动极小,无运行时风险。
功能与动机
Mintlify 托管文档时同时提供 lmsysorg.mintlify.app 和 docs.sglang.io 两个域名。由于没有设置 canonical 标签,Google 将旧子域名选为首要索引地址,导致用户搜索 "SGLang documentation" 时看到的是 mintlify 域名而非官方域名,影响品牌统一和流量归因。
实现拆解
- 定位配置:
docs_new/docs.json 中的 seo.metatags 块。
- 追加键值:在原有
google-site-verification 之后添加 "canonical": "https://docs.sglang.io"(注意保留逗号分隔)。
- 构建生效:Mintlify 在生成 HTML 时会根据该配置自动插入
<link rel="canonical" href="https://docs.sglang.io">,指导搜索引擎将权重归一到 docs.sglang.io。
docs_new/docs.json
唯一变更文件,在 SEO metatags 中添加 canonical URL 配置,修正 Google 索引。
{
"$schema": "https://mintlify.com/docs.json",
"theme": "aspen",
"name": "SGLang Documentation",
"seo": {
"metatags": {
"google-site-verification": "bX3ofyYQhraIpAYf4DpyZQXZO_G4xLR_RqeBAKnJA7g",
"canonical": "https://docs.sglang.io" // 新增:指定权威域名,解决 Google 索引指向 mintlify 子域名的问题
}
},
// ... redirects 等其他配置保持不变
}
评论区精华
无 reviewer 讨论。
风险与影响
- 风险:极低。仅修改文档配置 JSON 文件,不影响任何运行时逻辑或 API 行为。错误的 canonical URL 可能导致 SEO 无效,但 CI 可验证。
- 影响:正面。Google 搜索结果将统一指向
docs.sglang.io,提升品牌一致性;不影响现有文档内容或功能。
关联脉络
无关联 PR 或 Issue。这是一个独立的 SEO 修复,属于文档配置的常规优化。
参与讨论