标头

Last published : Oct 06, 2026
StyleBook 的前六行构成标头部分。此部分允许您定义 StyleBook 的身份并描述其功能。这是必填部分。
下表描述了标头部分的属性:
属性 描述
名称 用于标识 StyleBook 的名称。此属性为必填项。
显示名称 StyleBook 的描述性名称。此名称显示在 NetScaler Console GUI 上。这是可选属性。
描述 描述文本定义了此 StyleBook 的功能。此描述显示在 NetScaler Console GUI 上。这是可选属性。注意:这是一个 HTML 片段,您可以使用 HTML 标签自定义标题或使用带有 URL 或嵌入图像的 <img> 标签插入图像。
作者 创建 StyleBook 的作者个人或组织。这是可选属性。
命名空间 命名空间是 StyleBook 唯一标识符的一部分,用于避免名称冲突。命名空间可以是任何字符串,但最佳实践是将其用于命名创建或拥有一组 StyleBook 的公司、部门或单位。例如,您可以使用以下格式:<company>.<department>.<unit>.stylebooks。这是必填属性。
版本 StyleBook 的版本号。更新 StyleBook 时可以更改版本号。不同版本的 StyleBook 可以共存。这是一个强制属性。
架构版本 StyleBooks 架构的版本。在当前版本的 NetScaler Console 中,其值为“1.0”。这是一个强制属性。
私有 如果此属性设置为 true,则 StyleBook 不会显示在 NetScaler Console GUI 上。这对于作为其他 StyleBook 构建块且不打算由用户直接使用的 StyleBook 来说是一个有用的设置。这是一个可选属性。其默认值为 false。
示例:

    name: lb
    description: "This stylebook defines a sample load balancing configuration."
    display-name: "Load Balancing StyleBook (HTTP)"
    author: Mike Smith (ACME Infra team)
    namespace: com.example.stylebooks
    schema-version: "1.0"
    version: "0.1"
名称、命名空间和版本的组合在系统中唯一标识一个 StyleBook。在 NetScaler Console 中,不能有两个 StyleBook 具有相同的名称、命名空间和版本组合。但是,您可以有两个 StyleBook 具有相同的名称和版本但命名空间不同,或者具有相同的命名空间和版本但名称不同。