Prhub

#24935 :memo: docs: add canonical URL to fix Google indexing lmsysorg.mintlify.app instead of docs.sglang.io

原始 PR 作者 unseenmars 合并时间 2026-05-15 07:46 文件变更 1 提交数 1 评论 1 代码增减 +2 / -1

执行摘要

添加 canonical URL 修复 Google 索引

Google 搜索结果显示 lmsysorg.mintlify.app URLs 而不是 docs.sglang.io,因为缺少 canonical 信号。Mintlify 从两个域名提供服务,没有 canonical 标签时 Google 选择了较旧的子域名。

建议快速合并。该 PR 是典型的 SEO 修复,改动小且无副作用,能显著提升文档的可发现性。值得关注的点:如何通过配置层面的小改动解决多域名部署的 SEO 问题。

讨论亮点

无 reviewer 评论讨论。

实现拆解

  1. 修改配置文件:在 docs_new/docs.jsonseo.metatags 对象中新增一行 "canonical": "https://docs.sglang.io"
  2. 保持原有配置:保留已有的 google-site-verification 标签不动,仅追加新的 canonical 键值对。
  3. 部署生效:该配置由 Mintlify 平台读取,在构建文档站点时自动生成 <link rel="canonical" href="https://docs.sglang.io"> 标签,指导搜索引擎将权重归一到 docs.sglang.io
文件 模块 状态 重要度
docs_new/docs.json 文档配置 modified 3.17

关键源码片段

docs_new/docs.json configuration

唯一变更文件,在 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 等其他配置保持不变
}

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险极低:仅修改文档构建配置文件,不影响任何运行时逻辑。若 canonical URL 拼写错误可能导致 SEO 效果不佳,但该值通过 CI 验证后部署,错误概率低。

直接影响:修复 Google 搜索索引指向,用户搜索 SGLang 文档时将跳转到 docs.sglang.io 而非旧子域名。影响范围仅限于文档站点的搜索引擎表现,对功能无影响。

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论