31.5 Understanding how CSS affects other options

The choice to use CSS changes the behavior of certain other options. Be aware of the following:

Using CSS changes some default values

Not using CSS changes other default values.

Using CSS changes some default values

When UseCSS=Yes, default values are reversed for the [Graphics] and [HtmlOptions] settings listed in Table 31-2. This removes most HTML that can interfere with CSS settings. (One exception is [HTMLOptions]AllowOverrides, which defaults to Yes for HTML (but not for XML or DITA) to retain any incidental use of bold and italic in text.)

Not using CSS changes other default values

When UseCSS=No, default values are reversed for the [CSS] settings listed in Table 31-2.

Table 31-2 CSS-dependent default values of options

Section

Option

Default value of option when:

Ref.

UseCSS=Yes

UseCSS=No

[CSS]
LinkClassIsParaClass

Yes

No

28.2.2.2

NoClassLists

No

Yes

30.10.2.5

WriteClassAttributes

Yes

No

31.4.1

WriteCssStylesheet

Once

Never

31.4.1

WriteCssLink

Yes

No

31.4.1

XrefFormatIsXrefClass

Yes

No

31.7.7

[HtmlOptions]
AlignAttributes

No

Yes

30.2.3

Basefont

No

Yes

 

NoFonts

Yes

No

 

Previous Topic:  31.4.4 Understanding effects of the older Stylesheet setting

Next Topic:  31.6 Linking to alternate CSS files

Parent Topic:  31. Setting up CSS for HTML

Sibling Topics:

31.1 Deciding whether to use CSS

31.2 Understanding how to use CSS

31.3 Understanding how DITA2Go generates CSS

31.4 Specifying CSS file and link options

31.6 Linking to alternate CSS files

31.7 Assigning CSS classes

31.8 Customizing CSS properties