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

ePub files are unusable on eReader (Kobo Sage)

オープン
#3,707 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
HTML
スター
25.5k
フォーク
4k
PR マージ指標
30日以内にマージされた PR はありません

説明

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.

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

まず、Kobo Sage で JavaScript.info の ePub を使ってフリーズを再現します。特に、コードサンプルを含むページへ移動するときに確認してください。この issue にはソースファイルもテストも記載されていないため、まず ePub がどのように生成されるかを特定し、問題のあるサンプルまたはフォーマットを切り分けます。コードサンプルのページへ移動してもフリーズせず、デバイスの再起動も必要ない状態になれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
javascript
領域
documentation
issue の種類
バグ
難易度
4/5
見積もり時間
3〜5日
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
35/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。