[ docbook-Patches-2545197 ] Replacement for epub/docbook.xsl

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 454-5900

Patches item #2545197, was opened at 2009-01-29 11:45
Message generated for change (Comment added) made by h_shafie
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373749&aid=2545197&group_id=21935

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: XSL
Group: output: ePub
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Hussein Shafie (h_shafie)
Assigned to: Keith Fahlgren (abdelazer)
Summary: Replacement for epub/docbook.xsl

Initial Comment:
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:hu...@xm...) related to these style sheets (patches in a different format, enhancements, bug fixes, documentation, etc), just ask.

----------------------------------------------------------------------

Comment By: Hussein Shafie (h_shafie)
Date: 2010-07-29 10:31

Message:
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.

----------------------------------------------------------------------

Comment By: Keith Fahlgren (abdelazer)
Date: 2010-07-28 15:33

Message:
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?

----------------------------------------------------------------------

Comment By: Mauritz Jeanson (mzjn)
Date: 2010-07-28 15:07

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

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373749&aid=2545197&group_id=21935