I am making frequent use of togglers in my online Help. For my print output, I'm starting each corresponding toggler topic with a conditional print h3 heading. These h3 topics are always the first line within the toggler division <div>. My topic structure looks like this:
<h3>What do you want to do?</h3> (online only)
<p>Perform this task.</p> <toggler> (online only)
<div> (linked to toggler)
<h3>Performing this task.</h3> (print only)
Step 1. (The rest of the content applies to both print and online media)
Step 2.
Step 3.
</div>
When I try to apply an "always" page break to a particular heading, or create an h3.break class with a page break set to "always", the PDF output does NOT take the page break. My question is this: Does Flare honor heading page breaks within togglers? If so, how do I get this to work?
I've found a workaround: If I place the conditional print h3 heading outside of the toggler (that is, just before the <div>), the output takes the page breaks. The new structure looks like this:
<h3>What do you want to do?</h3> (online only)
<p>Perform this task.</p> <toggler> (online only)
<h3>Performing this task.</h3> (print only)
<div> (linked to toggler)
Step 1.
Step 2.
Step 3.
</div>
While this works, I'd prefer to keep my print headings WITHIN the toggler for organizational and print preview reasons. Is there some simple page break fix I'm overlooking?
Thank you in advance for your assistance. It is always helpful.
Regards,
-John Lemon
Page breaks within togglers
Re: Page breaks within togglers
Admittedly, the project I've been working on since v4 came out is a print-only output, so I haven't tried using togglers at all, but why are you even duplicating the <h3> tag? That might be what's throwing off the page-break calculations. Why not do the following...
<h3><MadCap:conditions="Default.OnlineOnly">What do you want to do?</MadCap><MadCap:conditions="Default.PrintOnly">Performing this task.</MadCap></h3>
<div> (linked to toggler)
Step 1. (The rest of the content applies to both print and online media)
Step 2.
Step 3.
</div>
Or... If you repeat that <h3> text, either create a snippet with the above setup, or use an auto-numbering scheme on the <h3> tag and specify different text for the format for online output and for print output. (I'd probably do the latter.)
And as for whether or not the toggler is screwing up the breaks... The toggler tag is stripped out for print output, so how the content in that div breaks depends on what break settings you have specified for the div tag.
<h3><MadCap:conditions="Default.OnlineOnly">What do you want to do?</MadCap><MadCap:conditions="Default.PrintOnly">Performing this task.</MadCap></h3>
<div> (linked to toggler)
Step 1. (The rest of the content applies to both print and online media)
Step 2.
Step 3.
</div>
Or... If you repeat that <h3> text, either create a snippet with the above setup, or use an auto-numbering scheme on the <h3> tag and specify different text for the format for online output and for print output. (I'd probably do the latter.)
And as for whether or not the toggler is screwing up the breaks... The toggler tag is stripped out for print output, so how the content in that div breaks depends on what break settings you have specified for the div tag.
Lisa
Eagles may soar, but weasels aren't sucked into jet engines.
Warning! Loose nut behind the keyboard.
Re: Page breaks within togglers
Lisa,
Thank you for your comments.
Based on your advice, I created a div class called div.pagebreak with a page-break-before setting of "always". After applying it to the appropriate toggler <div> tags, the print output page breaks occurred exactly as I wanted them to!
Thanks again,
-John
Thank you for your comments.
Based on your advice, I created a div class called div.pagebreak with a page-break-before setting of "always". After applying it to the appropriate toggler <div> tags, the print output page breaks occurred exactly as I wanted them to!
Thanks again,
-John