31.4.4 Understanding effects of the older Stylesheet setting

Prior versions of DITA2Go used a single setting to manage CSS file options:

[HtmlOptions]
; Stylesheet = None (default if no setting),
;  Init (default set by Setup, write .css if not existing),
;  Generate (overwrite .css),
;  Class (no link, no write), or
;  Use (link, no write).
;Stylesheet=None

Stylesheet is deprecated

The Stylesheet setting is deprecated, and is replaced by the [CSS] options described in §31.4.1 Specifying CSS options in a DITA2Go configuration file. However, Stylesheet is still supported for backward compatibility.

If a Stylesheet setting is present in your configuration file and the newer [CSS] file options are not present, defaults for the newer options are set according to the value of Stylesheet, as shown in Table 31-1. If both are present, the [CSS] options prevail.

Table 31-1 Default CSS file options when [HtmlOptions]Stylesheet is used

[CSS] option

[HtmlOptions] Stylesheet setting

None

Init

Generate

Class

Use

UseCSS
No
Yes
Yes
Yes
Yes
WriteClassAttributes
No
Yes
Yes
Yes
Yes
WriteCssStylesheet
Never
Once
Always
Never
Never
WriteCssLink
No
Yes
Yes
No
Yes

Previous Topic:  31.4.3 Directing DITA2Go to generate a CSS file

Next Topic:  31.5 Understanding how CSS affects other options

Parent Topic:  31.4 Specifying CSS file and link options

Sibling Topics:

31.4.1 Specifying CSS options in a DITA2Go configuration file

31.4.2 Designating and locating a CSS file

31.4.3 Directing DITA2Go to generate a CSS file