I'm working on an issue that it seems like keep-together should be able to help.
I'm using DITA 3.5.4.
The content is a steps/step/substeps/substep structure. See the image for Step 12. It is rendering on the page and then dropping to the next page before rendering the last two lines before starting the substeps. I don't have keep-with next/previous set on any of the items.
My preference is that all of 12. drop to the next page. If I set a page break on step 12 (which I prefer not to do for obvious reasons anyway), it pushed 12 to the next page but then does a column break at "malesuada" to the second column anyway.
I have tried different combinations of keep-together, keep-together.within-column, and keep-together.within-page. I tried forcing it with Always, setting priorities from 1-9, and as shown set it to auto.
Auto is basically the same as nothing.
I also tried keep-together.within-page on the <step> with a value of 1. It caused only the 6 lines on a single page, then a blank page, then the rest of the substeps on the following page.
My goal is to have the <cmd> drop down the the next page instead of be left on the previous page. But the CMD is rendered in the overall fo:block for the step, so keep-together always tries to force all of it (cmd, step, and all substeps) onto a single page, which doesn't work.
Can anyone help me understand how to accomplish this?
<fo:list-item keep-together="auto" padding-after="4pt" provisional-distance-between-starts="7mm" vertical-align="middle">
<fo:list-item-label end-indent="label-end()" text-align="left" vertical-align="middle">
<fo:block>12.</fo:block>
</fo:list-item-label>
<fo:list-item-body start-indent="body-start()">
<fo:block>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec ex nulla, volutpat ac sodales ornare, molestie in leo. Etiam gravida ipsum ac ligula varius, eget euismod ex pretium. Aenean tempor semper sapien, in tempus nibh tristique eget. Ut et lectus ac massa semper feugiat. Curabitur arcu turpis, bibendum et laoreet at, venenatis vel neque. Suspendisse pretium nisi et eros tincidunt malesuada. Interdum et malesuada fames ac ante ipsum primis in faucibus.
<fo:list-block space-before.optimum="6pt">
<fo:list-item keep-together.within-page="auto" padding-after="4pt" provisional-distance-between-starts="7mm" vertical-align="middle">
<fo:list-item-label end-indent="label-end()" text-align="left" vertical-align="middle">
<fo:block>a.</fo:block>
</fo:list-item-label>
<fo:list-item-body start-indent="body-start()">
<fo:block>
Vivamus pretium lorem ac urna vehicula (A Figure <fo:basic-link internal-destination="unique_9_Connect_42_iw_relayboard_location_20kW">10</fo:basic-link>).
<fo:block>
<fo:block border="0.5pt solid black" keep-together="always">
<fo:block font-size="12pt" font-style="italic" font-weight="bold" margin-left="2pt" margin-right="2pt" margin-top="2pt" text-align="left">10</fo:block>
<fo:block id="unique_9_Connect_42_iw_relayboard_location_20kW" margin-bottom="2pt" margin-left="2pt" margin-right="2pt" text-align="center">
<fo:block>
<fo:external-graphic content-height="100%" content-width="scale-to-fit" scaling="uniform" src="images/location.svg" text-align="center" width="100%"/>
</fo:block>
</fo:block>
</fo:block>
</fo:block-container>
</fo:block>
</fo:block>
</fo:list-item-body>
</fo:list-item>
TOPIC Snipper
<step>
<cmd>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec ex nulla, volutpat ac sodales ornare, molestie in leo. Etiam gravida ipsum ac ligula varius, eget euismod ex pretium. Aenean tempor semper sapien, in tempus nibh tristique eget. Ut et lectus ac massa semper feugiat. Curabitur arcu turpis, bibendum et laoreet at, venenatis vel neque. Suspendisse pretium nisi et eros tincidunt malesuada. Interdum et malesuada fames ac ante ipsum primis in faucibus.</cmd>
<substeps id="substeps_1">
<substep>
<cmd>Vivamus pretium lorem ac urna vehicula (A Figure <xref href="topic.dita#task.dita_10845ce2-7990-4db8-b735-9bb9e70d0bb7/iw_location" scope="local"></xref>).</cmd>
<info>
<fig id="iw_location">
<title> Efficitur dolor volutpat. </title>
<image align="center" placement="break" conkeyref="Image-Warehouse/iw_location" id="image_42">
</image>
</fig>
</info>
</substep>