edrlab / thorium-reader

A cross platform desktop reading app, based on the Readium Desktop toolkit
https://www.edrlab.org/software/thorium-reader/
BSD 3-Clause "New" or "Revised" License
1.85k stars 157 forks source link

Navigating back from a in-publication hyperlink jump (footnotes, etc.) - nav history? (back + forward buttons / keyboard commands) #1624

Closed spudthebud closed 2 years ago

spudthebud commented 2 years ago

Using the JAWS screen reader (2021) with Thorium 1.8 to read an academic journal article, I encounter a problem.

The article has a table in the main text and a link to a table, as shown in this next image.

image

When I activate the table link, it appears in the visual interface that Thorium is presenting the table all on its own (see the image below). If this were a browser, it's like we've gone to a separate page the just shows the table. There's nothing wrong with this.

The problem is I can't get back to the main article. I try ALT + Left, which works in a browser, but no luck. Now I'm stuck on that page that only has the table.

I finally managed to get back by going to the Table of Contents and then clicking the abstract button. But that's really not intuitive, from my point of view. It took me a while to figure it out after some exploring because "table of contents" only appears after pressing the navigation toggle button.

image

danielweck commented 2 years ago

Hello, you are correct, there is no "back" button (and its counterpart the "forward" button) like there is in web browsers. Therefore, when EPUB HTML documents are not authored with "back links" from footnote content or other types of hyperlinked notes, then the user must find their way back (not a good UX). @panaC it looks like we should reactivate your pending / in-review Pull Request: https://github.com/edrlab/thorium-reader/pull/1200

spudthebud commented 2 years ago

Is there any kind of example ePub or test document that has back links that I could try out?

danielweck commented 2 years ago

You can try the Wasteland EPUBs from: https://idpf.github.io/epub3-samples/30/samples.html

Example HTML code:

https://github.com/IDPF/epub3-samples/blob/0b3e80553f509fbdfe591008cd7d1e804b24db54/30/wasteland-otf-obf/EPUB/wasteland-content.xhtml#L183-L184

<div id="ln98">As though a window gave upon the sylvan scene<a epub:type="noteref" class="noteref" href="#note-14">*</a>
</div>

https://github.com/IDPF/epub3-samples/blob/0b3e80553f509fbdfe591008cd7d1e804b24db54/30/wasteland-otf-obf/EPUB/wasteland-content.xhtml#L825-L827

<div epub:type="rearnote" id="note-14">
<p><a href="#ln98">98.</a> Sylvan scene. V. Milton, Paradise Lost, iv. 140.</p>
</div>

Conversely, the Georgia EPUB does not contain backlinks, but in Thorium when the popup footnotes feature is activated, note contents are displayed in a modal dialog which, when closed, restores the reading location at the calling site (i.e. note link). Here is a link to Georgia's HTML document (search for keyword "noteref" to find relevant hyperlink markup): https://github.com/IDPF/epub3-samples/blob/main/30/georgia-pls-ssml/EPUB/georgia.xhtml

danielweck commented 2 years ago

From https://github.com/edrlab/thorium-reader/issues/1198

When one follows an hyperlink in an EPUB that takes you, for example, to the glossary at the end of the book, there is not "back" button to take you where you were before clicking on hyperlink. This is very annoying.

danielweck commented 2 years ago

Issue was merged into https://github.com/edrlab/thorium-reader/issues/1198

danielweck commented 2 years ago

Was fixed via https://github.com/edrlab/thorium-reader/commit/a407d1669bde9dc904ce640150a5ab148976f12a