rbwhitaker / CSharpPlayersGuideEarlyAccess

A place to track issues with the C# Player's Guide for patches and future editions
19 stars 0 forks source link

[from JimmieeB on Discord] The equation in the Triangle Farmer is displayed weird on Kindle #617

Closed rbwhitaker closed 1 year ago

rbwhitaker commented 2 years ago

This is Kindle taking some creative liberties about how to display an equation.

It might be related to fonts not being in the file, or it might just be something that needs to be fixed with the EPUB/MOBI versions in the future.

rbwhitaker commented 2 years ago

image

rbwhitaker commented 2 years ago

I do want to point out here that there is no official "Kindle edition" of the book. There's a PDF version, and it is meant to be viewed in a stereotypical PDF viewer like Acrobat, without flowing the document, which has all sorts of other issues as well. I want to make an official EPUB and MOBI versions, but they don't exist yet.

rbwhitaker commented 1 year ago

One possibility here could be to make this equation an image, rather than a Word equation. I think an EPUB/MOBI ebook reader would render a picture better. I think this is the only equation in the book, so perhaps that's justifiable. And it's not even a complicated one. But it would be a minor inconvenience to need to revise this equation picture. I don't currently have a great scheme for handling this, though when I do get around to the EPUB/MOBI versions, I will likely have a system that could take either LaTeX or MathML or something and convert it to pictures, which would solve the problem in other ways.

That's a long way of saying I'm on the fence. Either I'll just turn this into a picture or I'll defer on it and solve it when I do the official EPUB version.

rbwhitaker commented 1 year ago

6th Edition will have a picture in lieu of an equation. That works well enough for this single equation, which is the only one in the book and highly unlikely to change. The workflow for getting it into a picture is rough right now. But this is likely a viable solution for the short term. This book won't ever have many equations in it. But if I do a game math book, as I've wanted to do for a while, or even just a game programming book, or a data structures and algorithms book, this approach doesn't scale well. So it works for here and now, but I'll need to figure something else out, including going back to normal equations and just having Kindle struggle, since Kindle isn't even officially supported for the book. But hopefully, in the long term, there will just be a better solution.