Contents | Start | End | Previous: Preface | Next: Chapter 2: Getting Started


Chapter 1: Introduction to Ebooks and Jutoh

In this chapter we explore ebook formats, and explain how Jutoh fits into the process of getting your book onto virtual shelves. We’ll take a look at how you get your content into Jutoh, and other tools that you can use alongside Jutoh.

Ebook formats

There are three major ebook formats in use today:

  1. Epub, an open standard supported by all non-Kindle reader devices.

  2. Kindle, a proprietary format specific to the Amazon Kindle but also supported on other devices.

  3. PDF (Portable Document Format), an Adobe proprietary format supported by most devices.

There are other formats, including plain text and HTML, but the Big Three above are the important ones.

Epub 2 is the industry standard with wide adoption, and is flexible enough for most ebook purposes. It’s basically a zip archive containing the content in XHTML form, plus ‘metadata’ that describes the content and provides navigation information. An Epub reader (such as Apple Books) tries to format the book in a standard way, but inevitably there are differences between implementations.

Most Epub ereaders handle Epub 2; the more advanced Epub 3 format does not have wide adoption yet, but there is software such as AZARDI and Readium that can read Epub 3. Jutoh supports a number of Epub 3 features, such as narration and interactivity via JavaScript.

Amazon bought and adopted the Mobipocket format for their Kindle devices. Mobipocket is like a cut-down version of Epub: in fact the Kindlegen application used to compile a Mobipocket book uses all the same files that you see in an Epub 2 book, distilling them to a proprietary format. However, the way a Mobipocket reader interprets the book is different from an Epub reader, with limitations on formatting that have to be borne in mind by the author, or worked around by the authoring software. Amazon’s new ‘KF8’ format eliminates many of these limitations, and Jutoh smooths over most of the differences between the two formats. Amazon now recommends creation and submission of .epub files instead of .mobi; Jutoh can create either .mobi files or Kindle-optimized .epub files.

PDF has always had a strong showing in ebooks on the desktop, because it can faithfully render the layout you see in publications such as brochures, with a direct translation from a conventional word processor file. However it is less satisfactory on mobile devices, because PDFs cannot generally be ‘reflowed’ to take advantage of small screens and requests for different type size. So on a small screen you end up having to zoom in and out and pan around the document. Clearly this is not a good general solution for reading books, unless you have a device with a particularly large screen, and even then you will have trouble adjusting the type size without content either disappearing off the screen or leaving blank areas. We will not say much more about PDF in this book, but suffice it to say that if you need to support PDF, Jutoh can help you create these files by generating ODT which you can load into OpenOffice or LibreOffice and from there, export to PDF.

Since Jutoh can handle all major ebook formats, it means that you can distribute your books for Apple Books on iPhone/iPod Touch/iPad, Amazon Kindle, any Android device, Kobo, Barnes & Noble Nook, and many other devices as well as for any PC or Mac.

What is Jutoh?

Jutoh is an editor for creating your ebooks; you can create a book from scratch in Jutoh, or you can import an existing book. As we’ve seen, Jutoh can generate the major ebook formats. Unlike most word processors, Jutoh divides ebook content into sections, which is more naturally suited to the way ebooks work. Jutoh is a bit like a word processor in that it supports content formatting, but it is geared towards generating a variety of ebook formats, with various tools to help with this task. You can add images to your documents, and (experimentally) sound and video where supported by the ebook reader.

For clarity, here are some things that Jutoh is not:

Jutoh helps you create a cover page for your book with the simple cover designer, which can substitute information from the metadata (title, author and so on) into the design. Create a design from scratch, or start from one of the templates provided by Jutoh.

Jutoh has facilities for compiling a table of contents and index, and can compile references either at the end of a section or in a separate section. You can of course create links between pages, and links to external web sites.

In addition, Jutoh contains tools to help collate research that doesn’t belong in your finished book – for example text and image scraps – and has its own desktop where you can put ‘sticky’ notes, shortcuts to applications and documents, and even little image slideshows.

Jutoh works on Windows, Mac OS X and Linux (one licence is good for any or all platforms, which is handy if you have a variety of machines), and it can be run from a USB drive. All information for a given Jutoh project is stored within a single file with extension ‘jutoh’ which makes for easy transfer and backup.

What kinds of book can be created with Jutoh?

Jutoh is good for most book types, including:

You can insert images into Jutoh, which can be photographic or artistic or could be used for symbols and decorative touches. Jutoh’s table support can be handy for scientific books; mathematic or other formulae aren’t supported but can be achieved by inserting pictures. As we said earlier, don’t expect the layout of a complex word processor document to be reproduced exactly, as if exporting to PDF.

Jutoh has experimental support for audio and video but these file types are not yet recognised by a wide variety of reader hardware and software and so should be approached with caution.

If you are feeling adventurous, you can explore Jutoh’s ‘form objects’ which allow addition of input controls for adding interactivity, in conjunction with JavaScript code. Jutoh also supports synchronisation of narration with book content. These features are supported by only a few ereaders at present.

The book creation lifecycle

These are roughly the steps involved in creating and distributing an ebook.

  1. Create a project, importing an existing file if you have one.

  2. Edit the book content, metadata and cover.

  3. Choose a configuration (approximately equivalent to the format) and compile the ebook.

  4. Check the file for errors, for example using EpubCheck.

  5. If there are errors shown by step 4, go to step 2.

  6. Preview the file manually. If there are errors, go to step 2.

  7. Upload to one or more web sites.

  8. Publicise.

  9. Bask in the adulation of your readers.

Steps 1 to 5 are supported directly by Jutoh. As you can see, there are elements of both file conversion and editing in Jutoh. If you’re really lucky, you could import a file and find there’s nothing to do except generate the ebook. Or you can create a project from scratch, and do all your editing in Jutoh (which is what I’m doing for this book). More usually, you’ll import some work you have already done, and massage the book in Jutoh until you’re happy with it, going around the loop between items 2 and 6. You’re likely to want to improve the presentation of the book by tweaking the formatting, creating a table of contents, and so on.

Because Jutoh runs on Windows, Mac, and Linux, you can use most desktop or notebook machines for your editing and even switch between them, since the Jutoh file format is portable (and a single Jutoh licence is good for any operating systems you may be using). Jutoh can run from a mobile drive; you can read more about that in the Appendix and in the user manual.

A question people often ask is: “Can Jutoh create an encrypted ebook?” The short answer is No, but in fact this would be a useless feature. The sites that you will be uploading your book to requires unencrypted content, and it’s the ebook vendor site (such as Amazon, Kobo, Barnes & Noble or Apple Books) that will be doing any encrypting. Unless you’re a big publishing company with a deal with Adobe, for example, you won’t be able to do any official encryption that can be recognised by any ebook readers. If you’re distributing the book yourself, probably the best policy is to make a virtue of the lack of encryption: customers tend to hate DRM (Digital Rights Management) and it restricts their freedom to use the book on different devices. So, just put a paragraph on the title page asking them politely not to copy the book in an unauthorised way. Any piracy that does happen may well boost your sales by increasing the buzz around your book. However, you can easily stop any person from freely downloading your commercial book from your own site, by signing up with a vendor service that serves a link to your book only after payment has been received.

How to get content into Jutoh

You can create a blank project, add book section sections, and type away. Or, you can import existing content. This is best done when you first create the project. You can import a folder containing multiple text and HTML documents, one file per book section, or you can import a single file containing one of these formats: plain text, DOCX, ODT, HTML, or Epub.

Note that Jutoh has a different internal representation from any of the formats it can import, and so it won’t preserve the document formatting 100%. This varies according to format. With HTML and Epub import, Jutoh will read just a basic level of CSS styling and you may need to do further style and content editing after import, depending on the complexity of the original CSS and HTML.

The preferred import format is DOCX (Microsoft Word XML) or ODT (Open Document Text). You can convert a variety of word processing formats (such as DOC) to DOCX or ODT simply by opening them in LibreOffice or OpenOffice (free downloads) and saving as DOCX or ODT. Most style information from the DOCX or ODT document will be preserved. If you have an older version of Word that doesn’t support DOCX, you can download the “Microsoft Office Compatibility Pack for Word, Excel, and PowerPoint File Formats” which at the time of writing can be downloaded from:

www.microsoft.com/en-us/download/details.aspx?id=3.

This will add the ability to open and save DOCX files.

For import of DOCX, ODT and HTML files, Jutoh will help you split the book into sections by matching against heading styles or content.

You can also import DOCX, ODT, HTML and text into an existing project using the File | Import | Import Document command.

For more information on importing, see Chapter 5: Importing Files.

Tools to use with Jutoh

No man is an island, and neither is Jutoh. These are some of the third-party tools you can use to help with your book creation.

EpubCheck, by Adobe, is a very useful checker for Epub files. It examines the HTML and XML files in your book and flags up errors, such as missing mandatory meta-data, ill-formed HTML, missing bookmarks, and so on. This tool is installed and configured by default with Jutoh; it needs Java to be installed on your system. Use the checker by clicking the Check button or by switching on Check Epub after compiling in the General Preferences dialog. You can get updated versions of EpubCheck from here:

https://github.com/IDPF/epubcheck/

Amazon’s Kindlegen can be used to create .mobi (Kindle) books, although it’s not necessary as Jutoh can create Kindle-optimized .epub files that can be opened in Kindle Previewer 3 and submitted to KDP. Configure Jutoh by going to the Helpers page in the Jutoh Preferences dialog and clicking on Help Me Install Kindlegen. Jutoh will install and configure Kindlegen for you if you have Kindle Previewer 3 installed (see below).

To preview your Epub book, you can install Adobe Digital Editions:

www.adobe.com/products/digitaleditions/

or other Epub viewer. Jutoh will launch the default application associated with the epub extension when you click on Launch. If you need to use several viewers and choose between them, you can add viewers in the Helpers page of the Jutoh Preferences dialog, by clicking on Configure, then Add. Type the name of the helper application, and browse for the command to use. Now when you click on the Launch button, Jutoh will offer you a menu of applications to use.

Similarly, to preview Kindle books, you can use Amazon’s Kindle for PC and Kindle for Mac:

www.amazon.com/kindle-dbs/fd/kcp

Formatting on this software can be different from on other devices, such as the Kindle device and iPhone/iPod Touch.

Amazon recommends that you preview your book with Kindle Previewer 3 for Windows or Mac:

www.amazon.com/kindlepublishing

This lets you select a number of different Kindle devices to test. You can install it and configure it for use with Jutoh when you install Kindlegen, by clicking on Help Me Install Kindlegen in Preferences/Helpers.

LibreOffice is a free download from:

www.libreoffice.org

It’s useful for converting Word and other word processor files to DOCX or ODT for import into Jutoh. If you plan to create ODT files with Jutoh, as well, you can use LibreOffice to convert your books to PDF, Word and other files. And of course, you may grow to enjoy it as a regular word processor instead of using one that costs a lot of money! You can also use OpenOffice, an earlier incarnation of LibreOffice, but LibreOffice has better Word support.

Summary

We have learned a little about ebook formats, what Jutoh is, the steps involved in getting a book to the point of distribution, what files Jutoh can import, and what other tools can be used alongside Jutoh. Next, we dive into an example of creating a project and creating an ebook.


Contents | Start | End | Previous: Preface | Next: Chapter 2: Getting Started