javascript-tutorial / javascript-tutorial/en.javascript.info

ePub files are unusable on eReader (Kobo Sage)

Open
#3,707 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
25.5k
Forks
4k
PR merge metrics
No merged PRs in 30d

Description

Hi,

The ePub versions of the books are unusable on my eReader (Kobo Sage): the eReader freezes for a very long time (minutes) when turning pages, or freezes permanently until the device is restarted.

The issue seems to be related to code samples: the freeze happen when turning to a page with a code sample on it.

This is a fairly recent eReader and I have other large technical books that work well on it. For example Fluent Python is over 1000 pages and full of large code samples (even syntax highlighting) and it works great, pages turn immediately. Eloquent JavaScript is another that works great.

So I suspect the problem might be something to do with the JavaScript.info ePubs.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the freeze with a JavaScript.info ePub on a Kobo Sage, especially when turning to pages containing code samples. The issue names no source file or test, so first identify how the ePub is generated and isolate the problematic sample or formatting; done means code-sample pages turn without freezing or requiring a device restart.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
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.