docbook-apps

  • 1.  Possible to render footnotes on the same page as the reference?

    Posted 07-07-2014 20:31
    I know very little about docbook, I'm just starting to edit a set of documents that is using it.

    The application I'm working on generates documents from docbook files through Flying Saucer and iText.

    I see that footnotes currently render at the end of chapters, as opposed to the end of the page. Is it practical and possible to make footnotes render at the bottom of the page?



  • 2.  Re: [docbook-apps] Possible to render footnotes on the same page as the reference?

    Posted 07-07-2014 21:17
    Hi David,

    My very limited understanding of Flying Saucer and iText is that it works with xhtml content, so I presume you are using the xhtml stylesheets.

    The DocBook html/xhtml stylesheets put footnotes at the end of the component (typically chapter or appendix) that the footnote appears in. If you're using chunked output, it puts them at the end of the chunk that contains the footnote. Since the pagination is not known in the xhtml, that's as close as you can get with the stylesheets. You can see a discussion of footnotes and the stylesheets in Bob Stayton's book at this link: http://www.sagehill.net/docbookxsl/Footnotes.html

    You might be able to hack Flying Saucer and/or iText to recognize a footnote (the markup makes it easy to find footnotes and footnote references) and handle it appropriately, but I don't think that would be an easy hack. You might also try using the DocBook fo style sheets and fop (both open source) and generate PDF that way.

    Best regards,
    Dick Hamilton
    -------
    XML Press
    XML for Technical Communicators
    http://xmlpress.net
    hamilton@xmlpress.net



    On Jul 7, 2014, at 1:31 PM, KARR, DAVID wrote:

    > I know very little about docbook, I'm just starting to edit a set of documents that is using it.
    >
    > The application I'm working on generates documents from docbook files through Flying Saucer and iText.
    >
    > I see that footnotes currently render at the end of chapters, as opposed to the end of the page. Is it practical and possible to make footnotes render at the bottom of the page?
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >




Related Content