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