Thursday, April 4, 2013

this is the way to polish your e-books

Hi
It has been a while but again calibre has some great new features. So let us take a look at them. Here I will discuss "Polish Ebooks" introduced in 0.9.23 and next time "Edit TOC" introduced in 0.9.25. Note that polishing is only supported for books in AZW3 and EPUB formats. Hopefully any bugs that were present to start with have been ironed out. Your feedback is always welcome and since this is a fairly new feature, click here to report any bugs.

Adding the buttons:
To start with lets get the "Polish" and "Edit TOC" buttons, so we can click on them.. Go to "Preferences", click on "Toolbar", click on the button that says "Click to choose toolbar or menu to customize". In this case I have chosen "Main Toolbar" because I want the icons for "Polish" and "Edit TOC" to appear in the main toolbar so I can access them easily. If you think you wont use them too often you can have them on a secondary optional toolbar or wherever is convenient for you.
So after I click main toolbar the following window opens up:




On the left menu of available actions you will see the "Polish" and "Edit TOC" buttons highlighted by red rectangles in the above figure. They are towards the bottom of the menu so you may have to scroll down. Select them both. then click the right pointing blue arrow (circled in red in the above figure). This will move these icons from the available actions list to the current actions list. Click "Apply" on the top left corner and close your Preferences window. Now the added buttons will be included in the toolbar you chose. In this case in the main toolbar as shown below:



Polishing Options:

Select all the e-books to be polished in the same way and then click the polish icon in the main toolbar. The following window opens up:



The available options are outlined here.
You can:
  • Subset all embedded fonts
  • Smarten punctuation
  • Update metadata
  • Update cover
  • Add a metadata page at the start of the book
  • Remove a previously inserted metadata page
Many of these options were available earlier too, but to implement them you would have to convert the book again which for some e-books can be slow and CPU intensive. Now you can just spruce them up quickly because  polishing, unlike conversion, does not change the internal structure/markup of your book, it performs only the minimal set of actions needed to achieve its goals.
The "About" button next to each action gives details about exactly what the particular polishing tool achieves.

Subset all embedded fonts and Smarten punctuation:
This is just copied from the about section of "Subset all embedded fonts". The information is quite clear and I had nothing to add to it:

Similarly smarten punctuation simply converts plain text dashes, ellipsis, quotes, multiple hyphens, etc. into their typographically correct equivalents.
Caveat: The algorithm for "Smarten punctuation" can occasionally generate incorrect output.

Update metadata and Update cover in book files:
When you click "Edit Metadata" in calibre and change the metadata or the cover of a book the information is saved in a file called metadata.db in your calibre library. This information is only transferred to the particular book file when you convert the book or export it. However now this information can be updated in the book files by simply choosing the appropriate options in "Polish". Note there are separate buttons for updating the cover and for updating the rest of the metadata. The metadata that is updated will depend on what metadata the e-book format supports. Unfortunately many e-book formats do not support all the metadata that calibre allows you to store.

The following is a screen shot of calibre before "Update cover in book files" was done:



The e-book had been downloaded from Project Gutenberg.  then the metadata was edited to add the cover you can see on the right information panel of the main calibre window. But the polishing was not done so the the cover displayed when viewed was the generic cover page Project Gutenberg uses for all books.

Next we ran the "Update cover in book files" under "Polish" and voila,


the chosen cover is now the first page in the viewer.

Add metadata as book jacket page:

This allows you to add a book jacket containing all the metadata you added under "Edit Metadata" in calibre, including title, author, publisher, tags, comments, rating, series information etc. The book jacket page is always the very first page and precedes the cover page if there is one.

The following shows the book jacket for the book we have been using as an example so far:


The last option in "polish" is to remove the previously added book jacket in case you did not like it.

Coming soon:
In a week or two I will discuss the "Edit TOC" feature added in 0.9.25. It may still have a few bugs so let's give it some time to be straightened out. Also I have to go learn about it.

Hope you enjoyed this post. Have fun polishing away.

6 comments:

  1. In Calibre's recent updated version (1/17/2014), there is no Toolbar option under the Preferences menu. Do you know how to get the ToC toolbar in the latest version?

    ReplyDelete
  2. In my calibre which is the latest one there is still a toolbar under the "Interface" section in preferences. Has it somehow disappeared in yours. Just double check. if it is still missing try updating again and see if that fixes it.

    ReplyDelete
    Replies
    1. I have an ebook with a TOC, however when I try to follow your tips I keep getting an error which says

      "No items found that could be added to the TOC"

      The existing TOC has moved around. I have also in desperation added my Chapter 1-50 manually.

      I really do not know how to get around this, can you help.

      gunangagak@gmail.com

      Delete
  3. Hello, thank you for the nice post.
    I still don't know how to remove the footnotes produced by the auto TOC. It produces a long ugly "ndex-split N" at the end of the TOC.
    Any thoughts would be much appreciated.

    ReplyDelete
  4. please see http://manual.calibre-ebook.com/conversion.html#table-of-contents

    ReplyDelete