Skip to main content

free Dhamma book makers, please make EPUB versions: PDF's are a horrendous nuisance to read

 The only legitimate reason to use PDF, is for security reasons in legal documents to prevent tampering with the source text. 

But in practice, people use it because it's a universal format that works on any device, and preserves text and picture viewing proportions properly. But for media that is primarily consumed as text, such as free Dharma books, PDF is horrendously difficult to browse, especially on book reading devices like e-ink (electronic ink) versions of kindle. 

Why should I create EPUB files?

I won't go into all the reasons, but here's the big one. Like html files that you browse all the time on the internet, the text is reflowable. Meaning you can easily make the text bigger, smaller, resize the browser window. When you get older and your eyes get worse, you'll really appreciate being able to make fonts bigger. You can't do that with PDF files. 

I know how to fix this problem easily, with free off the shelf tools

Most of you probably write your book with Microsoft word producing a '.doc' output file, or a free shareware version of Microsoft word such as libreoffice. 

Here's how you can quickly, easily, produce for free,  epub, azw3 (amazon), mobi, pdf.

Download Calibre, a free shareware ebook management tool.

https://calibre-ebook.com/

Calibre is intuitive and easy to use. 

Here are the instructions. With the sample book source microsoft word file I show below, it took me about 2 minutes to create all the derivative versions (epub, pdf, azw3) using calibre.

This is all you have to do to make epub easily

 

1. Use H1 (heading 1), H2 (heading 2), or H3 for all your chapter title headings in your book source file (mybook.doc file). Depending on the epub reading software, a good one will build a tree table of contents up to 3 levels deep. For example:

● DN 2 -  Sāmañña-phala: recluseship-fruits

Note that not all epub reader software is created equal. If you use a good one, like calibre's ebook reader (separate program from calibre management tool), it will show table of contents with tree structures up to 3 levels deep.


2. Instead of saving your microsoft word file as a '.doc', use the function 'save as', and instead save it as a file of '.html' format.

3. Now run calibre, and from the toolbar "add book", and select your '.html' file from step #2.

4. With book added, now select from the toolbar "convert book", and it will give you options from epub, to azw3, to pdf, etc. Click the button to convert, and it will produce the output file. Calibre automatically builds a table of contents depending on what combination of heading sizes you used, H1, H2, H3. 

That's all! 4 simple steps.

Here is a sample book for microsoft word, and all the output formats for epub, azw3, pdf, all 3 with an automatically generated table of contents.

https://archive.org/details/epub-book-test-unknown

(Now in my example, the table of contents got flattened and lost the tree shape, but I include in the archive directory above, an epub from my DN 2 sutta with the tree structure table of contents intact)


The sample book file "epub-book-test.html"  is just this:


big section 1 title use: H1 heading

contents in normal text mode.


Subsection 1.1 title use: H2 heading

contents in normal text mode.


Subsection 1.2 title use: H2 heading

contents in normal text mode.


Sub-sub-section 1.2.1 title use: h3 heading

contents in normal text mode. Epub and calibre will add ‘h3’ sections into table of contents, but AZW3 will not last I checked.

Big section 2, make title, use: H1 heading

contents in normal text mode.


Subsection 2.1 title use: H2 heading

contents in normal text mode.


Sub-sub-section 2.1.1 title use: h3 heading

contents in normal text mode. Epub and calibre will add ‘h3’ sections into table of contents, but AZW3 will not last I checked.


Subsection 2.2 title use: H2 heading

contents in normal text mode.







 

Comments

Post a Comment

Popular posts from this blog

Advice to younger meditators on jhāna, sex, porn, masturbation

Someone asked: Is porn considered harmful sexual.activity? I don't have a sex life because I don't have a partner and I don't wish to engage in casual sex so I use porn to quench the biological urge to orgasm. I can't see that's it's harmful because nobody is being forced into it. The actors are all paid well and claim to enjoy it etc. The only harm I can see is that it's so accessible these days on smart devices and so children may access it but I believe that this is the parents responsibility to not allow unsupervised use of devices etc. Views? Frankk response: In another thread, you asked about pleasant sensations and jhāna.  I'm guessing you're young, so here's some important advice you won't get from suttas   if you're serious about jhāna.  (since monastics are already celibate by rule)   If you want to attain stable and higher jhānas,   celibacy and noble silence to the best of your ability are the feedstock and prerequiste to tha...
Post a Comment
Read more

SN 48.40 Ven. Thanissaro comments on Ven. Sunyo's analysis

This was Ven. Sunyo's analysis of SN 48.40: https://notesonthedhamma.blogspot.com/2024/05/exciting-news-honest-ebt-scholars-like.html And here is Ven. Thanissaro's response to that analysis: I think there’s a better way to tackle the issue of SN 48:40 than by appealing to the oldest layers of commentarial literature. That way is to point out that SN 48:40, as we have it, doesn’t pass the test in DN 16 for determining what’s genuine Dhamma and what’s not. There the standard is, not the authority of the person who’s claiming to report the Buddha’s teachings, but whether the teachings he’s reporting are actually in accordance with the principles of the Dhamma that you know. So the simple fact that those who have passed the Buddha’s teachings down to us say that a particular passage is what the Buddha actually taught is not sufficient grounds for accepting it. In the case of the jhānas—the point at issue here— we have to take as our guide the standard formula for the jhānas, a...
Post a Comment
Read more

1min. video: Dalai Lama kissing boy and asking him to suck his tongue

To give more context, this is a public event,  * everyone knows cameras are rolling  *  it's a room full of children * the boy's mom is standing off camera a few feet away watching all of this * the boy initiated contact, he had already had a hug with Dalai Lama earlier and then asked Dalai Lama for another hug which triggered this segment  17 min. video showing what happened before that 1 min. clip and after, with some explanation https://www.youtube.com/watch?v=bT0qey5Ts78 16min talk from Ajahn Acalo with his thoughts on Dalai Lama kissing boy, relevance to Bhikkhu monastic code, sexual predators in religion in general, and how celibate monastics deal with sexual energy. https://www.youtube.com/watch?v=uK2m0TcUib0 The child's comments about the incident in a filmed interview later https://www.marca.com/en/lifestyle/world-news/2023/04/18/643eba5d46163ffc078b457c.html The child: It's a great experience It was amazing to meet His Holiness and I think it's a great ex...
Post a Comment
Read more