Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

#161 Replacement for epub/docbook.xsl

output: ePub
open
XSL (122)
5
2010-07-28
2009-01-29
Hussein Shafie
No

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.

Discussion

  • Hussein Shafie
    Hussein Shafie
    2009-01-29

    Contains the new XSLT stylesheets and README.html

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

     
    • assigned_to: nobody --> abdelazer
     
    • 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.

     
  • Hussein Shafie
    Hussein Shafie
    2010-07-29

    Same but updated for DocBook XSL 1.75.2

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