docbook-apps

  • 1.  Paragraphs within list item jutting into page footer

    Posted 07-29-2015 01:25
      |   view attached
    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"></imagedata>
    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></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>

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

    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



  • 2.  Re: [docbook-apps] Paragraphs within list item jutting into page footer

    Posted 07-29-2015 15:29
    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 <janice@sqrrl.com> 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>
    >
    > <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: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >



  • 3.  Re: [docbook-apps] Paragraphs within list item jutting into page footer

    Posted 07-29-2015 17:00
    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 <
    peter.desjardins.us@gmail.com> 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 <janice@sqrrl.com>
    > 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>
    >>
    >> <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: docbook-apps-unsubscribe@lists.oasis-open.org
    >> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >>
    >
    >


    --
    Janice Manwiller
    Principal Technical Writer
    Sqrrl Data, Inc.
    www.sqrrl.com | @SqrrlData



  • 4.  Re: [docbook-apps] Paragraphs within list item jutting into page footer

    Posted 07-29-2015 17:34
    The fop dependency in the pom.xml for the latest version of that project is
    for v1.1: https://code.google.com/p/docbkx-tools/source/browse/trunk/pom.xml.
    If you're using the latest version of the plugin, that shouldn't be a
    problem. I see some mention of similar sounding bugs in earlier versions of
    FOP though.

    Can you find the <fo:block that's enclosing that orderedlist in the FO
    file? The FO file is an intermediate step in the build so it's likely one
    of several files that are usually discarded. The attributes of the
    surrounding fo:block might give a clue. Or at least I could compare it to
    my FO attributes.

    Peter





    On Wed, Jul 29, 2015 at 12:59 PM, Janice Manwiller <janice@sqrrl.com> wrote:

    > 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 <
    > peter.desjardins.us@gmail.com> 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 <janice@sqrrl.com>
    >> 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>
    >>>
    >>> <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: docbook-apps-unsubscribe@lists.oasis-open.org
    >>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >>>
    >>
    >>
    >
    >
    > --
    > Janice Manwiller
    > Principal Technical Writer
    > Sqrrl Data, Inc.
    > www.sqrrl.com | @SqrrlData
    >



  • 5.  Re: [docbook-apps] Paragraphs within list item jutting into page footer

    Posted 07-29-2015 17:46
    Here is the start of the ordered list:

    <fo:list-block space-before.optimum="1em" space-before.minimum="0.8em"
    space-before.maximum="1.2em" space-after.optimum="1em"
    space-after.minimum="0.8em" space-after.maximum="1.2em"
    provisional-label-separation="0.2em"
    provisional-distance-between-starts="1.8em" id="d0e4219">

    And here is the corresponding chunk from the content (last two list items
    and the list end). Before this particular run, I had removed the dbfo-need,
    which had no effect anyway:

    <fo:list-item-body start-indent="body-start()"><fo:block><fo:block>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
    <fo:inline
    font-weight="bold">Enter</fo:inline>.</fo:block><fo:block
    space-before.minimum="0.5em" space-before.optimum="1em"
    space-before.maximum="2em" space-after.minimum="0.5em"
    space-after.optimum="1em" space-after.maximum="2em" id="d0e4305"><fo:block
    id="d0e4306"><fo:external-graphic
    src="url(file:///Users/janicem/Documents/sqrrl/doc/src/img/ui_data_source_job_csv_new_field.png)"
    width="auto" height="auto" content-width="auto"
    content-height="auto"/></fo:block></fo:block><fo:block
    space-before.optimum="1em" space-before.minimum="0.8em"
    space-before.maximum="1.2em">For information on restrictions on field
    names, see <fo:basic-link
    internal-destination="sqrrl-field-name-restrictions"><fo:inline
    color="blue">Restrictions on field names for Sqrrl Enterprise
    data</fo:inline></fo:basic-link>.</fo:block><fo:block
    space-before.optimum="1em" space-before.minimum="0.8em"
    space-before.maximum="1.2em">For these new fields, Sqrrl infers the data
    type based on the values
    in the file.</fo:block><fo:block
    space-before.optimum="1em" space-before.minimum="0.8em"
    space-before.maximum="1.2em">These new fields are not added to the source
    definition.</fo:block></fo:block></fo:list-item-body></fo:list-item><fo:list-item
    space-before.optimum="1em" space-before.minimum="0.8em"
    space-before.maximum="1.2em" id="d0e4320"><fo:list-item-label
    end-indent="label-end()"><fo:block>7.</fo:block></fo:list-item-label><fo:list-item-body
    start-indent="body-start()"><fo:block><fo:block>To remove a column from the
    list, click its delete
    icon.</fo:block></fo:block></fo:list-item-body></fo:list-item></fo:list-block></fo:block>

    Thanks,

    Janice


    On Wed, Jul 29, 2015 at 1:33 PM, Peter Desjardins <
    peter.desjardins.us@gmail.com> wrote:

    > The fop dependency in the pom.xml for the latest version of that project
    > is for v1.1:
    > https://code.google.com/p/docbkx-tools/source/browse/trunk/pom.xml. If
    > you're using the latest version of the plugin, that shouldn't be a problem.
    > I see some mention of similar sounding bugs in earlier versions of FOP
    > though.
    >
    > Can you find the <fo:block that's enclosing that orderedlist in the FO
    > file? The FO file is an intermediate step in the build so it's likely one
    > of several files that are usually discarded. The attributes of the
    > surrounding fo:block might give a clue. Or at least I could compare it to
    > my FO attributes.
    >
    > Peter
    >
    >
    >
    >
    >
    > On Wed, Jul 29, 2015 at 12:59 PM, Janice Manwiller <janice@sqrrl.com>
    > wrote:
    >
    >> 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 <
    >> peter.desjardins.us@gmail.com> 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 <janice@sqrrl.com>
    >>> 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>
    >>>>
    >>>> <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: docbook-apps-unsubscribe@lists.oasis-open.org
    >>>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >>>>
    >>>
    >>>
    >>
    >>
    >> --
    >> Janice Manwiller
    >> Principal Technical Writer
    >> Sqrrl Data, Inc.
    >> www.sqrrl.com | @SqrrlData
    >>
    >
    >


    --
    Janice Manwiller
    Principal Technical Writer
    Sqrrl Data, Inc.
    www.sqrrl.com | @SqrrlData



  • 6.  RE: [docbook-apps] Paragraphs within list item jutting into page footer

    Posted 07-30-2015 09:30
    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:janice@sqrrl.com]
    Sent: Wednesday, July 29, 2015 7:00 PM
    To: Peter Desjardins
    Cc: docbook-apps@lists.oasis-open.org
    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 <peter.desjardins.us@gmail.com<mailto:peter.desjardins.us@gmail.com>> 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 <janice@sqrrl.com<mailto:janice@sqrrl.com>> 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>

    <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: docbook-apps-unsubscribe@lists.oasis-open.org<mailto:docbook-apps-unsubscribe@lists.oasis-open.org>
    For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org<mailto:docbook-apps-help@lists.oasis-open.org>




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



  • 7.  Re: [docbook-apps] Paragraphs within list item jutting into page footer

    Posted 07-30-2015 11:06
    It sounds like it might be, although I don't really know anything about our
    Maven Central repository and whether it's offline.

    I've been learning as a I go, and so far have only been creating
    customization files in our doc repository that I then then map in the doc
    pom.xml file.

    What does the relevant part of the directory structure look like? How would
    I go about updating the version of FOP used?

    Thanks,

    Janice

    On Thu, Jul 30, 2015 at 5:29 AM, Wood Nick <Nick.Wood@ncia.nato.int> wrote:

    > 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:janice@sqrrl.com]
    > *Sent:* Wednesday, July 29, 2015 7:00 PM
    > *To:* Peter Desjardins
    > *Cc:* docbook-apps@lists.oasis-open.org
    > *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 <
    > peter.desjardins.us@gmail.com> 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 <janice@sqrrl.com>
    > 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>
    >
    > <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: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >
    >
    >
    >
    >
    >
    >
    > --
    >
    > Janice Manwiller
    >
    > Principal Technical Writer
    >
    > Sqrrl Data, Inc.
    >
    > www.sqrrl.com | @SqrrlData
    >



    --
    Janice Manwiller
    Principal Technical Writer
    Sqrrl Data, Inc.
    www.sqrrl.com | @SqrrlData