##### 42.2.9.4 Overriding graphic properties for HTML

You can use configuration PI markers and configuration-variable assignments to override any variable-key settings and some fixed-key settings in the HTML [Graph*] sections listed in Table 42-6.

A temporary override to a graphic affects the next graphic after the point in your document where you insert the PI marker.

A persistent override affects the next graphic with the ID or in the graphic group named by the Key in [Section]Key=Value; and for graphic groups, all subsequent matching instances in the same DITA file, unless changed again by a later override.

One additional section, [GraphGroup], is handled differently from the rest. For [GraphGroup], the directive assigns the graphic to a named graphic group. You can use only a temporary setting applied with a *Config PI marker, not a macro, to specify the graphic group.

Overriding the overrides

To override path settings both in [GraphFiles] and in configuration PI markers with whatever you specify for [Graphics]GraphPath:

    [Graphics]
    ; GraphPathOverrides = No (default) or Yes (overrides any path
    ; in Config markers and in [GraphFiles], adding GraphPath
    ; and using FixGraphSpaces)
    GraphPathOverrides=Yes

When GraphPathOverrides=Yes, DITA2Go uses the path to graphics specified by GraphPath (see §40.2.1.1 Specifying graphics location for HTML) instead of any path (or lack of a path) specified in [GraphFiles] (see §40.2.1.2 Substituting graphics files for HTML) or in a *Config PI marker with content:

    [GraphFiles]=filename

Also, DITA2Go replaces with underscores any spaces in file names of referenced graphics.

Table 42-6 HTML graphic sections subject to overrides

Graphic configuration section
    [GraphALT]
    [GraphAttr]
    [GraphEndMacros]
    [GraphFiles]
    [GraphHigh]
    [GraphReplaceMacros]
    [GraphScale]
    [GraphStartMacros]
    [GraphWide]

See also:

§32.6 Specifying HTML image attributes

§42.2.10 Assigning HTML table and graphic groups with overrides

Previous Topic: 42.2.9.3 Overriding table properties for HTML

Next Topic: 42.2.10 Assigning HTML table and graphic groups with overrides

Parent Topic: 42.2.9 Overriding variable-key configuration settings

Sibling Topics:

42.2.9.1 Overriding paragraph and character format properties

42.2.9.2 Overriding cross-reference properties

42.2.9.3 Overriding table properties for HTML

Table of Contents • Index