Specify whether to generate named CSS rules.
Named CSS rules are CSS rules generated from the formatting styles defined in templates. When such a style is assigned to a template component, the HTML tags generated by that component can be assigned with the CSS rule generated from that style. The class selector assigned to that CSS rule is specified in the template style itself (or derived from its name). Therefore, it has a constant (predictable) relationship with both the particular CSS property set produced from that style and the particular output structures where that CSS rule is applied. This opens a possibility to substitute the generated named CSS rules with the custom ones.

Please note that named CSS rules are not required for proper HTML output and will only increase its size. You need named rules only when you want to style the generated HTML documentation with your own CSS properties/rules.

Possible Values:
"none"
Disable the generation of named CSS rules.
"all"
Generate all named CSS rules possible.

When this setting is selected, almost all template formatting styles involved in the generation of the particular HTML output will be rendered into named CSS rules.

See also: Which template styles can produce named rules?

"selected"
Generate only those named CSS rules, which come from the template formatting styles with the selected "Output | CSS | Allow named rule" property.

See also: Controlling Named Rules

Restriction: The generation of named CSS rules is necessary only when you want to customize the generated CSS stylesheet with your own CSS rules. That, however, is considered a deep customization of the doc-generator implemented by a given template set. Such customizations are covered by the ${sdk_link} license (which cover the Template Designer). Therefore, you must have that license and use it at some point!

Hence the following restriction: No matter how you specify this option, the named CSS rules may be actually generated only in two cases:

  • You have installed a commercial or trial license for ${sdk_link}.
  • You use templates customized under a commercial license for ${sdk_link}. Then, named CSS rules will be generated only by the styles defined in those templates that have been modified the last time under that license.
If you have no ${sdk_link} license and use a template set you never modified, no named CSS rules can be generated!

To get a a trial license for ${sdk_link}, please follow this link: ${sdk_trial_link}

${include css_usage_link.htm}