edrlab / thorium-reader-doc

Documentation of Thorium Reader, as a Hugo website.
https://edrlab.github.io/thorium-reader-doc/
Apache License 2.0
3 stars 8 forks source link

add a fallback button on the homepage to access the online version of the documentation if the first button with the opds protocol failed !! #112

Closed panaC closed 1 month ago

panaC commented 1 month ago

see https://github.com/edrlab/thorium-reader/issues/2581

gautierchomel commented 1 month ago

There is no online version for thorium 3 documentation, only support (Faq, keyboard shortcuts and contribute pages).

panaC commented 1 month ago

The deeplink integration is not consistent across platforms and thorium installation method. We have to use it like a bonus but not as the only way to access the opds-feed. Moreover you use an external service called githack.com, this external service can failed, its better to use a clean url, served by the github pages instead.

I don't really understand why, change suddenly the way to read the thorium documentation. I prefer by default read it on a webpage and download the epub if needed, but why force the user to use a complex pipeline to download the epub throw an opds feed, When we know the difficulty to versionning an epub.

When a user download an epub from opds feed there are a cache mechanism to do not download the same epub again, but if the documentation evolve, how the user knows if it read the good documentation. With a web reading, don't worry about that. The readium web reader can be in fact the solution if epub only is keeped.

panaC commented 1 month ago

There are 2 main issues to resolve :