[publican-list] [Bug 701667] New: Improve quality of Publican's epub generation

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

Summary: Improve quality of Publican's epub generation

https://bugzilla.redhat.com/show_bug.cgi?id=701667

           Summary: Improve quality of Publican's epub generation
           Product: Publican
           Version: 2.5
          Platform: Unspecified
        OS/Version: Linux
            Status: NEW
          Severity: low
          Priority: unspecified
         Component: publican
        AssignedTo: jfearn at redhat.com
        ReportedBy: wcohen at redhat.com
         QAContact: rlandman at redhat.com
                CC: mmcallis at redhat.com, publican-list at redhat.com
    Classification: Other
      Story Points: ---


Description of problem:

The epub documents generated by publican could be improved. They are very slow
to open and page through on Barnes & Noble classic Nook. 

Also when looking at the document detail on the nook give very little useful
information about the publication when compared to other epub documents. No
Author, Publisher, or Publication Date

There are a couple epub checkers on the web and there are many errors for the
generated document. Below are URLs for the validator used to check the epub
document:

http://code.google.com/p/epubcheck/
http://www.threepress.org/document/epub-validate/



Version-Release number of selected component (if applicable):

Used a RHEL-6 machine to work around bz698012 with:

publican-2.5-1.el6.x86_64
publican-doc-2.5-1.el6.x86_64
publican-fedora-1.7-0.el5.noarch


How reproducible:

Every time


Steps to Reproduce:


Download systemtap srpm from:
 http://koji.fedoraproject.org/koji/buildinfo?buildID=215008
rpm -Uvh systemtap-1.4-2.fc14.src.rpm

As root:
yum install "publican*" -y
yum-builddep systemtap-1.4-2.fc14.src.rpm 

cd ~/rpmbuild/SPEC
rpmbuild -ba systemtap.spec 

cd ~/rpmbuild/BUILD/systemtap-1.4/doc/beginners
publican build --formats=epub --langs=en-US

check generated epub document wit hhttp://code.google.com/p/epubcheck/


cd build/en-US/
java -jar /tmp/epubcheck-1.2.jar
Systemtap-1.4-SystemTap_Beginners_Guide-en-US.epub 



Actual results:

epubcheck reports many errors
Slow, hard to navigate epub document generated.


Expected results:

epubcheck doesn't report any errors.
Speedy, easy to navigate epub document generated.


Additional info:

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.