16.9.3.1 Delimiting drop-down links and blocks with paragraph formats

The following settings use built-in DITA2Go macros to surround paragraphs in the designated formats with code to produce the link and expanding block:

[HTMLParaStyles]
; Paragraph format = DropDown, DropDownLink, DropDownBlock,
;  DropDownStart, or DropDownEnd.

or, for the link, to surround character spans:

[HTMLCharStyles]
; Character format = DropDownLink, DropDownStart

Which format properties to assign depends on the type of link and arrangement of material to be expanded:

To expand a single-paragraph block using a DITA2Go-inserted link:

[HTMLParaStyles]
BlockFormat = DropDown

To use an existing paragraph for the link, and a single paragraph for the block:

[HTMLParaStyles]
LinkFormat = DropDownLink
BlockFormat = DropDownBlock

To make a single- or multiple-paragraph drop-down block start right after the link paragraph:

[HTMLParaStyles]
LinkFormat = DropDownStart
BlockEndFormat = DropDownEnd

If you use empty paragraphs for BlockEndFormat, assign format property Raw to the format:

[HTMLParaStyles]
BlockEndFormat = DropDownEnd Raw

Format property Raw is needed only if you are using an empty paragraph to delimit the drop-down block.

Table 16-2 shows the effects of these format properties.

Table 16-2 Effects of drop-down format properties

Drop-down style

Format property

Effect

DITA2Go-supplied link, single-paragraph block

DropDown

Treats the current paragraph as the block to be expanded. Places macros <$DropLinkPara> and <$DropBlockStart> before the paragraph, <$DropBlockEnd> after the paragraph.

Variable-text link, single-paragraph block

DropDownLink

Treats the current paragraph or character span as the link. Places macro <$DropLinkStart> before the text in the paragraph or character span, <$DropLinkEnd> after the text.

DropDownBlock

Treats the current paragraph as the block to be expanded. Places macro <$DropBlockStart> before the paragraph, outside its tags, and <$DropBlockEnd> after the closing tags of the paragraph.

Variable-text link, multiple-paragraph block

DropDownStart

Treats the current paragraph as the link, and the next paragraph or paragraphs as the block. Places macro <$DropLinkStart> before the text in the current paragraph, <$DropLinkEnd> after the text, then <$DropBlockStart> after the paragraph.

DropDownEnd

Treats the current paragraph as the last paragraph in the block to be expanded. Places macro <$DropBlockEnd> after the current paragraph.

Previous Topic:  16.9.3 Delimiting expandable drop-down sections

Next Topic:  16.9.3.2 Delimiting drop-down links and blocks with markers

Parent Topic:  16.9.3 Delimiting expandable drop-down sections

Sibling Topics:

16.9.3.2 Delimiting drop-down links and blocks with markers