Application Delivery Management

Header

The first six lines of a StyleBook comprise the header section. This section lets you define the identity of a StyleBook and describe what it does. This is a mandatory section.

The following table describes the attributes of the header section:

Attribute Description
name A name to identify the StyleBook. This attribute is mandatory.
display-name A descriptive name for the StyleBook. This name appears on the Citrix ADM GUI. This is an optional attribute.
description A description text defines what this StyleBook do. This description appears on the ADM GUI. This is an optional attribute. Note: This is an HTML fragment and you can use HTML tags to customize headings or insert images using the <img> tag with URLs or embedded images.
author The author person or organization who creates the StyleBook. This is an optional attribute.
namespace A namespace forms part of a unique identifier for a StyleBook to avoid name collisions. A namespace can be any string, but a good practice is to use it for naming the company, department, or unit that created or owns a set of StyleBooks. For example, you can use the following format: <company>.<department>.<unit>.stylebooks. This is a mandatory attribute.
version The version number of the StyleBook. You can change the version number when you update a StyleBook. StyleBooks of different versions can co-exist together. This is a mandatory attribute.
schema-version The version of the StyleBooks schema. It takes the value “1.0” in the current release of Citrix ADM. This is a mandatory attribute.
private If this attribute is set to true, the StyleBook is not displayed on the Citrix ADM GUI. This is a useful setting for StyleBooks that are building blocks for other StyleBooks and are not intended to be used by users directly. This is an optional attribute. Its default value is false.
   

Example:


    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"
<!--NeedCopy-->

The combination of name, namespace, and version uniquely identifies a StyleBook in the system. You cannot have two StyleBooks with the same combination of name, namespace, and version in Citrix ADM. However, you can have two StyleBooks with the same name and version but different namespaces, or with the same namespace and version but different names.

Header