ChangelogNovember 24, 2025customizationconfigurationdocs.yml产品和版本特定的公告横幅 公告横幅现在可以在多个层级配置,以针对特定的产品或版本。 覆盖层次结构如下: 版本级 - 最高优先级,为特定版本定义时始终显示 产品级 - 当产品没有版本级公告时使用 配置级 - 当没有定义特定覆盖时在所有产品/版本中显示的后备公告 在您的 docs.yml 文件中,直接将 announcement 属性添加到 products: 或 versions: 列表中的项目: docs.yml1# 配置级公告(后备)2announcement:3 message: "欢迎来到我们的文档!"45products:6 - display-name: Docs7 path: ./products/docs/docs.yml8 # 产品级公告9 announcement:10 message: "Docs 产品处于测试版。"1112 versions:13 - display-name: v114 path: ./products/docs/v1/docs.yml15 # 版本级公告(最高优先级)16 announcement:17 message: "v1 处于维护模式。请升级到 v2。" 阅读文档
November 24, 2025customizationconfigurationdocs.yml产品和版本特定的公告横幅 公告横幅现在可以在多个层级配置,以针对特定的产品或版本。 覆盖层次结构如下: 版本级 - 最高优先级,为特定版本定义时始终显示 产品级 - 当产品没有版本级公告时使用 配置级 - 当没有定义特定覆盖时在所有产品/版本中显示的后备公告 在您的 docs.yml 文件中,直接将 announcement 属性添加到 products: 或 versions: 列表中的项目: docs.yml1# 配置级公告(后备)2announcement:3 message: "欢迎来到我们的文档!"45products:6 - display-name: Docs7 path: ./products/docs/docs.yml8 # 产品级公告9 announcement:10 message: "Docs 产品处于测试版。"1112 versions:13 - display-name: v114 path: ./products/docs/v1/docs.yml15 # 版本级公告(最高优先级)16 announcement:17 message: "v1 处于维护模式。请升级到 v2。" 阅读文档