internetarchive / internetarchive/epub

epub & Daisy converters skip pages of type "Chapter"

Open
#31 20 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
41
Forks
3
PR merge metrics
No merged PRs in 30d

Description

From Jon Leach on the ol-tech mailing list:

> > On Sep 25, 2015, at 1:37 PM, Hank Bromley hank@archive.org wrote:
> > The "missing pages in EPUB" problem is a known one. See:
> > https://webarchive.jira.com/browse/WEBDEV-3
> >
> > On Fri, 25 Sep 2015, John Gonzalez wrote:
> >
> > > Hey there. Thank you for the head’s up. Can you please provide links to a couple of examples so that we can investigate further?

```
John, does the issue tracker link that Hank provided give you enough
```

to go on? I tried creating an account on webarchive.jira.com to see if
the reported issue matched what I was seeing - but while I could create
an account, I still got a "Permission violation" error page when trying
the link Hank provided.

Just for comparison, though, here's an example:

https://openlibrary.org/books/OL7433769M/Bill_the_Galactic_Hero

The epub has 7 pages of scanned boilerplate (cover, title,
copyright, etc.), then the first page in the 'Pages' section starts as
shown in the attached screendump (which is actually a mix of the
dedication page and page 2 of the text, skipping over page 1 of chapter
1 entirely). There may be (probably are but I haven't checked) other
missing pages further in the text.

This is representative of what I've seen with lots of other epubs,
and the reason I've given up on borrowing anything but PDFs despite the
size / slow downloads. The PDF and in-browser versions are not missing
pages.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the linked Open Library example and compare its EPUB and PDF or in-browser page sequences, focusing on pages marked as type "Chapter." The issue names no source files, tests, or converter entry points, so identify the relevant converter code and reproduce the missing-page behavior before defining the fix. Done means the EPUB and Daisy outputs retain all chapter pages without regressing the existing boilerplate pages.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
backend
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.