On 07/30/2016 11:55 PM, Robert Ramey wrote:
I've edited a document in DocBook 5 and I have used the
"docbook->convert" option to create output as web pages, pdf and epub. I
have a few questions:


b) My document has a bibliography after each chapter.  When rendering
with epub, rather than getting what I expect:

chapter

   section

   ...

   bibliography

I get

chapter

   bibliography

   section 1

   ...

That is, the bibliography appears at the beginning of the chapter rather
than at the end.  This happens regardless of the epub reader used.  It
doesn't happen with any of the other formats, pdf, html, etc.


This does not happen when generating PDF, single-page HTML, but it also happens when generating *multi-page* HTML (see attached screenshot).

We, XMLmind, are the authors of the XSL stylesheets which, in XMLmind XML Editor, are used to convert DocBook to EPUB. However most of the work --generating XHTML 1.1 pages-- is done by the DocBook XSL Stylesheets, an open source project (https://sourceforge.net/projects/docbook/)

The issue you have seems to come from these DocBook XSL Stylesheets (<XXE_install_dir>/addon/config/docbook5/xsl/xhtml-1_1/chunk-common.xsl) and not from our own work (<XXE_install_dir>/addon/config/docbook5/xsl/epub/epub.xsl).

These DocBook XSL Stylesheets are quite complicated and after giving it a try, we didn't manage to modify the DocBook XSL Stylesheets in order to solve your problem. Sorry for that.

It seems that the "HTML chunking" code of the DocBook XSL Stylesheets has been designed to correctly process bibliography when it is found in a book, article or a part, but not when it is found in a chapter.

My recommendation: lower you expectations and add a bibliography at the end of the book and not at the end of each chapter. An element like bibliodiv (http://docbook.org/tdg51/en/html/bibliodiv.html) should help you structure your bibliography entries.


--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to