Tool for building EPUB about monerobook HOT 9 OPEN

as an epub lover I would suggest pandoc to convert markdown to epub. It can be customized and generates good quality code. Once in epub you can perform the checks you want in sigil (i.e: check external references to update urls if they are down)

https://wiki.mobileread.com/wiki/Pandoc

from monerobook.

I’m not entirely knowledgeable on this topic, but I am curious if this would have any impact (pros or cons) on being able to turn this into an audiobook? It would be great if we could get this listed on Audible at some point too! If folks agree, then perhaps that should be a factor to consider when deciding upon publishing tools.

from monerobook.

Audiobook is a good idea! I think that the first few chapters would be amenable to spoken format.

from monerobook.

I have used Sigil, to create EPUBs from scratch, and to edit existing EPUBs. Probably the best tool if you want full control over the process as you can edit css and html files to your hearts content.

To convert e.g a Word document to epub I have used a tool called calibre-ebook.

from monerobook.

I think an approach similar to monero-ecosystem/monero-GUI-guide#56 could be used. That template will build PDF, epub and HTML versions of the guide. It will also make possible to easily manage translations.
I can give a hand to build this

from monerobook.

I personally tried to use open source alternatives such as Pandoc. Unfortunately, I find more helpful and useful to use Adobe InDesign (paid version naturally). That program has a lot of options for enchanting epub and PDF versions.

from monerobook.

for links … as they might disappear: simply make everything available via archive.org AND make a copy for future use.

if you use adobe … it seems you dont cherish the principle to use free software – it is not about beauty or features, it is about reproducibility by others.

from monerobook.

"InDesign's strengths lie in its page layout tools, which can't be beaten, but are largely irrelevant for reflowable content."

We have reflowable content, and the book is being created entirely in InDesign. I do not know about converting InDesign > Sigil. I don't think it's possible what I googled quickly. If we put the content (copypasta) into Sigil or Word, it could be possible to hand the ebook part to you guys.

Note that InDesign generates epub as well. It's a process, and you can optimise it, so it makes a right stylesheet and code, but it's clumsy. I think Sigil and the right user behind the keyboard can probably pull off the same stuff and would have more edit abilities (code).

I don't know which is the best for epub — sigil or Indesign.

from monerobook.

currently i have good experience with bookdown https://bookdown.org/yihui/bookdown/.
that makes use of markdown (integrated with R) and has many output targets through pandoc, like HTML, PDF, EPUB and DOCX.

from monerobook.