#161 Replacement for epub/docbook.xsl

output: ePub
XSL (122)

After trying for several hours to modify the epub/docbook.xsl style sheets found in DocBook XSL 1.74.0 and in DocBook XSL-NS 1.74.0 to make them work with Saxon 6.5.5, we have decided to rewrite these style sheets from scratch.

* The new style sheets, called epub/epub.xsl, work fine with both Saxon 6.5.5 and xsltproc 1.1.17.

They should work fine with any XSLT engine implementing the exsl:node-set and set:distinct EXSLT extension functions.

* The .epub files created by the epub shell script (see below; created for test purposes; not meant for production use) have been tested against Adobe Digital Editions (http://www.adobe.com/products/digitaleditions/) and epubcheck (http://code.google.com/p/epubcheck/).

* Unless the DocBook document contains an isbn element, the UID of the ebook must be specified using the epub.identifier parameter.

However, when the XSLT engine is Saxon and the epub.identifier parameter has not been specified by the user, an automatically generated UUID is used.

* The epub/epub.xsl style sheets use the lang (or xml:lang) attribute and the author, corpauthor and publishername elements to automatically generate some Epub metadata.

* The epub/epub.xsl style sheets should support the rootid parameter (not sure for the DocBook 5, -ns, version).

* There is no profiling versions of the epub/epub.xsl style sheets yet, mainly because we didn't take the time to understand how works xsl2profile.xsl.

* In order to work, the epub/epub.xsl style sheets require the xhtml-1_1 style sheets to be slightly modified. These modifications are described below.

More information in the README file found in the attachment.

If you need anything from us (mailto:hussein@xmlmind.com) related to these style sheets (patches in a different format, enhancements, bug fixes, documentation, etc), just ask.


  • Hussein Shafie

    Hussein Shafie - 2009-01-29

    Contains the new XSLT stylesheets and README.html

  • Mauritz Jeanson

    Mauritz Jeanson - 2010-07-28

    Thanks for the contribution. Assigning to our EPUB expert for evaluation.

  • Mauritz Jeanson

    Mauritz Jeanson - 2010-07-28
    • assigned_to: nobody --> abdelazer
  • Mauritz Jeanson

    Mauritz Jeanson - 2010-07-28
    • milestone: 447655 --> output: ePub
  • Keith Fahlgren

    Keith Fahlgren - 2010-07-28

    Thank you for this contribution. The EPUB stylesheets have seen tremendous changes in 545 days since this ticket was submitted and DocBook-XSL is now at 1.75.2. Have you made significant changes to your modifications in that time?

  • Hussein Shafie

    Hussein Shafie - 2010-07-29

    Not much changes. Just in case, I'm going to attach latest version of my work (the one included in the distribution of XMLmind XML Editor v4.6).

    Please note that I didn't modify your EPUB stylesheets. Unfortunately I had to rewrite them from scratch.

    I guess that now that you have significantly reworked your EPUB stylesheets, my contribution has no real interest. Therefore I would understand very well if you gave it up.

  • Keith Fahlgren

    Keith Fahlgren - 2010-07-29

    I'm confident your contribution is worth reviewing, I'll just need to make sure I schedule time to merge your improvements into the trunk into the future.


Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

No, thanks