learningequality / learningequality/kolibri
Two document_epub_render issues
Open
Nobody has claimed this yet.
PLUGIN: epub
TAG: ux update
TODO: needs decisions
- Dominant language
- Python
- Stars
- 1.1k
- Forks
- 972
- Avg merge
- 7d 16h
- Merged PRs (30d)
- 33
Description
Observed behavior
While previewing new ePubs from GDL, see here, I noticed some usability issues:
- reader defaults to two-page view and shows blank page in right half of pane
- clicking the back button on page N shows a blank page (with page number N-1), then a second click shows the actual content of page N-1
Better explained in this video:
https://www.youtube.com/watch?v=431Z8qpQo2g
Expected behavior
- User should be able to choose one-page or two-page view for reading (currently this is done automatically based on viewport)
- Clicking back on page N should bring me to page N-1
User-facing consequences
Degraded reading experience for ePub.
Steps to reproduce
Go to http://35.196.115.213/learn/#/topics/c/1793d71957ac58e598db240cf477f0c0 and flip through pages
Context
- Kolibri version: v0.11
- Operating system: Mac
- Browser: Chrome
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the ePub behavior at the linked learning page and compare it with the linked video. Investigate the reader flow for viewport-based page selection and backward navigation. Done means users can choose one- or two-page view, and clicking back from page N immediately displays page N-1.
Written by the indexing model from the issue text.
Assessment
- Domain
- frontend
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100