I don’t like pdf because the text doesn’t flow if you increase font size. It’s hard to read on phones. There are other reasons too but not flowing text is my main complaint.
There are online “free convert” services. I just downloaded the Darktable 3.4 manual as PDF and converted it to epub. Now I can read it on my desktop phone or tablet. And–hallelujah–it’s not PDF.
If the manual was also offered in epub format it would be interesting to see how many PDF downloads still happened.
An epub version is planned - we just need to work out how: create epub workflow · Issue #83 · darktable-org/dtdocs · GitHub
Those converters often do a very poor job of conversion.
If someone wants to write the epub manifest filew for go templates, that’s about all we need for an epub.
Indeed the online-convert epub I got was messy, but still better than PDF. Are they just a front end for a command line Calibre conversion?
Even if calibre also does a messy job it could be edited. I’ll try Calibre tonight.
You’d be better off starting with the html that’s used for the pdf. See the PDF instructions at the bottom of the github page GitHub - darktable-org/dtdocs: darktable user manual. Calibre might be able to convert that ok if you can save it in a format Calibre likes.
Generally pdf to epub will always be pretty rubbish and yes I believe most of the online converters use Calibre or something similar.
I downloaded the html using this guide but the table of contents was repeated after each entry and the links from the ToC didn’t work;
I’m no expert in Calibre so perhaps someone else can see how the TOC can be corrected