Menu

#1393 HTML/FO: `<itemizedlist>` bullet points not indenting properly when used in `<footnote>`

output: all formats
open
nobody
None
5
2016-12-29
2016-12-29
No

I encountered a problem with a specific use of <itemizedlist> when rendering document to PDF via DocBook XSL/FO and Apache FOP, or rendering to HTML:

When <itemizedlist> is used inside <footnote>, I found that the generated bullet points on page's footnote in PDF output is not indented properly; namely, not indented further than the footnote number.

DocBook XML:

<footnote>
    <para>
        This is a normal text in footnote 1.
    </para>
    <itemizedlist>
        <listitem>
            <simpara>Footnote list item 1.1.</simpara>
        </listitem>
        <listitem>
            <simpara>Footnote list item 1.2.</simpara>
        </listitem>
    </itemizedlist>
</footnote>

Expected PDF rendering:

^1 This is a normal text in footnote 1.

   * Footnote list item 1.1.
   * Footnote list item 1.2.

Actual PDF rendering:

^1 This is a normal text in footnote 1.

* Footnote list item 1.1.
* Footnote list item 1.2.

This case works fine in HTML output (both single-page and chunked) though.


But when the <footnote> contained only <itemizedlist>, the symptom got worse:

  • In PDF, the improperly-indented bullet point is typed over the footnote number, making the number disappear; causing confusion to the reader when there are more than single footnote on the page.
  • In HTML (both single-page and chunked), the footnote number got merged into the first <listitem>, which is confusing.

DocBook:

<footnote>
    <itemizedlist>
        <listitem>
            <simpara>Footnote list item 1.1.</simpara>
        </listitem>
        <listitem>
            <simpara>Footnote list item 1.2.</simpara>
        </listitem>
    </itemizedlist>
</footnote>

Expected PDF rendering:

^1 * Footnote list item 1.1.

   * Footnote list item 1.2.

Actual PDF rendering:

* Footnote list item 1.1.
* Footnote list item 1.2.

Expected HTML rendering:

[1]

* Footnote list item 1.1.
* Footnote list item 1.2.

Actual HTML rendering:

* [1] Footnote list item 1.1.
* Footnote list item 1.2.

Example DocBook XML article files which exhibit this problem, together with build script, build log, XSL-FO intermediates, PDF renderings, and HTML outputs are attached as footnotelist.zip.

I'm not sure if XSL-FO part of this problem is due to DocBook XSL or Apache FOP, so please correct me if those should be filed against FOP instead.

Note: another problem found in these two examples (in XSL-FO output), is vertical spacing between <itemizedlist> and other footnote is less than the spacing between <listitem> in the same list. This reduces visual cue on where the footnote starts or ends. But that is not likely to be related to this bug.

DocBook XML DTD: 4.2
DocBook XSL: 1.79.1
XSLT Processor: XSLTproc 1.1.26
XSL-FO Processor: Apache FOP 2.1
System: Debian GNU/Linux 7.0 Wheezy i386

1 Attachments

Discussion