November 24, 2025

产品和版本特定的公告横幅

公告横幅现在可以在多个层级配置,以针对特定的产品或版本。

覆盖层次结构如下:

  1. 版本级 - 最高优先级,为特定版本定义时始终显示
  2. 产品级 - 当产品没有版本级公告时使用
  3. 配置级 - 当没有定义特定覆盖时在所有产品/版本中显示的后备公告

在您的 docs.yml 文件中,直接将 announcement 属性添加到 products:versions: 列表中的项目:

docs.yml
1# 配置级公告(后备)
2announcement:
3 message: "欢迎来到我们的文档!"
4
5products:
6 - display-name: Docs
7 path: ./products/docs/docs.yml
8 # 产品级公告
9 announcement:
10 message: "Docs 产品处于测试版。"
11
12 versions:
13 - display-name: v1
14 path: ./products/docs/v1/docs.yml
15 # 版本级公告(最高优先级)
16 announcement:
17 message: "v1 处于维护模式。请升级到 v2。"
阅读文档