Hacker News new | ask | show | jobs
by Almondsetat 968 days ago
Epubs are horrible for technical documents
1 comments

Only if they exist as poor conversions. Properly formatted epub documents are worth their weight in effort.

Epub documents _are_ HTML files in a zip archive - I'd argue that if a web site is a proper presentation of the source material, an epub is even better.

Additionally, PDF documents _are_ worse for any kind of document technical or otherwise. PDF documents are primarily Postscript instructions without any relation or hierarchy to the included elements. Epub documents/HTML provide semantic relationships and hints to the content.

I think that what previous poster is pointing is that technical documents as epub are often difficult where they're no textual contents. Images may be the easiest case. Things are a bit more clunky when code source are involved and it's weird with complex formulas.
A competent stylesheet will sidestep all those issues. Admittedly, I do wish MathML were in place to be used online and in epub documents as that would make the problem much more easily solvable.
Epub3 (not previous versions) does support MathML. The main concern is that most e-readers are not as capable as main browsers we use. Very few e-readers have good support of Epub3 features, and maths rendering is limited when available.

For codes, `pre` tag should be enough, stylesheet just adding some enlightenment. What I'm pointing is that many source code are more than 80 columns wide and that often make you scroll like with PDF. Physical readers are best for content that use aspect-ratio of pocket paper books and as far I can remember coding paper books are more (at least twice) wider and may even suffer that problem (they're often hacks I dislike to split lines.)

To short, Epub per se is not the limiting factor. Vendors must update their hard and soft (even then, things will improve only when everybody has upgraded.) Authors also must take more care to technical contents for that media (some of them convert formulas and codes to image, oooch…)

EPUB works fine for documents that mostly consist of easily reflowable text. For documents with lots of equations, diagrams, tables/charts, footnotes, etc. I would much rather have a PDF.