Janice,

I have had similar issues in the past of text bleeding into footers but since 
using FOP 1.1, I don’t recall any.  I also build with the maven-docbkx plugin 
but with a Nexus off-line repository, which means I have to occasionally update 
my Maven Central repository to get updated versions of FOP, etc.  I don’t know 
if you are in a similar position?

Regards

Nick


From: Janice Manwiller [mailto:[email protected]]
Sent: Wednesday, July 29, 2015 7:00 PM
To: Peter Desjardins
Cc: [email protected]
Subject: Re: [docbook-apps] Paragraphs within list item jutting into page footer

We use the maven docbkx plugin - all docs are generated using the build 
process. According to their doc, they use Apache FOP for PDF generation. They 
don't give a version.

I haven't made any customizations at all to ordered lists or list items. The 
only keep-together customization I added to was to prevent page breaks in table 
rows.

Janice

On Wed, Jul 29, 2015 at 11:28 AM, Peter Desjardins 
<[email protected]<mailto:[email protected]>> wrote:
I'm wondering why the last listitem did not break to the next page. Have you 
applied any customization to the way orderedlists keep-together? Maybe 
temporarily turn off all your customizations and see what happens to the lists 
in the default PDF formatting?

I have very many lists with listitems that often include multiple para 
elements, programlistings, and other children. I have never seen any problem 
with listitems bleeding into page footers and have never needed to apply the 
dbfo-need processing instruction. So I would expect the correct breaking 
behavior to be fairly reliable on its own.

Maybe your FO processor could be part of the problem? I use Apache FOP 1.1. How 
is your FO processed?

Another troubleshooting technique I have used is to search the FO file produced 
by DocBook XSLT and find the corresponding elements in there. Some of the 
attributes on the list or whatever element is containing it might be giving the 
FO processor instructions that could lead to this situation. I usually open the 
FO in a text editor and search for some text strings in the content I'm looking 
for.

Good luck!

Peter



On Tue, Jul 28, 2015 at 9:25 PM, Janice Manwiller 
<[email protected]<mailto:[email protected]>> wrote:
I had asked about this issue earlier, and thought I had found a solution, but 
unfortunately it's not working reliably.

On occasion, PDF pages do not break correctly within a list item. If the list 
item contains more than one paragraph, then the paragraphs can bleed into the 
page footer.

I had come across the dbfo-need option, which sometimes works, but not always.

The attached image shows an example of this happening.

Here is the source DocBook XML for the same excerpt.


                    <listitem>
                        <para>To use a column to add a new field to the source 
data, in the dropdown
                            list field, type the name of the new field, then 
press
                                <keycap>Enter</keycap>.</para>
                        <informalfigure>
                            <mediaobject>
                                <imageobject>
                                    <imagedata scale="100"
                                        
fileref="../img/ui_data_source_job_csv_new_field.png"/>
                                </imageobject>
                                <textobject>
                                    <phrase>Entering a new source field name 
for a CSV
                                        column</phrase>
                                </textobject>
                            </mediaobject>
                        </informalfigure>
                        <para>For information on restrictions on field names, 
see <xref
                                
linkend="sqrrl-field-name-restrictions"/>.</para>
                        <para>For these new fields, Sqrrl infers the data type 
based on the values
                            in the file.</para>
                        <?dbfo-need height="2in" ?>
                        <para>These new fields are not added to the source 
definition.</para>
                    </listitem>
                    <listitem>
                        <para>To remove a column from the list, click its 
delete icon.</para>
                    </listitem>
                </orderedlist></para>
So while I have the dbfo-need option set for the paragraph, it's still not 
causing the page to break.

Any ideas to get this to work reliably?

Thanks,

Janice




---------------------------------------------------------------------
To unsubscribe, e-mail: 
[email protected]<mailto:[email protected]>
For additional commands, e-mail: 
[email protected]<mailto:[email protected]>




--
Janice Manwiller
Principal Technical Writer
Sqrrl Data, Inc.
www.sqrrl.com<http://www.sqrrl.com> | @SqrrlData

Reply via email to