##### 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:

- Use DropDownLink (for the link) and DropDownBlock (for the block) together.
- Use DropDownStart (for the link) and DropDownEnd (for the block) together.
- Use DropDown (for the block) by itself; DITA2Go generates the link paragraph.

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

Table of Contents • Index