PDF is great but ePub is even better (on e-ink devices)

[Zingam]

There are alot of big screen ereaders these days but reading PDF on them is not very comfortable experience. ePub format is supported and much better on e-ink devices. It will be great if there is a epub version of the book with a proper Table of Contents (TOC).

[chriseyre2000]

I have found out how to use pandoc to generate the epub:

pandoc -o ../out/CategoryTheory.epub ctfp.tex --resource-path=.:images

It does require copying all of the images to an images folder within the src directory.

I will be making this into a proper PR over the next few days.

[andyleejordan]

@chriseyre2000 Any chance you’ll get to that? I’d love an epub of this too.

[chriseyre2000]

My nix skills are lacking. I will get back to this.

The above script does work for now.

[MartinSeeler]

Any progress on this? Would be great to have an epub for downloads. 😍

[drupol]

It is super easy to do with Github actions and pandoc.

[Glidos]

@drupol would be great if you would expand on that for those less familiar with exactly how Github actions work.

[Glidos]

@chriseyre2000 When I run that command I see many warnings, some "Could not load include file" and "Could not convert TeX math". The resulting file has in many places the rendered TeX followed by the TeX source. Is that what you see too?

[drupol]

@Glidos How can I help?

[Glidos]

@drupol have you tried this conversion? If so, I'd be interested to know if you see the same problems I've just posted.

[drupol]

@drupol have you tried this conversion? If so, I'd be interested to know if you see the same problems I've just posted.

No, I haven't tried yet, I'm sorry.

[chriseyre2000]

I solved it by moving the images to an appropriate location, this is why I have had trouble generalising it.

…

On Fri, 28 May 2021 at 21:30, Paul Gardiner ***@***.***> wrote: @chriseyre2000 <https://github.com/chriseyre2000> When I run that command I see many warnings, some "Could not load include file" and "Could not convert TeX math". The resulting file has in many places the rendered TeX followed by the TeX source. Is that what you see too? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#256 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAIMRXY25DQNLDXMVDO3QN3TP74PNANCNFSM4RJFJS3A> .

[Glidos]

I followed that part of the instructions... well I created hard links to all the images in a dir under src called "images". It wasn't image files that were mentioned in the errors. Thanks for the reply, all the same.

[Glidos]

I ended up just adding a new paper size appropriate for my kindle paperwhite, with very small margins, and building a pdf file. Here's the contents of the opt- file in case it's useful to anyone else:

% !TEX root = ctfp.tex

% Options for kindle paperwhite

\def\OPTmodes{oneside,openany,11pt}

% PAGE FORMAT
%
% Page geometry
\def\OPTpaperesize{90mm,120mm} % Page size
\def\OPTtopmargin{5mm}        % Margin at the top of the page
\def\OPTbottommargin{5mm}     % Margin at the bottom of the page
\def\OPTinnermargin{5mm}    % Margin on the inner side of the page
\def\OPToutermargin{5mm}    % Margin on the outer side of the page
\def\OPTbindingoffset{0mm}     % Extra offset on the inner side

\def\OPThidelinks{false}

The very small bottom margin cause the page numbers to be pushed off page. Making that 10mm brings them back, but only just, and in an odd looking position. I couldn't see how to control page number positioning independently.

[tannerntannern]

in case it's useful to anyone else

Useful to me 3 years later! I have a kobo e-reader of similar size so these settings worked great. Thanks @Glidos 🙂