ebooks – Stillpoint Digital Press https://stillpointdigital.com The human face of digital publishing Wed, 17 Oct 2018 18:24:55 +0000 en-US hourly 1 https://wordpress.org/?v=5.2.2 https://i1.wp.com/stillpointdigital.com/wp-content/uploads/2015/08/Stillpoint-Enso-Logo-Red-55d2c0d1v1_site_icon.png?fit=32%2C32&ssl=1 ebooks – Stillpoint Digital Press https://stillpointdigital.com 32 32 Weekly Roundup — What’s new in digital publishing? https://stillpointdigital.com/weekly-roundup-whats-new-in-digital-publishing/ https://stillpointdigital.com/weekly-roundup-whats-new-in-digital-publishing/#respond Tue, 12 Jun 2018 19:57:59 +0000 http://stillpointdigital.com/?p=4027 Continue reading Weekly Roundup — What’s new in digital publishing? ]]> From a scandal that rocked the world of digital publishing to some nice, relaxing podcast recommendations, here’s our latest weekly roundup.

  1. Assuming you’ve been following the scandal around Kindle Unlimited abuser “Chance Carter,” you’ll probably be glad to hear his books have been removed from the platform (according, at least, to The Digital Reader)
  2. If you want to make money at publishing the old fashioned way (rather than scamming the system like chance), this article on how to choose a price for your eBook is a good place to start
  3. Facebook has been losing users left and right — but what does that mean for those of us who market our businesses using our Newsfeeds?
  4. Speaking of Facebook, if you’re interested in the digital side of marketing, this post about the future of eBook chatbots is certainly worth a read
  5. If you’ve been doing too much reading, consider resting your eyes and listen to some of these amazing podcasts about digital publishing (courtesy of State of Digital Publishing)
  6. Finally, looking for some book recommendations for the summer? It’s a rhetorical question: of course you are. Check out PW’s 2018 list for inspiration

Also, check out Stillpoint publisher/author David Kudler’s post on TheBookDesigner.com about the advantages and disadvantages of selling your ebook exclusively on Amazon!

Questions? Comments? Complaints? Leave them below, and we’ll get back to you

https://stillpointdigital.com/weekly-roundup-whats-new-in-digital-publishing/feed/ 0
Elements of Style: CSS for Ebooks https://stillpointdigital.com/css-for-ebooks/ https://stillpointdigital.com/css-for-ebooks/#respond Thu, 29 Mar 2018 12:34:40 +0000 http://stillpointdigital.com/?p=3908 Continue reading Elements of Style: CSS for Ebooks ]]>

I originally published this post on Joel Friedlander’s wonderful resource for self-publishers, TheBookDesigner.com

If HTML is the blueprint, showing how an ebook (or a web page) should be laid out, Cascading Style Sheets (CSS) are the interior design, saying how everything should look. While that may sound superficial, in fact learning to use CSS can have a profound impact on your ebook.

This is a somewhat complicated topic, so I am going to take three posts to cover it. This time round, I’m going to show you what CSS is and how to apply it. In the second post, I’m going to look at some of the different properties that you can use to define how your ebook looks. And in the last post, I’m going to talk about how to know which rules take precedence when.

CSS was created to define the presentation style to any XML document — but it’s most common use is in conjunction with the HTML in web pages and, of course, in ebooks. It’s what allows you to add color, to change fonts and (within reason) typefaces, to define where and how images display, and much more.

The Rule of Law

All CSS really comes down to is a series of rules that define how a particular element (or kind of element) will look when an ereader displays it.[1]

Each rule has two parts:

  1. A selector, which can be:
  • One or more type of HTML element (that is, any instance of a particular tag: <p>, <body>, <em>, etc.)
  • One or more class (that is, any elements that have been given the attribute class=”whatever”)
  • An element with a particular ID (that is, having the attribute id=”whatever”)
  1. A declaration — that is to say, one or more properties defining how the selector(s) should display

So here’s an example from the stylesheet file Styles/Styles.css in the “White Robes” ebook that I linked to a couple of posts back:

h1, .Text-break {color:darkred;}

That’s a lot simpler than it might at first look.

The part before the curly brackets ({}) marks the selector(s); there are two here, separated by a comma:

  • h1: If you look back to my last post, you’ll see that h1 marks the top-level section head — usually a chapter title.
  • .Text-break: This is a class — the name of a particular style. You can tell because of the period at the beginning. [2]

Sometimes you see these selectors combined. I could have marked the second one p.Text-break, because in fact it’s a style that I apply to whole paragraphs — in the case of “White Robes,” paragraphs that contain a single em-dash to be used as a separator between sections of text. But I don’t have to say what kind of element the class needs to be applied to (although that can sometimes be useful). By leaving the p off before the period, I could apply the same rule to other kinds of elements, if I wanted.

The part inside the curly brackets is the actual rule — the declaration. It contains a color property that tells the ereader to turn sections that match those selectors dark red. Simple, right?
Since there can be more than one rule per declaration, each declaration needs to end in a semicolon:

h1, .Text-break {color:darkred;font-weight:bold;}

I’ll get into more detail on some of the various rules that you care about in another post — sorry, this one is already complicated enough!

Location, location, location

Now there are three places you can place a CSS rule:

  1. Inline as part of an HTML tag
  2. In a <style> tag inside the <head> at the top of the HTML file
  3. In a linked CSS file, either in the ebook itself or on the open internet

Inline Style

If you want to apply a CSS style to just one HTML tag, you can do it inline by adding a style attribute to an HTML tag.

For example, if I were to want to center a particular paragraph, I could add style=”text-align:center” to the <p> tag, like so:

<p style=”text-align:center;”>

(Remember: those quotes must be “straight,” not “smart” or “curly.”)

Likewise, if I were to want to make a particular section (or <span>) of text in Garamond, I would do this:

Here is a phrase displayed as <span style=”font-family:Garamond;”>Garamond</span>.

Now, that would only work if Garamond were actually installed on the ereader or embedded in the ebook, so I added the generic serif, which tells the ereader to use its default serif typeface.

Notice that I don’t use a selector when using the style attribute. Since the declaration is inside a tag, it’s clear what the rule refers to. Make sense?

<style> Tag

You can do all sorts of wonderful things when you apply styles inline — but when you do, they will only apply to those tags where they’re added, and they will always apply there, until you search through and change them. (I know, setting all of the text to orange Comic Sans seemed like such a good idea!)

So how can you make your CSS styles more powerful and easier to edit?

Use global styles. These are the equivalent of the styles used in word-processing and page-layout apps — changing the style changes every part of the document to which the style has been applied.

There are two ways to do this in any HTML document — including one of the files that makes up your ebook.

The first is to add a <style></style> block to your file. As I said, it is placed in the <head> section of the file, and would look something like this:

<style type=”text/css”>
h1, .Text-break {color:darkred;}
p {color:black;}
#Green {color:green;}
<h1>This header is red</h1>
<p>This paragraph is black.</p>
<p class=”Text-break”>This paragraph is red!</p>
<p id=”Green”>This paragraph is green.</p>

Notice that the <style> tag should always include the attribute type=”text/css.” That tells the ereader that this is standard CSS.

That would display this way:

Now, notice that in addition to styling the <p> element black and the h1 element and the Text-break class red, I styled the paragraph with the id attribute Green as… you know, green.

Just as a period before the name tells us that the selector is a class, the pound sign (#) before the name lets us know that the selector is an ID. So in the style tag above, that looked like this:

#Green {color:green;}

By having a single set of declarations in the header, you can save yourself the trouble of adding the same rule over and over again, and then having to change every instance of it if you decide, for example, to make the .Text-break blue instead of red.

CSS Style Sheet

The third way to add style to your ebook’s HTML pages is to create one or more style sheets and link to them in the <head> section of each page.

This works just like having a <style></style> section at the top of your chapter — except the rules will apply not just in one file, but in all of them. This is especially important if you’re working on a longer, multi-chapter ebook.

First create an empty text file with the file type .css. In the “White Robes” ebook, I created the file Styles.css in the directory/folder Styles:

You can also create the file in whatever editing software you’re using. In Sigil, go to the File menu, and then select Add>Blank Stylesheet.

The contents of the file looks almost exactly like the <style type=”text/css”> section I showed you above. Here’s the style sheet from “White Robes”:

Some of those rules might make sense to you; most of them won’t. Don’t worry; the next post will be a primer on some of the most important rules and properties.

Oh — notice that each property in the declaration section (the part inside the curly brackets) is on its own line. Just as in HTML, those line breaks are meaningless. What separates one property from the next is, as I said above, a semicolon. So Sigil puts each rule on its own line for no reason other than making it easier to read.

Also, something important: in CSS, the rule closer to the bottom has priority. So notice in the third rule that says that a whole bunch of different kinds of HTML elements, including the body element will have no margin, no padding, and no border width.[3]

Then the very next rule sets the padding (that is, the space inside the edge of the element before words and images can show up) to five pixels.[4]

Because the second <body> declaration is closer to the bottom, it takes priority. The rule means that every page in the ebook will have a thin white space around the outside edge of the screen or window.

(Prioritization — which rules apply in which cases — is a complicated issue. I will get to it in the third and final post on CSS.)

Okay, so you’ve got a style sheet. But if it’s not linked from the XHTML file, those files won’t show up at all!

So you’ve got to add a <link> element to the <header> block of each XHTML file (that is, chapter) in your ebook to which you want to style sheet to apply.

The link element looks like this:

<link href=”../Styles/Styles.css” rel=”stylesheet” type=”text/css”/>

That tells the ereader to look for the file Styles.css in the directory Styles (just where I put it); it tells the ereader that the relationship between the files is that Styles.css is a style sheet for the current XHTML file, and that’s it’s a CSS file.

Once you’ve added that link, all of the formatting that you’ve defined in the sheet will be applied to your now-beautiful chapters.

So, that’s our quick introduction to CSS.

Next time, I’ll run through some of the most important properties that you can define using CSS, and after that, I’ll finish up with a quick overview of style priorities.

Like this post? Sign up for my newsletter, and you’ll get my ebook An Indie Publisher’s Intro to Ebooks for free!

[1] Remember: an element is a block of HTML, usually set off at the beginning and end by open and close tags, like this: <tag>[stuff]</tag>

[2] By the way, you can apply multiple classes to a single element — just separate them with a space: class=”red small-caps”. Two things to keep in mind: First, the later class will take precedence, so if I added a class attribute with the values red and blue, the text would display as blue, since the blue class came last. Second, some older ereaders don’t handle multiple classes well (I’m looking at you, old-style Kindle). I usually try to stick to one class per element for that reason.

[3] You’ll often see a rule like this at (or near) the top of a style sheet; it’s called zeroing out or initialization. It makes sure that there isn’t any carry-over from the ereader’s default settings or other styles.

[4] Yeah, it looks like it’s stuttering; the four 5px values apply to the top, right, bottom, and left padding, in that order. That allows you to customize the spacing between elements quite a lot.

https://stillpointdigital.com/css-for-ebooks/feed/ 0
Weekly Roundup – 6 Fresh Topics in Ebook Publishing https://stillpointdigital.com/weekly-roundup/ https://stillpointdigital.com/weekly-roundup/#respond Tue, 27 Mar 2018 12:44:26 +0000 http://stillpointdigital.com/?p=3894 Continue reading Weekly Roundup – 6 Fresh Topics in Ebook Publishing ]]> Don’t call it a comeback! Here’s the second installment in our now weekly roundup of interesting articles in the world of eBook publishing. 

  1. Whether you’re an up-and-coming young author or an old hat, Derek Haines’ article on the basics of online publication will surely be of interest.
  2. Everyone knows that knowledge is power, but fewer of us know how to wield it. That’s where this PublishDrive article on smart metadata comes in.
  3. It’s always nice to support a fellow digital publisher — so whether or not you download her eBook, give Kristen Hick’s piece about Advanced SEO a read.
  4. Speaking of SEO, this online marketing post aimed at local business owners is worth scrolling through for anyone trying to boost their small publishing business.
  5. Those of us who work in the creative world know just how damaging piracy can be. That’s why Switzerland’s eBook piracy solution more than piqued my interest.
  6. Last but certainly not least, if you’ve been following the data abuse allegations against Facebook, this think piece about the online publishing realm should certainly interest you.

Also, do check out a couple of my own posts:

That’s it for this week! Questions or comments? Leave them below, and we’ll happily get back to you.

https://stillpointdigital.com/weekly-roundup/feed/ 0
Speaking in Code: Ebook HTML basics https://stillpointdigital.com/speaking-in-code-ebook-html-basics/ https://stillpointdigital.com/speaking-in-code-ebook-html-basics/#comments Sat, 24 Mar 2018 15:23:54 +0000 http://stillpointdigital.com/?p=3857 Continue reading Speaking in Code: Ebook HTML basics ]]> This post originally appeared on Joel Friedlander’s wonderful site, TheBookDesigner.com.

If, as I keep saying, an ebook is just a website a box, then in order to know how to get in and edit your ebook, you’re going to want to know some HTML. However you choose to work on the file, knowing the basic building blocks is essential in creating a finished  product that presents your book to its best advantage.


When we talk about HTML, we’re actually talking about two separate things:


  1. HyperText Markup Language (HTML): The code that makes up every web page you’ve ever seen. This is how we’ll add content to the ebook. That’s what the rest of this post is going to be about.
  2. Cascading Style Sheets (CSS): This is a set of rules for defining how everything looks. It’s how we’ll format the ebook — and that’s what I’m going to be covering in the next post.



Calling HTML the basic building blocks of an ebook is apt in more ways than one. Not only is the markup language the fundamental tool for writing and displaying web and ebook content, but it’s also set up as a series of containers — not unlike the nested building blocks that we used to build with as children. Sometimes they’re piled one on top of the other; sometimes one (or a group) is inside another.


Every one of those “blocks” is set off before and after by tags, each of which is marked by angle brackets (< and >). The beginning of a block is marked by an open tag that looks like this: <tag>. That tag ends with a close tag that looks like this: </tag>. All of the content between those tags is said to be part of that container.


So you’d start a paragraph with the <p> tag and end it with the </p> tag:


<p>It is a truth universally acknowledged that a single man of good fortune must be in want of a wife.</p>


The tags will set that chunk of text off as a paragraph. Here’s how that would lock: 


Screenshot 2016-09-08 09.39.56.png


Simple, right?


Now, to make things just a bit more complicated, tags can also take what are called attributes, which tell the ereader how to treat certain tags.


An attribute is always added by including the attribute name, an equal sign, straight quotes, and a value. Here’s the same paragraph tag with an attribute added:


<p align=”right”>It is a truth universally acknowledged that a single man of good fortune must be in want of a wife.</p>


I wonder what that align attribute would do?


Screenshot 2016-09-08 10.38.59.png


What a surprise! I could also have had the attribute read left, justify, or center.[1]


One warning: make sure that the quote marks around the attribute value are straight (i.e., “right”) and not “smart” or “curly” quotes (i.e., “right”). Otherwise the ereader won’t know what it’s looking at and your ebook will break.[2]


Now there are (very basically) two kinds of tags: block tags and inline tags.[3] Containers set off by block tags need not be placed inside other containers.[4] Containers set off by inline tags are always placed inside other containers.


Block Tags

I told you “block” was an appropriate metaphor in more ways than one!


Block tags create self-contained blocks of text — like paragraphs (<p></p>) or articles (<article></article>). Many of them can used at the “root level” of the page — as I said, they need not be inside any other tag (other than the <html> and <body> tags that I’ll talk about later). Many of them can be nested that is, placed inside another block tag.


Note that when you nest tags, you must always close the most recently opened tag first. Here’s an example



<p>It is a truth universally acknowledged that a single man of good fortune must be in want of a wife.</p>



Notice that I couldn’t put the end-of-article tag (</article>) until I’d put the end-of-paragraph tag (</p>).


(The <article> tag is part of HTML5, the newest version of HTML in use in web and ebook design.)


Now, in HTML, hitting the RETURN key doesn’t create a new paragraph as you might expect. Some HTML and ePub editing software will take care of that for you by automatically adding paragraph tags (<p></p>) around your text. If you are used to using a blogging system like WordPress, you probably weren’t even aware that those tags were getting added.


When you’re working on the raw HTML in an ebook, however, you don’t get those training wheels.


And unless there’s a tag, the text will simply continue to flow. For example:


<p>It is a truth universally acknowledged


that a single man of good fortune must be in want of a wife.</p>


would display as:


Screenshot 2016-09-08 09.39.56.png

In other words, it would look exactly the same as if the line breaks hadn’t been there.


The advantage to this is that you can place the tags on separate lines of code from the text, which makes it easier to see what tags are still open. Web programming conventions encourage us to indent each nested tag, to make it even easier to see what’s going on:




It is a truth universally acknowledged that a single man of good fortune must be in want of a wife.



However little known the feelings or views of such a man may be on his first entering a neighborhood, this truth is so well fixed in the minds of the surrounding families, that he is considered to be the rightful property of some one or other of their daughters.




Here’s how that would look:


Screenshot 2016-09-08 09.49.32.png


The indentation in the code makes it easier to see which blocks are inside which, and can be invaluable when it comes time to debug (see below). As the example showed, it won’t be displayed as part of the ebook. Nor will the white space between the paragraphs. The only things that will create a space between paragraphs in a web page (or an ebook) is a block tag.


More Block Tags

We’ve seen the most commonly used block tag, the wonderful paragraph tag (<p></p>).


Here are some more commonly used block tags:



This creates a block quote or extract. Usually this text is displayed in a smaller font size and indented further — but this can be controlled through CSS. You can have multiple paragraphs inside a block quote:


This quote is from Jane Austen’s masterpiece:




It is a truth universally acknowledged that a single man of good fortune must be in want of a wife



However little known the feelings or views of such a man may be on his first entering a neighborhood, this truth is so well fixed in the minds of the surrounding families, that he is considered to be the rightful property of some one or other of their daughters.




Here’s how that would look:

Screenshot 2016-09-08 09.53.30.png



This creates a table structure. To set off the rows and cells in a table you need further tags (note that tables are not accepted by some retailers and therefore are semi-deprecated; for another way to create the same effect, use the CSS float property, which I’ll discuss in later posts):


This creates a table row. This must appear inside of a <table> block.



This creates a table cell. These are always inside a <tr> block.



This creates a header cell, which behaves just like a regular (<td>) cell, but can be formatted differently


Here’s an example of a basic table:



<th>Pride and Prejudice</th>




<p>It is a truth universally acknowledged that a single man of good fortune must be in want of a wife</p>



<p>However little known the feelings or views of such a man may be on his first entering a neighborhood, this truth is so well fixed in the minds of the surrounding families, that he is considered to be the rightful property of some one or other of their daughters.</p>





And here’s how that would look:


Screenshot 2016-09-08 10.08.51.png


Notice that the paragraphs are side by side now, instead of stacked one on top of the other. That’s because they’re part of the same row (<tr></tr>) block.



This is the tag to identify the most important header on a page. Traditionally, there should be only one per “page. In ePub coding, this is often the tag used for a chapter title:


<h1>Pride and Prejudice</h1>

<p>It is a truth universally acknowledged that a single man of good fortune must be in want of a wife.</p>

<p>However little known the feelings or views of such a man may be on his first entering a neighborhood, this truth is so well fixed in the minds of the surrounding families, that he is considered to be the rightful property of some one or other of their daughters.</p>



Here’s how that would look:

Screenshot 2016-09-08 10.17.06.png

<h2></h2>, <h3></h3>, etc.:

These tags set off lower-priority headings — chapter sub-titles, section heads, etc. (In publishing parlance, these are called A heads, B heads, and so on.)


<h1>Pride and Prejudice</h1>

<h2>Chapter One</h2>

<p>It is a truth universally acknowledged that a single man of good fortune must be in want of a wife.</p>

<p>However little known the feelings or views of such a man may be on his first entering a neighborhood, this truth is so well fixed in the minds of the surrounding families, that he is considered to be the rightful property of some one or other of their daughters.</p>



Here’s how that would look:

Screenshot 2016-09-08 10.21.13.png


This displays a horizontal rule — a line that divides the page horizontally. Note that, since there isn’t ever any text between the open and close tags, you can combine them: <hr/>



Creates a line break — not a full paragraph break, but a forced move to the next line. To be honest, these are a last resort; you’re often better off using another block tag.


As with the <hr/> tag, the open and close tags are usually combined: <br/>


<img src=[file location] alt=A description of the image></img>:

This tag will display an image.


The source (src) attribute tells the ebook reader where to look for the image file. The file location will either be a URL (on the open web — it will look like this: http://website.com/image.jpg) or a URI (a file inside the ebook or web page’s local file structure — it will look something like this: ../Images/image.jpg).[5]


The alt attribute gives the image a text description, which is important, for example, when sight-impaired readers use text-to-speech to have the book read aloud. It should also display if you have attempted to display an image from the internet and the ereader isn’t connected.


As with the <hr/> and <br/> tags, the open and close tags are usually combined: <img src=”[location] alt=[description]/>



There are a lot of other HTML block tags that you can use — especially in the newer ePub3 ebook standard — such as <frontmatter></frontmatter>, <chapter></chapter>, and many more. However, they are not frequently used at this point, and aren’t crucial to creating a well-designed ebook. If you would like to learn more about them, check out the IDPF accessibility guidelines, which offer a wonderful overview of the ePub3 format.


Now, I left out three mandatory block tags that appear in every ePub file, the <html></html>, <head></head> and <body></body> tags. The <html> tag is always the outermost block. The <head> and <body> tags are nested immediately inside, with the <head> tag coming before the <body> tag. To be complete, a file must look something like this:







<h1>Pride and Prejudice</h1>

<h2>Chapter One</h2>

<p>It is a truth universally acknowledged that a single man of good fortune must be in want of a wife.</p>

<p>However little known the feelings or views of such a man may be on his first entering a neighborhood, this truth is so well fixed in the minds of the surrounding families, that he is considered to be the rightful property of some one or other of their daughters.</p>





That’s now an actual, complete HTML page! If you copy and past that into a text editor and save it with the file type html, you can open it with your web browser. Go you!


By the way, did you see the <!- and > tags in the header? Those mark the beginning and end of a comment — a coder’s note that isn’t intended to be displayed. They’re very useful both for keeping notes within the code, but also for finding where problems may originate. I’ll talk about that in future posts. 


We’d have to add a couple of things to make that code ebook-ready — I’ll be going into those in detail next time — but you could take that same file and import it into an ebook, and it would display perfectly.[6]


Inline Tags

These HTML tags are largely used for formatting. Many of them are used with CSS to help make them look pretty, and so I won’t touch on those this time.


These tags always appear nested inside of a block tag — usually a paragraph (<p></p>). A few that are important and incredibly useful are these:



You put this tag around text to make it bold. The older version of the tag (<b></b>) still works but is no longer recommended. Why? Well, what happens when you place one <strong> section inside another? Usually it’s just bolded — but some fonts or styles have additional changes that can be made.



You put this tag around text to make it italic. Again, the older version of the tag (<i></i>) still works, but is deprecated. Nested <em> tags can do some nifty things. When you put one <em> tag inside another — as in a foreign word or a book title inside of an italicized section the inner text will display not as italic, but as roman (regular) type. (This won’t work on every browser or ereader, but it’s nice when it does.)


<a href=[file location]></a>:

This is the tag that made the web what it is and that makes an ebook unlike its print cousin: the hyperlink. Anything within the tag — whether it’s actual text or an image tag — becomes a link.[7]


You can either link to an outside web page (a URL) or link to a file (or location within a file) within the file structure of your ebook (a URI).


Here’s how you’d create a hyperlink:


<h3>Read about <a href=http://janeausten.org”>Jane Austen</a></h3>


And it would look something like this:


Screenshot 2016-09-08 11.26.39.png



This makes the text superscript — that is, it shifts the text up (and usually makes it smaller).



This makes the text subscript — that is, it shifts the text down (and, again, usually makes it smaller).



This defines a section within a block of text. It can be used for identification purposes, or, most commonly, for formatting the text. We’ll be going into this one in depth next time.


Identity code: the ID attribute

By the way, by adding an id attribute, you can turn any of these tags into anchors — locations within the file. You point an <a> tag at the anchor by adding a pound sign (#) and the id to the file location in the href attribute.


So let’s say we gave an image file an id of image (imaginative, right?):


<img src=../Images/Image.jpg” alt=”Image” id=”image/>


If I wanted to link to the location of the image in a file, I’d create a hyperlink:


<a href=../Text/Page.html#image>Click to see the image</a>


By the way, each id must be unique in the file — you can’t have more than one id=image”.


You can use this to create back-and-forth reciprocal links — something I do all the time when I’m creating footnotes (like, say, the ones in this post). Each <a> gets its own id; you link back and forth. Let’s say you put this into the file chapter1.html:


<p>”Here’s a quote!”<a href=../Text/notes.html#note-1” id=”note-reference-1″><sup>NOTE 1</sup></a>


and this into the file notes.html:


<p><a href=../Text/chapter1.html#note-reference-1 id=“note-1″>Note 1</a> — A note about the quote!</p>


You would be able to click on the footnote link after the quote to go to the note, and then click on link at the beginning of the note to go back to the quote. Whew!


Obviously, there’s a lot more to learn about HTML. A great free resource is the online reference W3Schools.com. They’ve got a complete and up-to-date listing of every tag, attribute, and weird wrinkle — not just for HTML, but for CSS and Javascript. There are tutorials, examples, and all sorts of great information.[8]


Next time, I’ll be talking about how to make our ebooks beautiful. Time to bring on the style!

[1] Okay. So the align attribute is deprecated — that means it’s essentially obsolete and shouldn’t be used. There are better ways to handle alignment, as we’ll learn in the posts on CSS!

[2] This is why I don’t edit code in word processing software like Microsoft Word or OpenOffice.

[3] Okay. So block and inline are also possible values for the display attribute. As is block-inline (!), none, and a few more. But honestly? You don’t care about that yet. You may never.

[4] Though many of them can be.

[5] See the discussion on what’s inside of an ebook for my discussion on URIs and URLs.

[6] It would display, but it wouldn’t validate — you couldn’t open the file on an ereader.

[7] You know all of those buttons you’ve been clicking on on web pages and in apps? Those are just images with hyperlink tags around them. (Well, okay, sometimes they’re more complicated than that — but that’s the concept.)

[8] Just remember, when you’re researching for ebooks, you want to use the latest HTML5 syntax. And the W3Schools references will always let you know if a tag is no longer recommended.

https://stillpointdigital.com/speaking-in-code-ebook-html-basics/feed/ 1
Weekly Roundup: 7 Interesting Articles on eBook Publishing https://stillpointdigital.com/7-interesting-articles-on-ebook-publishing/ https://stillpointdigital.com/7-interesting-articles-on-ebook-publishing/#respond Tue, 20 Mar 2018 18:47:57 +0000 http://stillpointdigital.com/?p=3819 Continue reading Weekly Roundup: 7 Interesting Articles on eBook Publishing ]]> As a matter of principal (both personal and professional) I spend quite a bit of my time keeping up to date with what’s new in the eBook publishing world. Having built up a relatively substantial feed to scroll through, it recently occurred to me that I’m not the only one who could benefit from a list of new ePublishing articles  to peruse while I’m going about my day.

With that in mind, I’ve decided to start publishing a weekly list of recent articles I think are important, interesting, innovative, etc. Here are this week’s choices:

    1. In a sequel to his universally useful article on what not to do during a book launch, Draft2Digital’s Kevin Tumilson wrote this piece with a slightly more positive spin.
    2. When it comes to the ebook business model, most of us are still figuring out our own best practices — which is exactly why you should check out Bradley Metrock’s interview with Scribd about their switch to an unlimited subscription service.
    3. Fascinated by all things digital? Then this article detailing a fully-automated bookstore opening in Beijing is sure to be right up your alley.
    4. I’m sure you’re familiar with the aphorism “the customer is king.” So is Kevin Callahan, who recently published this no-nonsense article  on how to improve your user experience.
    5. Along the same user-facing vein, there are few things more important to a publisher than a good marketing strategy — luckily, thanks to Therese Walsh’s wisdom, your preorder books will be in good hands.
    6. As ebook lovers, we never get tired of defending our beloved and highly-portable form of reading — which is why this article in defense of ebooks is a particularly uplifting read.
    7. Last but not least, as an editor I couldn’t help but include this succinct but informative article on how to choose (and use!) the right editor for your self-published book.

  1. That’s it for this week! I hope you enjoyed the articles – feel free to share your thoughts in the comments below.


https://stillpointdigital.com/7-interesting-articles-on-ebook-publishing/feed/ 0
Inside the Box: The Anatomy of an Ebook https://stillpointdigital.com/3538-2/ https://stillpointdigital.com/3538-2/#respond Fri, 03 Feb 2017 14:20:31 +0000 http://stillpointdigital.com/?p=3538 Continue reading Inside the Box: The Anatomy of an Ebook ]]>

Over the next few posts, I’ll be showing you how ebooks are coded and formatted. We’ll look at the anatomy of an ebook, and what makes it tick.

You’ve heard me call an ebook a website in a box. This time we’re going to talk about what’s inside the box.

First thing’s first: let me share an ebook with you. It’s the ePub file for a short story of mine called White Robes.

You’re welcome to read it, obviously, but for the purposes of this post (and the next two), we’re going to be opening up the box and dissecting the ebook.

This is the actual production file that I’ve uploaded to Amazon, by the way — it includes all of the coding and formatting that I typically include in creating an ebook. It will be the model that I’ll be using over the next few posts in discussing an ebook’s innards.

Opening the Box

What we’re going to look this time is the structure of the ebook — the collection of files that an ePub-ready ereader like Apple’s iBooks or Barnes & Noble’s Nook or Readium or Calibre or any of thousands of other apps can open.[1]

So now we have our website in a box. Let’s open the box and see what we’ve got![2]

There are just three steps:

  1. Duplicate your file (Never work on the original!)
  2. Convert the file ZIP format
  3. UnZIP the file

Step 1: Duplicate your file

Now, I’m going to assume that you’re using a Windows or Mac computer.[3]

We’re duplicating the file so that the original doesn’t get destroyed. Just a good habit to stay in, right?

In Windows, select the file in Windows Explorer by dragging over it or left-clicking on it once. From the Organize menu at the top of the window, select Copy. (You can do the same thing by right-clicking on the file and selecting Copy.)

In Mac OS X, select the file in the Finder by dragging over it or clicking on it once. Now hit command-D or go to the File menu and select Duplicate. (You can also control-click/right-click on the file and select Duplicate.)

You should now have a duplicate copy of the file:

Step 2: Convert to ZIP format

This is actually a much simpler process than you might think: an ePub file is just a carefully constructed ZIP archive with a different extension (the last three or four letters at the end of the file name).

If you don’t see the .epub extension at the end of your new file, click on/drag over the file to select it.

In Windows, go to the Organize menu and select Folder and Search Options. De-select the Hide known file extensions option. Click OK.

In Mac OS X, go to the File menu and select Get Info or hit command-I. If not already open, click on the triangle next to the Name and Extension heading to reveal the Hide extension option and deselect it. Close the Info window.

Now rename the file.

In Windows, right-click the file name and select Rename (or left-click and hold down the button for one second). Double-click the epub file extension (not including the period!) and replace it with the extension zip. Hit the Enter button.

In Mac OS X, click once on the file and hit the Return button. Double-click the epub file extension (not including the period!) and replace it with the extension zip. Hit the Return button.

Voilà! You’ve turned your ePub ebook into a ZIP archive.

Step 3: UnZIP the file

Whether you’ve got a Mac or Windows computer, you can simply double-click on the file now to expand the archive, turning it into a regular folder/directory on your desktop.

What’s inside the Box?

What’s inside, you ask?

Well, the first thing you’ll see is two more directories (we’ll talk about those in a minute) and a file called mimetype.

The mimetype file is a one-line piece of code that lets the ereader know what kind of file it’s reading — and that one line always reads as follows:


It’s telling the ereader that, in fact, this is an ePub file wrapped inside a ZIP archive. As if we didn’t already know that.

How about those two folders?

Well, one of them isn’t any more exciting. The META-INF folder usually contains just one file (container.xml),[4] and its sole purpose is to tell the ereader where to find the all-important OPF file. The OPF file is the traffic cop for the ebook, telling the ereader where to find everything, and what everything is. The folder where the OPF is located is called the root directory.

Sometimes the OPF is actually on the outermost level of the archive. Most often, however, you’ll find it in the OEBPS folder.

The root of the ebook: the OEBPS folder

OEBPS (Open eBook Publication Structure) is an XML-based specification for the content, structure, and presentation of electronic books. It is the blueprint on which any ePub file is built.

The OEBPS folder in any ebook will contain a number of important files, including our friend the OPS file, as well as a number of folders we’ll look at later.

Here’s the White Robes OEBPS folder:

Remember: this is the root directory. Every file reference given in the ebook will be given relative to this folder.

Now the two files are of great interest:

  1. The OPF file is our traffic cop
  2. The NCX is the navigation file[5]

The traffic cop: The OPF file

OPF stands for Open Packaging Format — so you’ll sometimes see the OPF referred to as the Package File. It contains all of the bibliographic and structural information about your ebook: what it is and where it is.

You can open the OPF file in any text-editing software like Notepad or TextEdit (or TextWrangler or BBEdit or whatever)[6]

Like all of the files in an ebook,[7] the OPF file is an XML file. That means that it’s a very carefully constructed set of data, set off in series of tags, each of which has an opening and closing version, that are (almost always) used in pairs around the data, like this: <tag>[DATA]</tag>

The version of the tag that starts with a forward slash (</tag>) is called the close tag.

The two important things to remember with XML tags:

  1. You can nest them (place one inside another like Russian dolls
  2. You always have to close the most recently opened tag first

Here’s how that works:

<outer tag><inner tag>[DATA]</inner tag></outer tag>

Did you see what I did there? The <inner tag> went inside of the <outer tag> — and I had to close the  </inner tag> before I closed the </outer tag>

Because of the way XML works, every thing that applies to the <outer tag> applies to <inner tag> unless the inner tag states otherwise. That’s called cascading, and will become more important when we talk about the Cascading Style Sheets (CSS) and the HTML code that makes up most of an ebook’s content.[8]

Warning: Feel free to poke around in the OPF file for White Robes. However, unless you are really confident in what you’re doing, I highly recommend not messing around with the OPF file in an ebook you’re preparing for publication. The file is created and updated automatically by the conversion/editing software that you’re using — making changes by hand without knowing what you’re doing can break your ebook.[9]

The OPF file is made of a header that identifies the kind of file that it is (the XML and package tags in lines 1–2), and then as many as four sections:

  1. The metadata section, which tells the ereader information about your book
  2. The manifest section, which tells the ereader where to find everything (listing every file contained in the ebook and its address)
  3. The spine section, which tells the ereader in what order it should display files (optional)
  4. The guide section, which tells the ereader where to find “special” files like the cover (optional)

Here’s the OPF file for White Robes:[10]

Boy, that’s a lot of stuff going on for one short story!

One interesting bit: in line 2 (along with a lot of other very important but opaque stuff) you can see the attribute version=”3.0″ This tells us that this is an ePub3 file. If the version number had been 2.0… Well, you can probably guess: it would be an ePub2 file.

There are a number of other major differences between the two types of ePub file, but that’s the flag that tells an ereader to treat this file as one kind of ePub or the other.

Many of the lines begin with an open tag and end with a close tag. A number don’t. They fall into two categories:

  1. Some contain all of the data within the tag — for example, all of the item tags (lines 22–56). In that case, rather than have two separate tags with nothing between them (i.e., <item href=[…]></item>) XML convention allows you to close the tag by putting a slash at the end of the open tag: <item href=[…]/>
  2. When a tag has one or more tags nested within it. For example, look at the guide tag, on line 72. There’s a reference tag on  line 73 before the guide close tag on line 74.

Each type of tag, from the various dc: (Dublin Core) metadata tags to the itemref tags, has an extremely specific syntax, and learning that is more than I could teach (or you would want to learn) here. However, you can find out more (much more) at the International Digital Publishing Forum page on OPF files. (The IDPF is the trade group responsible for the ePub format.)

One other thing that you might notice here: the addresses. Everything after an href or src attribute is a reference to a file within the ebook’s file structure. It’s exactly like one of the URLs we’re used to typing into the address bar at the top of our browser window to go to a particular web page. The only difference is that where a URL (uniform resource locator) has to give an address on the open internet, and must contain the protocol for the browser to use when it gets there (i.e., http://, ftp://, or mailto:), these addresses are always relative to the current document — they’re what are called URIs — uniform resource identifiers. They don’t include the protocol — and they have to be somewhere in the current file structure of the ebook (or web page). So for instance, on line 27, there’s a reference to where to find my headshot. The URI reads Images/headshot.jpg. That tells the ereader to look inside the Images folder for the file called headshot.jpg.[11]

Note that capitalization and spelling must be precisely correct. Headshot.jpg is not the same as headshot.jpg.

The roadmap: The NCX file

The other file that almost always appears in the root directory is the NCX or navigation file.

If you’ve ever read an ebook (and if you haven’t, you really should, if only so that you can understand what your readers’ experience!), you’ll know that there’s a pull-down table of contents — not the contents page at the front or back of the book, but a menu available wherever you are, so that you can navigate to wherever you want to go in the book. It looks something like this:

In ePub3, that menu is pulled from the table of contents page in your ebook — it’s essentially a slightly marked-up HTML page. In ePub2, you needed to create a separate file (the NCX file) to tell the ereader what to display.

Now, ePub3 is great — but not all ereaders can display it, especially the older ones. And so, for backwards compatibility (that is, so that newer software can run on older machines), it’s still a really good idea to include an ePub2-style NCX page.

Here’s what the NCX page for White Robes looks like:

Notice that each item in the table of contents (everything inside the navMap tags) is in its own set of navPoint tags, and that the navLabel and text tags tell the ereader what to display in the menu while the content tag shows what file to send the reader to when they click on the item.

Like the OPF file, most ebook-conversion and creation software will take care of this for you — but it’s good to know what’s there, in case a problem should come up.

All together now: The rest of the files

Let’s look at the OEBPS folder again:

You’ll see our friends the OPF and NCX files. And then there’s all of the rest of those folders. Sigil organizes all of the files neatly so that they’re easy to find: fonts in the Fonts folder, images in the Images folder, stylesheets in the Styles folder, and so forth. (Don’t forget to capitalize correctly!)

Here are the contents of the Images folder for White Robes:

Notice that all of the image files are there — the cover, the map, and all of the little images (including covers of other books) that are scattered throughout. Notice too that I’ve optimized those images so they’re fairly small.[12]

The fonts in the Fonts folder are ones that I have the right to use in ebooks in this case, they’ve been released into the public domain. They’re also OTF fonts (Microsoft’s OpenType font standard), which are the only ones that will work with most ereaders (and even then, not always).

There’s an XML file in the Misc folder that tells the ereader I’ve got custom fonts on board.

There’s a CSS stylesheet in the Styles folder. I’ll get to that in a couple of posts, I promise — and it will a lot more hands on than this one!

Last but not least we find the actual body of the ebook, the (X)HTML files, in the Text folder:

Note that they’re in alphabetical order — but that’s not how they’re displayed in the book. Remember the spine section of the OPF file? Yup. That’s what defines the order.

In any case, next month, we’re going to look at how those files are built!

Clean Up

That’s all for now. But if you want to clean up the files you’ve been poking around in, just go back until you see the folder that contained the ebook:

In Windows, select the folder (“ebook-sample-White-Robes-copy”), right-click on it, and then select Send to, and then Compressed (zipped) folder. Then change the extension back to .epub.

For Macs, this part is a bit more complicated; OS X adds invisible files that mess with the ePub file structure. The easiest way to re-ZIP the ebook is to use a little freeware script called Zip/Unzip. It’s not a new script (version 3 is at least five years old), but it still works wonderfully. Drag your file onto the script, and it will take care of re-compressing your folder and renaming the archive with the proper .epub extension.


[1] Not Kindle. As we’ve discussed, Amazon’s Kindles and Kindle apps use proprietary file formats. You can convert an ePub file to Kindle formats, but you can’t open up a Kindle file and poke around inside the way we’re going to be doing here, so I won’t bother including a Kindle version of the file. However, just to repeat what I’ve pointed out before, this ePub file is the best format to upload to Amazon! (Please don’t upload this one, though — it’s mine!)

[2] Okay: you don’t have to do this to create/edit ebooks. You can in fact get at the files inside of an ebook without opening it up using applications like Sigil and Calibre. You can even look at the file structure and edit individual files in those apps. We’re doing this the old-fashioned way, however. Think of this as a high-school science lab, only instead of slicing open a frog, you’re opening up an ePub file. Much less messy!

[3] Linux users are usually pretty savvy and don’t need instructions on how to manipulate files. As for iOS and Android users… Well, opening up and editing an ebook on a tablet or phone isn’t yet terribly practical. It can be done, but it isn’t fun, so I don’t recommend it.

[4] Okay: occasionally there is another file or two — often put there to let the ereader know that there are fonts or other special files on board. But that’s advanced stuff for another day.

[5] This is necessary only for ePub2 files — however, it’s good to include one in ePub3 files, so that older ereaders can open them.

[6] But not a word-processing app like Microsoft Word! Word, etc., will turn all of the quotation marks to “curly” or “smart” quotes — which will render the files useless.

[7] Excepting media files (like images, video, and audio), scripts, fonts, or CSS files — but more on those a couple of posts from now. By the way, aside from the media files, most of the files on your computer are probably some flavor of XML (or packages of XML files).

[8] HTML is simply a form of XML that has been adapted for displaying web pages.

[9] If you’d like to know more about the workings of the OPF file, I recommend going to the IDPF.org pages for the ePub2 and ePub3 formats, or check out Liz Castro’s great nuts-and-bolts intro to ePub creation ePub: Straight and to the Point or Jared Buse’s ePub from the Ground Up, which is a bit more up-to-date, and touches more on ePub3.

[10] Screenshots taken in Sigil. The indentation and coloring should help you see what goes with what.

[11] You want fine distinctions? Images/headshot.jpg tells the ereader to look inside the folder Images inside the current folder. /Images/headshot.jpg (see the slash at the beginning?) tells the ereader to look for the Images folder in the root directory —which it is in this case, but might not be in other cases. The most common way to look for a file in a different folder? Use this syntax: ../Images/headshot.jpg. That tells the ereader to go up one folder, look for the Images folder, and then find the file headshot.jpg. Whew!

[12] I almost always optimize after I’ve imported the files — this is a major reason that I open up ePub files like this.

Image: Danboard Package Received by Louish Pixel @ flickr. Used through a Creative Commons license.


https://stillpointdigital.com/3538-2/feed/ 0
The Ebook Retail Universe https://stillpointdigital.com/ebook-retail-universe/ https://stillpointdigital.com/ebook-retail-universe/#respond Fri, 10 Jun 2016 15:14:32 +0000 http://stillpointdigital.com/?p=3187 Continue reading The Ebook Retail Universe ]]>

This is the sixth installment in my series of posts about ebook creation. Like the others, it was originally posted on Joel Friedlander’s wonderful resource for indie publishers,TheBookDesigner.com

The Ebook Retail Universe

I realized after my last post (looking at ebook conversion tools) that in my excitement in finally getting to the nuts and bolts of ebook creation that I’d skipped over online conversion tools. Most of those tools either are directly attached to ebook retailer websites or are attached indirectly through distributors/aggregators. So I’m going to have to backtrack.


This month I’ll talk about the retailers and distributors that you are going to be interested in, and next month I’m going to talk about the conversion tools that they offer.


Cut Out the Middle Man: Top Ebook Retailers


What retails and distributors do you want to consider selling your ebooks through?


Okay. I’m assuming that you’re in the US — which isn’t a given, I know. (Most of this information is true for non-US publishers as well.)


That being the case, these are the major retailers you will probably be looking at:


These are the five largest ebook retailers in the US; most of them sell throughout the world, either directly from their own websites (Amazon, Apple, Google), or both directly as well as indirectly through affiliates (Rakuten). At this point, Barnes and Noble only sells in the US.



These are the other sites with which I usually have clients sign up for accounts. Here is a basic rundown of each (listed alphabetically):



Publishing site: http://kdp.amazon.com

File formats accepted: ePub, HTML, mobi, Word doc/docx


  1. 70% of sales price[*] if between $2.99 and $7.99. $0.15/megabyte “transport fee” deducted from each download. Available on some international sites other than Amazon.com only for KindleSelect/KindleUnlimited titles[†]
  2. 35% for any ebook between $0.99 and $199.99. No transport fee

Term: Payable monthly, sixty days after the end of the month in which the sale occurred.

Conversion fee: None


Amazon is the center of the self-publishing universe right now, so the Kindle Direct Publishing program is a must for ebook publishing. Depending on whom you ask, a typical publisher gets between 60% and 85% of its ebook revenue through sales on the Kindle Store.



Publishing site: http://itunesconnect.apple.com

File formats accepted: ePub, iBooks Author

Royalty: 70% of retail price. No transport fee

Term: Payable monthly, forty-five days after the end of the month in which the sale occurred.

Conversion fee: None


According to most analysts, Apple is the second most important retail source. Sales typically make up 5% to 15% of an ebook publisher’s revenue. The downside: You can only upload to Apple’s iTunes Connect using one of two Mac-only pieces of software: iTunes Producer or iBooks Author. So if you’re not in the Apple ecosystem already, you probably want to use a distributor like Smashwords to get your ebooks up there.


Barnes and Noble

Publishing site: http://nookpress.com

File formats accepted: ePub, Word doc/docx, HTML, RTF (rich text file), TXT (plain text)

Royalty: 65% of retail price between $0.99 and $9.99; 40% over $9.99. No transport fee

Term: Payable monthly, sixty days after the end of the month in which the sale occurred.

Conversion fee: None


Barnes and Noble sales typically make up 5% to 10% of an ebook publisher’s revenue.  They are struggling mightily to stay afloat as 2015 winds down.


Publishing site: https://play.google.com/books/publish

File formats accepted: ePub, PDF (which can be created from Word docs on both Mac and PC by using the Print command)

Royalty: 52% of retail price (though they will always discount the retail price—if calculated from the discounted price, I believe they pay out ~60%). No transport fee

Term: Payable monthly, forty-five days after the end of the month in which the sale occurred.

Conversion fee: None


Of the five retailers listed, most publishers would list Google Play as #5, providing between 2% and 10% of total revenue. However, don’t ever count Google out. Also, the bookstore’s reach is truly global, and your books will show up on Google Books, linked to any print edition.[‡]



Publishing site: http://writinglife.kobobooks.com

File formats accepted: ePub, PDF (which can be created from Word docs on both Mac and PC by using the Print command)

Royalty: 70% of retail price. No transport fee

Term: Payable monthly, forty-five days after the end of the month in which the sale occurred.

Conversion fee: None


Although Kobo’s presence in the US market is small, it’s a global giant, selling both directly (through its own ebook stores in many countries) and distributed through affiliates like the UK’s Waterstones, France’s FNAC, Japan’s Rakuten, and many others.


I’ll Get It for You Wholesale: Ebook Distributors and Aggregators


Although there are many other companies (ScribD, Overdrive, Gardners, etc.) that you probably want to make your ebook available through, most of them are either difficult or impossible to create vendor accounts with, and so it is important to use a distributor/aggregator to get your ebooks up on these other sites.


Most of aggregator/distributors will provide you with a free ISBN for your ebook. This may or may not be a good thing. That will make the distributor the publisher of record (as in, their name will show up in the publisher slot on most retail sites); also, you’re not supposed to use the ISBN except on sites to which the aggregator distributes, but you’ll want to use the same ID number for the ebook everywhere it’s for sale.


These companies will also (usually) distribute to some or all of the Big Five retailers listed above. Here are some of the distributors you want to look at (you’ll probably only work with one or at most two):

  • Aer.io
  • BookBaby
  • Draft2Digital
  • IngramSpark!
  • Lulu
  • Pronoun
  • Smashwords


There are others; these are the ones with which I have had direct experience, and which are most widely used. If you’ve had experience with other distributors, please share your experience in the comments!


These companies make their money in some combination of three ways:

  1. Cut: Frequently, they take a percentage of gross revenue (that is, they calculate the percentage based on the total sale amount and take a set percentage of that amount)
  2. Conversion/setup fee: Sometimes they charge a fee to convert your file or to “set up” the title for distribution
  3. Membership: occasionally, they charge an annual listing or membership fee


Here’s a rundown:



Publishing site: http://aer.io

File formats accepted: ePub, PDF (which can be created from Word docs on both Mac and PC by using the Print command)

Cut: 10%

Term: Payable monthly, forty-five days after the end of the month in which the sale occurred

Distribution: Amazon, Apple, Barnes and Noble, Google, Kobo, “more”

Conversion/membership fee: No conversion fee. $49/year membership fee for retail distribution; $99/year membership fee with social networking


Aer.io is primarily a tool for setting up an online ecommerce solution without the headache of setting up a store on your website. However, they also offer distribution services, and they are one of the few services that offers PDF conversion.



Publishing site: http://bookbaby.com

File formats accepted: ePub, Word doc/docx, PDF, “other popular digital document” formats

Cut: 0%

Term: Payable monthly, forty-five days after the end of the month in which Bookbaby receives payment.

Distribution: Amazon, Apple, Barnes and Noble, Kobo, Baker & Tayor (Blio), Oyster, Flipkart, Copia, Gardners, eSentral, Scribd, Ciando, EBSCO, Vearsa

Conversion/membership fee: $299 conversion fee. No membership.


BookBaby is an almost-full-service publishing services provider — they’ll take your manuscript and, for a fee, produce it as a print book (with a professionally designed cover) and/or as an ebook. (They don’t provide editorial services in-house, however.)


What’s the difference between this kind of setup and the so-called vanity presses that prey on the unknowing? A legitimate publishing services provider offers a service for a price; they don’t purport to act as a publisher, which would imply they’ll make money by selling your books. Vanity presses will charge for services (usually top dollar) and then take a major cut of all sales revenue as well. A publisher is a publisher; a service provider is a service provider. If a company offers to do both, watch out.


BookBaby will charge $299 (if you’re going the ebook-only route),[§] but won’t take a percentage of the royalty.


Draft2Digital (D2D)

Publishing site: http://draft2digital.com

File formats accepted: ePub, Word doc/docx, RTF — “anything Word can read”

Cut: 10%

Term: Payable monthly, sixty days after the end of the month in which the sale occurred.

Distribution: Apple, Barnes and Noble, Kobo, Inktera (Page Foundry), Scribd, Tolino, CreateSpace (Amazon print on demand)

Conversion/membership fee: $0


I haven’t worked with Draft2Digital (I mostly use Smashwords as a distributor — see below — and have used and recommend all of the other providers on this list), but I have had friends and clients who have loved them and the service they provide. They won’t distribute directly to Amazon or Google Play.



Publishing site: http://ingramspark.com

File formats accepted: PDF, ePub

Cut: 20-30% (depending on the retailer)

Term: Payable monthly, sixty days after the end of the month in which the sale occurred.

Distribution: Amazon, Apple, Barnes and Noble, Kobo, Baker & Tayor (Blio), Oyster, Scribd, and over sixty other retailers (but NOT Google Play)

Conversion/membership fee: $25 setup fee; $0.60/page (for PDF to ePub)


Bet you didn’t see this one coming.


IngramSpark! is one of the largest print-on-demand providers in the world — the main competitor to Amazon’s CreateSpace. But in addition to printing and distributing hardcover and paperback books, they provide ePub distribution as well.


Upside: They have (almost certainly) the largest distribution list of any aggregator. (Ingram is a pre-eminent print distributor/wholesaler, and so has direct relationships with just about every book retailer on the planet.)


Downside: They take by far the largest cut of any aggregator; they also charge to set each title up, and to convert from PDF (but not if you’ve got an ePub file ready).



Publishing site: http://lulu.com

File formats accepted: PDF, ePub

Cut: 10% of NET REVENUE (the money received by Lulu, not the sales amount; this works out to under 10% of gross revenue)

Term: Payable monthly, sixty days after the end of the month in which the sale occurred.

Distribution: Amazon, Apple, Barnes and Noble, Kobo

Conversion/membership fee: $25 setup fee; $0.60/page (for PDF to ePub)


I haven’t used Lulu for a long time, when I helped a client set up an account; like IngramSpark! they are mostly known as a print-on-demand provider. They only distribute ebooks to the major retailers — and not Google Play.



Publishing site: http://pronoun.com

File formats accepted: PDF, ePub

Cut: 10% of NET REVENUE (the money received by Lulu, not the sales amount; this works out to under 10% of gross revenue)

Term: Payable monthly, sixty days after the end of the month in which the sale occurred.

Distribution: Amazon, Apple, Barnes and Noble, Kobo, Google Play

Conversion/membership fee: $0


NOTE: Still in Beta as of December, 2015. When last I used this service, it was called Vook, and I liked it, but didn’t really need it (it was a soup-to-nuts online conversion-and-distribution service provider, similar to BookBaby). Since then, the company has reinvented itself as Pronoun, a no-charge distributor/aggregator (similar to Smashwords or Draft2Digital).

NOTE2: Pronoun announced that it had been sold to Macmillan in late May, 2016. It remains unclear whether or not the site will continue in any form, and, if it does, what form that might be. 


Publishing site: http://smashwords.com

File formats accepted: ePub, Word doc (not docx)

Cut: 10%

Term: Payable quarterly, fifteen to thirty days after the end of the quarter in which the sale occurred.

Distribution: Amazon,[**] Apple, Barnes and Noble, Kobo, Baker & Taylor (Blio), txtr, Axis360 (libraries), Overdrive (libraries), Flipkart, Oyster, Scribd, Gardners retail, Gardners Library, Yuzu, Tolino, Odilo

Conversion/membership fee: $0


This is the distributor I’ve used the most — for a number of reasons. First of all, for a no-charge aggregator, their distribution list is more than acceptable. Overdrive and Gardners Library (the largest library ebook distributors in North America and the UK) are particularly nice additions. Second, the service is great — when I’ve had a problem, they’ve been incredibly helpful. Third, they are also a retailer themselves — a small retailer, but hey, any outlet that buys you lunch once or twice a month is nice!


Downside? The user interface isn’t as slick as some others, and the ebook conversion engine (their famous Meatgrinder) isn’t my favorite. (A spoiler for next month — none of the online conversion tools win this category as far as I’m concerned. But I’m picky!)


[*] In other words, if you put the book on sale — unless through a KindleSelect promotion — and Amazon lowers the price (i.e., to match another retailer’s sales price), they pay you not based on the full price, but on the actual transaction price. That? That’s NOT AGENCY PRICING. That’s what the big publishers have been screaming about for years. Amazon lowers your book’s price; you get paid on the discounted price, not on the price you set.

[†] KindleSelect is the 90-day program that makes your title available through KindleUnlimited and the Kindle Owners Lender Library. To participate, the title must be available only through Amazon during the 90-day period.

[‡] Whether or not you think that’s a good thing is up to you. It does improve discoverability, however.

[§] And will charge this fee every time you wish to revise your book.

[**] Okay, not really — Amazon has only taken a couple of hundred of Smashwords’s offerings; it makes sense to distribute to Amazon directly anyway.

Image: India Calcutta Bookstore by Carl Parkes. Used through a Creative Commons License


https://stillpointdigital.com/ebook-retail-universe/feed/ 0
Free for all: giving your ebook away on Amazon https://stillpointdigital.com/free-giving-ebook-away-amazon/ https://stillpointdigital.com/free-giving-ebook-away-amazon/#comments Sun, 29 May 2016 15:11:08 +0000 http://stillpointdigital.com/?p=3183 Continue reading Free for all: giving your ebook away on Amazon ]]> “Selling” for free

I had a client ask me recently why you can’t price an ebook as free on Amazon’s Kindle Direct Publishing platform. The author wanted to promote her first book by giving it away — she’d been told that was the best way to make a splash.

I told her that you CAN “sell” your ebook for free on Kindle Direct Publishing — they just don’t make it easy. And it often isn’t a good idea.

Why don’t Amazon make it simple to set the price of a KDP ebook to $0.00?

Two reasons:

  1. It would make them no money
  2. It would take away one of the (rapidly diminishing) benefits of participating in the Kindle Select program, which allows publishers to market their ebook by having limited-time freebie giveaways (as well as “countdown” sales, advertising, and a few other perks)

How to get Amazon to give your ebook away

In order to make your ebook “perma-free,” you need to be selling it at one of the other major retailers — Apple, Kobo, or Barnes and Noble, for choice — that does allow you to price an ebook at $0.00. Then you may need to inform Amazon by going to your ebook’s Kindle Store page (the one on the front end of the store that buyers see), and click on the “Tell us about a lower price” link just below the book’s rankings. Share a link to the free ebook on the other site, tell Amazon the price at that site is $0.00,  and you should be good to go. You can also try using the “Contact Us” link on your Author Central page.  (You do have an Author Central page, right?)

Sometimes, Amazon will pick up on the price drop all on their own and match it. And sometimes they play dumb and don’t want to hear about it — you may need to tell them more than once, or you may need to get someone else to inform them.

A word of warning: while free ebooks were all the rage a few years back, they seem to be much less effective as a way of marketing yourself or your book now. Amazon maintains separate rankings for paid and for free ebooks, so any boost you get by giving your ebook away will evaporate if you start charging for it again. Also, separate populations of buyers have congealed — folks who “buy” free ebooks (or download pirated copies) are much less likely to pay for them, so you’re not really marketing to the segment of your audience who might actually make you money. Which is kind of what most of us want.

Reasons why you might want to go ahead and offer your ebook for free anyway:

  • You’re looking for reviews (folks who download the free version from the Kindle Store should still be marked as “verified buyers,” which makes their review more credible)
  • The title is the first in a series; by giving it away you’re marketing the other books (this is what’s known in retail as a loss leader — just make sure to include links and blurbs at the back of the ebook to make as easy as possible to buy the next title in the series)
  • You’re publishing the ebook not for the sales, but to establish yourself as an expert in a field (to promote your services or your speaking appearances, for example)
https://stillpointdigital.com/free-giving-ebook-away-amazon/feed/ 3
Jump in the Convertible: Ebook Conversion Tools https://stillpointdigital.com/jump-in-the-convertible-ebook-conversion-tools/ https://stillpointdigital.com/jump-in-the-convertible-ebook-conversion-tools/#respond Fri, 19 Feb 2016 15:45:40 +0000 http://stillpointdigital.com/?p=3136 Continue reading Jump in the Convertible: Ebook Conversion Tools ]]>

This is the fifth installment in my series of posts about ebook creation. Like the others, it was originally posted on Joel Friedlander’s wonderful resource for indie publishers,TheBookDesigner.com

Over the last few months I’ve discussed preparing your manuscript and your images for conversion into ebook form. This month, I’m going to look more closely at a subject that I’ve touched on: choosing an ebook conversion tool. Just to review, I suggested that there were four basic ways to convert your manuscript into ebook format:

  1. From scratch
  2. Saving from a word-processing or page-layout application into ePub format
  3. Using a conversion app or online service
  4. Hiring a designer

We’re going to ignore option #1 — if you’re the kind of person who wants to dig that deep into the guts of ebook creation, I don’t think that you’re going to be patient with this process. I’m not going to dwell on option #4 (or the second half of option #3), since the emphasis of this series is how to create your own ebooks. Using a conversion service or ebook designer is always an option, and I’ll discuss later how to choose one. But for now, we’re going to look at choosing the software that you can use to create a book yourself. Here’s the list of software that I will look through with you: .[1]

  • Apache’s OpenOffice has a plug-in called Writer2ePub that allows you to save files as ebooks (open source office suite)
  • Scrivener (commercial writing app)
  • Apple’s Pages for OS X or iOS (consumer word-processing/page-layout app)
  • Adobe’s InDesign (professional page-layout app)
  • QuarkXpress (professional page-layout app)
  • Jutoh (ebook design and creation app)
  • iBooks Author (fixed-format ebook design app)
  • Calibre (ebook library app with file-editing utility)
  • Sigil (dedicated ePub file editor)

I’ll also talk briefly about the possibility of using one of these tools for conversion to the ePub ebook file, and then a text editor or web-design app to do any post-conversion editing.

For each app, I’m going to start with a formatted Word document from a book that I’m working on (my own novel Risuko, actually). Here’s the chapter head that we’re going to be looking at a lot:

The Music Lesson screenshot 1

I chose this file because it had just enough complexity to test these conversion tools, but not so much that it will break all of them. The fonts are part of what makes this file challenging; the drop cap at the beginning of the first paragraph is another part.

The manuscript has been prepared in the manner that I suggested in an earlier post; all of the styles are applied globally, and had names applied in Word’s Styles palette. The style for the chapter header above is called “Chapter-Head”; the first paragraph with the drop cap is called “Body-First.” Italics and boldface are applied simply with Word’s keyboard formatting (command-I and command-B on my Mac). The “Body-First” style has a built-in drop-cap rule — I didn’t have to style those letters separately, but simply added the “Body-First” style to the first body paragraph in each chapter.

Writer’s Tools

The first three apps all fall into the category of word-processing/writing tools.

OpenOffice logo

OpenOffice (free)

is an open-source office suite program. OpenOffice opens and edits just about every kind of every-day file that you can think of, and it can save into a number of file formats, including Word docs (.doc and .docx). Versions will run on just about every kind of computer you can think of.

Writer2ePub is a plugin that allows you to save your word-processing file into ePub format. You add the plugin in OpenOffice by using the Extension Manager from the Tools menu. Once the plugin is installed, you’ll get a floating palette that allows you access to the ePub tools:

OpenOffice screenshot1

This file was imported from a PDF rather than a Word doc. Nice!

That green E is the ePub logo, by the way. You have to save your file in OpenOffice’s native ODT format. Once you’ve done that, you can click on those buttons. The right-hand button opens the preference panel. The center button allows you to edit the ebook metadata, adding the title, author, cover image, etc. to the file.

The most important button for our purposes is the one on the left. You can export quickly, but unless you add “w2e_” to the beginning of every one of your text style names, they won’t export. This will leave all of your text unformatted.

If you do add the tag at the beginning of the style names, however, the ePub file that Word2ePub exports will do an okay job of converting the styles you specified:

OpenOffice screenshot2

And the HTML won’t have a lot of extra coding added. (We’ll see why that’s a problem soon enough.)

Scrivener logo

Scrivener ($45)

is a Swiss Army Knife of writer’s tools. It gives an author a single place to gather research, images, notes, outtakes — all in one file. It imports a wide variety of files — including the standard DOC, DOCX, and RTF word processing files. Scrivener doesn’t handle fancy text formatting, like the drop capital at the beginning of the chapter:

Scrivener screenshot1

Still, Scrivener does a wonderful job of getting everything where you want it, and it exports to the ePub format.

The Scrivener conversion feature is very fully featured. On Scrivener, the process is called “compiling,” since you can export multiple files into a single ebook— chapters, say. There’s a whole battery of compilation options, including metadata:

Scrivener screenshot2

There’s a way of adding a cover, a way of converting a table to an image so that it doesn’t break your ebook (another topic for another day!), and a lot more.

There’s also a wildly complicated formatting panel that actually gives you relatively little control over how text is going to look when it exports. There are a number of check boxes and options, but you don’t apply it with the text in front of you, you apply it in the Compile dialog box:

Scrivener screenshot3

It will export italics and boldface, and will handle chapter heads and such, but it won’t allow you to create, for example, a special style for a quoted poem or a sidebar or whatever.

Not wanting to recreate all of my styling, I selected all of my text and applied Preserve Formatting to my entire manuscript. This is what it produced:

Scrivener screenshot4

Not very good.

And it applied its own local format names to each paragraph (i.e., “p16” instead of “Body-Text”), but at least it applied the same name to all paragraphs in the same style — “p16” equals “Body-Text” throughout.

If I hadn’t already committed to formatting the text in Word, Scrivener wouldn’t have given me many tools to apply consistent, attractive styling to the exported ePub file. I can add the formatting later using CSS styling rules — but if I hadn’t already given the paragraphs styles in Word (before importing into Scrivener), I’d have had to start from scratch.

Apple Pages logo x200

Apple Pages (Mac OS X: $19.99 | iOS: $9.99)

is Apple’s answer to Word (for both Macs and iOS devices)— and it does most of the things Word does, plus some. It’s a serviceable piece of page layout software, though no one would confuse it with professional tools like InDesign or Quark. Of course, it’s only available on Apple devices. Still, it’s a nice piece of software.

Like the other apps, it can open a Word doc or RTF file natively. Alas, once again, I couldn’t get it to handle drop caps:

Apple pages screenshot1

The style names, however, came through perfectly.

The export function is simple — go to the File menu, select Export ->ePub, and you’ll get a straightforward dialog box that offers you the opportunity to add a few bits of metadata — title, author, category.[2]

The exported ePub file was divided up by chapters, which was nice, and retained much of its formatting:

Apple pages screenshot2

The style names were once again changed — paragraphs now have names like “s12” while local character changes have styles named “c9” and such. That’s not a problem

The style names are not consistent, however, and this is a problem.

Rather than add <i> for italics, for example, Pages created <span> tags — the span tag that Pages created for italics seems to be <span class=”c15” > — most of the time.[3] If the paragraph is in a different style (e.g., “Body-Text” instead of “Body-First”), then the character style is different as well. What this means is that I can’t globally change the style all of the italics or boldface characters — or those drop-capped initial letters. For those initial letters, for example, different instances are given different style names (“c14,” “c23,” “c28,” etc.) even though these were all styled identically, with the same paragraph style in Word.

This means that any changes that I make to style will apply only to that style on that page— it won’t apply throughout the document. Once again, this is not good.

All of these writers’ tools can export an ePub file. But none of them will export one that you’d want to sell — not without further cleaning up.

Page Layout Tools

Quark ExpressInDesign

The next section is a shorter one, dedicated to professional-grade print layout software, and field that’s dominated by Adobe’sInDesign (part of the Creative Cloud suite: $19.99/month) , with Quark ($849) continuing to hold its own.

These apps are intended for designing books, magazines, and other paper-and-ink documents, and they’re very sophisticated. You can control the placement and style of every letter on every page of a book, and you can work with a team of designers to create beautiful works of the printer’s art.

Both Quark and InDesign have had ebook export functions for some time, but until a couple of years ago, they were pretty awful — certainly no better than what we just saw from the consumer-level writing apps.

Recently, the ebook authoring capabilities of Quark and InDesign have gotten to the point where they’re actually useful — but the ebooks that they produce still aren’t quite usable out of the box (especially for more complicated formatting).

Both apps offer a huge amount of control over how styles export. InDesign allows you to say what HTML tag and class you’d like slapped on a particular style on export, and whether you want a page break before it. It allows you to leave in fine adjustments that you’ve made for the print edition or ignore them (usually the right idea). It can export ePub2 or the shinier (though not universally adopted) ePub3 format, can export a fixed-format ebook, and allows you to add custom CSS — style instructions — on the export. It even allows you to add JavaScript files.

Here’s the ePub file created by InDesign CC 2015:

InDesign screenshot1

You’ll notice, of course, that the fonts aren’t great. This is in part because Adobe is in the business of licensing fonts, and is very careful about what it adds where. The fonts are embedded in the ebook file, but they’re encrypted so that no one can go into the file and steal them. That’s great, but if I try to upload this file to Amazon or Apple, it will be rejected.

Still, the drop caps are perfect, and the formatting looks, for the most part, nice. When I look at the code, there’s some of the same silliness with renaming — but nowhere nearly as much. Again, italics show up as — this time, that’s fairly consistent, though, so I don’t have to go searching all over for variations — CharOverride-10 = italic, so if I want to change the styling of all the italics for some reason, I can change it in one place.

So, the files that the professional software exports are great — but still need to be futzed with.

Ebook Design Software

This is our third category, and it’s the software that does the futzing: software that is designed specifically for creating ebooks.

Jutoh logo

Jutoh ($39)

Jutoh is intended to be a page-layout app with a focus on digital distribution: format the file once and export it to a wide variety of formats. Jutoh can import Word docs, OpenOffice ODT files, HTML, and even ePub files. (The styling for ePub and HTML doesn’t all import, however.)

It can export into ePub2 and ePub3 formats, as well as mobi (Kindle) files, ODT files that can be used to create a PDF, and even a text-to-speech engine that will create a computer read-aloud track.

Like Scrivener, Jutoh allows you to pull together all of the files that you need to create the book into a single package.

You have to create a project — you can then import your manuscript:

Jutoh screenshot1

Like Pages, the formatting mostly looks good, but once again, drop caps aren’t supported.

As with every other app so far, Jutoh allows you to edit and format the text, add and move images, and do a lot of the other prep work.

The exported file is clean:

Jutoh screenshot2

The fonts once again don’t export. However, all of the global styles are intact — and italics are given simple <i> tags. So adding a customized style is simply a matter of creating (or adding) a CSS stylesheet that makes the files look the way we want them to.

iBooks Author logo x200

iBooks Author

When I first started this series, Apple’s iBooks Author (free)wasn’t a viable ebook editing app. It could only create fixed-format ebooks, and could only export directly to Apple’s iBooks Store.

Since then, Apple announced that iBooks Author would both import and export reflowable ePub files, and so it became possible to consider this app as an ebook editing tool.

Like most Apple products, iBooks Author is beautiful. It takes the interface from Pages and adds some unparalleled tools for ebook authoring. There’s no easier app for adding widgets — small, self-contained chunks of code that add very non-book-like functions to an ebook, whether that’s an internet video, a quiz, or custom HTML or JavaScript. Adding enhancements like embedded video or audio is a breeze. It’s a great tool for creating beautifully designed fixed-layout books — children’s picture books, for example, or cookbooks, or textbooks that require a particular relationship between the text and the images and other media. .[4]

On importing my Word file, iBooks Author did a nice job of maintaining the text style:

iBooks Author screenshot1

The downside? Like Pages, there are some text styles (here, our old friend drop caps) that can’t work. The app expects each chapter to be loaded separately, or all of the chapters in the Word doc will be listed as sections in a single “chapter.”

The exported file does a pretty good job of reproducing what made it through import:

iBooks Author screenshot2

That could almost be the same screenshot, except for the line-height of the first paragraph — look at the space between the first two lines.

When I look under the hood of the reflowable ePub file that iBooks Author creates, there are plusses and minuses.

First of all, iBooks Author doesn’t export in the older, more widely adopted ePub2 format, but only into Apple’s version of the more feature-rich ePub3 format. The app adds a few non-standard files that (while perfectly valid) may keep the file from passing validation when you upload it to some retailers’ sites: while I was able to upload the un-edited ePub file to Apple, Kobo, and Amazon, Barnes and Noble and Smashwords both rejected the file.

Also, not surprisingly, the same style name changes that made Pages a problem pop up again in the file created by iBooks Author. So making global styling changes won’t be easy.

While I’m very excited about the opportunity to use iBooks Author as a single tool to create fixed-format ebooks for the three major retailers that accept them (Apple, Kobo, and Amazon), I’m less sanguine about using the app to create reflowable ebooks — unless I’m creating a separate version for use on B&N, Smashwords, and the rest.

Calibre logo

Calibre (free)

Calibre was created not for ebook designers but for ebook readers. Think of it as iTunes for ebooks — the open-source ebook library app can download ebooks directly from many retailers, can sync with a number of ereader devices, and can organize your ebook library in a number of ways that make it much easier to find the book you’re looking for. And like iTunes, Calibre has the ability to convert between one ebook format and another: between ePub and mobi (old Kindle) or AZW3 (newer Kindle), say, or between LIT format files and ePub, so that you can read that old Microsoft Reader book on the iBooks app of your iPad or Mac. It can also convert between Word DOCX files[5] and ePub or any of a number of other digital text formats.

That conversion ability made Calibre a very handy for ebook designers as well, and so an ePub-editing utility was added a couple of years back. Together, they make Calibre the one app that allows you to go all of the way from importing a Word doc to converting the file to ePub to cleaning up the file that results.

Opening the conversion dialog once again gives us the chance to add metadata. It also gives a bewildering range of settings with which to fine-tune the conversion. (If you’re interested in mastering those settings, visit Calibre’s excellent help pages.)

Using the base settings, which are often pretty good, I got great results:

Calibre screenshot1

Notice that the initial drop cap imported properly, and that (most of) the fonts are intact — and in fact were embedded within the ebook file. The numbers dropped their font, but that’s not a big deal.

Unfortunately, the underlying styling got rewritten once again. Instead of every paragraph containing a drop cap having the same style name (“Body-First” in the Word doc), each <p>(paragraph) tag is given a different class (style) name (“block_33,” “block_39,” etc.). On the other hand, the styling for the drop cap itself seems to have been given a consistent class name throughout, so if I wanted to make the drop caps bigger or turn them red, I could do that by changing a single CSS rule.

Most of the “Body-Text” paragraphs are given the same class name, “block_19,” but I’d have to go through the whole ebook to make sure that were true. .[6] Standard formatting like italics and boldface are given standard HTML tags (<i> and <b> ), which is nice.

In terms of editing and validating ePub files, Calibre’s editing utility has a pretty good set of features; it’s also extensible through a number of plugins. If you know the Python programming language, you can even write a plug-in yourself! The main editing window shows the raw HTML, but there is a preview window open to the right that allows you to see how the changes you are making to the code affect the way that the ebook displays. Another window shows what CSS rules are in effect in a particular chunk of text, which helps figure out why those letters are displaying orange, for example. (Oops! Forgot to change the rule back after I searched for all of those class names!) You can also open and edit the CSS stylesheets and the specialized XML documents that are embedded in every ePub file, .[7]

The community that supports Calibre is very active, and so new features and fixes are being added every few weeks. Support is terrific — when I’ve been stumped by what appeared to me to be a bug in the conversion software, I got multiple responses within hours; when the problem turned out in fact to be a bug, a fix was posted within a week.

Sigil logo

Sigil (free)

Sigil is the tool that I use most often for ebook editing, more than Calibre or an HTML editor like Dreamweaver. This is for a couple of reasons:

  1. I’ve been using it for a long time (since 2011 — a lifetime in ebook development terms.)
  2. It can open ePub files directly, rather than having to import it into a library (as Calibre does) or unZIP them (as editing in an HTML editor requires) and then re-ZIP when finished.
  3. I can view the formatted text in the preview window, as in Calibre, or I can switch the main window to “Book View” and edit the file in WYSIWYG (“what you see is what you get”) mode — I don’t have to look at the HTML unless I want to.
  4. It’s use of Regular Expressions (a.k.a. RegEx, GREP, or wildcard searches) is more powerful and more familiar to me than Calibre’s, which allows me to make mass changes quickly.
  5. Have I mentioned that I’ve used Sigil for a long time?

Like Calibre, Sigil is open source; unlike Calibre, which has a huge community of consumers who use it just for its library functions, Sigil is aimed at designers only, and so it has occasionally gone through periods when development has essentially stopped.

However, Sigil development has been steady for the past couple of years, including the addition of Calibre-like plugins that add all sorts of nifty functions, from in-app validation to importing Kindle files to converting the file into ePub3 format. .[8]

The main disadvantage to Sigil as an ebook authoring tool is that it will only import valid HTML files. .[9] It’s the first piece of software we’ve looked at that won’t directly open or import the DOCX file we’ve been using. You can copy and paste from a Word or other document, and much of the formatting will (probably) translate over. However, for a complex file (like the one we’re using to test against), you’re going to have to convert the file into a format that Sigil is happy with.

Unfortunately, Word’s Save to Web command won’t create an HTML file that Sigil will import — Microsoft’s HTML conversion is notoriously idiosyncratic and results in incredibly bloated code that’s optimized for Internet Explorer — a browser even Microsoft no longer supports.

There are, however, a number of ways to get the manuscript into the format we can work with:

  • Use one of the apps above to convert the file into ePub format. (I frequently use InDesign, since I’m also working with a print document, but I’ve also used each of the others.)
  • Use a utility to convert the file into valid XHTML.[10]
  • Convert the document, and then copy and paste the code, rather than using the import function.

Any of those routes has disadvantages. However, for the purposes of this exercise, I opened the file that had been created by Jutoh, since it was the one that was the least problematic. Remember, this is what it looked like:

Sigil screenshot1

I played with the CSS for about ten minutes and this is what I got (not just in this chapter, but throughout the ebook):

Sigil screenshot2

Not bad! I’d probably play with the color, and the spacing between the chapter head and the body paragraphs is too large, but certainly a lot closer to what I was looking for.

Sigil, then, is a great tool for getting under the hood of your ebook and editing it intact. It’s got some quirks, it’s definitely not aimed at consumers (Autosave? We laugh at your autosave!), and its most powerful features take a while to learn how to use, but it’s the only app designed just for the purpose of editing ePub files. .[11]

Now, as I mentioned in the first post in this series, an ePub file is simply a (very carefully constructed) ZIP archive with a different extension (the three or four letters at the end of the file name). Change the extension to ZIP, double-click the archive, and you’ll get a folder full of all of the things in your ebook: XHTML files, image and other media files, stylesheets, and all of those exotic XML files that I talked about above.

The fun part is that you can use Dreamweaver or another HTML or text editor to edit those XHTML files. It will give you basically the same power to edit every part of the ebook. If you’re using Dreamweaver or another app with HTML previewing, you can see the edits effects as you make them, just like in Sigil. If you’re using a bare-bones text editor, you can load the ebook file into a web browser and it will display just fine — most ereaders are based on web browsers. (Apple’s iBooks, for example, is a specialized version of Mobile Safari.) Finish the editing and ZIP the directory back up, change the extension back to ePub, and you should be all set.[12]


[1]There are more tools out there — but these are the most commonly used and recommended ones. If you have a favorite tool and I haven’t mentioned it, please leave a comment!

[2]You can export an ePub file from a Pages doc on your iPad or iPhone as well, and then open it straight in iBooks. Never tried it on an Apple Watch, but I suppose that might work too.

[3]If the sight of HTML makes you break out in hives…. Well, I’ll be giving a quick lesson in HTML tags and CSS styles over the next few months.

[4]Amazon’s Kid’s Book Creator and Kindle Comic Creator have some of the same features, but where those will only allow you to create books for the Kindle, iBooks Author now has the ability to create ebooks that will work on Apple products, but also Kobos and — in theory — the newer Kindles at which the Amazon software is aimed.

[5]Though not DOC files; DOCX are based on XML, which is the file structure underlying HTML and many other modern file formats, while DOC files use a propriet

[6]Easy way to do this? Change the color of the “Body-Text”/”block_19” style to orange or something equally garish, and look for body paragraphs that didn’t change color.

[7]For example the OPF “manifest” flle that tells ereaders what is in the ebook and where to find it within the ebook’s internal structure; and the NCX file in ePub2 and some ePub3 files that give ereaders the navigation/table of contents info. I’ll talk about those — but not too much — in coming months.

[8] Neither Sigil nor Calibre is yet fully set up for ePub3, though they are both moving in that direction, and you can edit ePub3 files, even if not all of the features work properly.

[9]Strictly speaking, valid XHTML files.

[10]I use Apple’s TextEdit. Here are directions from Jane Friedman. The important thing is that the exported file be valid XHTML 1.1 — if your utility knows how to save a file in that format, you’re all set.

[11]In case you’re wondering: there isn’t really a tool for directly editing mobi files. That’s one of many reasons that I start with ePub and convert to Kindle formats later.

[12]If you’re using a Mac, you’ll need to use a utility like ePub ZIP/UnZIP for Mac.

Photo: bigstockphoto.com.

https://stillpointdigital.com/jump-in-the-convertible-ebook-conversion-tools/feed/ 0
In the Picture: Prepping Images for Your Ebook https://stillpointdigital.com/prepping-ebook-images/ https://stillpointdigital.com/prepping-ebook-images/#respond Fri, 08 Jan 2016 15:03:16 +0000 http://stillpointdigital.com/?p=3109 Continue reading In the Picture: Prepping Images for Your Ebook ]]> Last month I discussed how to clean up your manuscript to prepare it for ebook conversion. This time I’m going to be looking at how to do the same thing with images.[1]

There’s one big difference, however: where the advice that I gave you about getting your text squeaky clean was equally valid for preparing to convert your words to either print or ebook format, these suggestions are ebook-only.

What’s the difference?

Well, in either case, you’re going to start by finding the perfect picture to go with your words. You’re going to crop the picture (cutting out any extraneous bits) and enhance it (or get someone who knows how to do so) so that it looks beautiful.

However, there are two enormous differences between the image files you want to use in an ebook and ones you’re going to get printed on paper:

  1. In a print book, color is expensive, while in an ebook beautiful color costs (essentially) the same as black and white.
  2. On the other hand, in print, you want the image file that goes off to the printer to be as high quality (that is to say, large) as possible, while in an ebook, every kilobyte costs you (I’ll explain how below).


Use color — please!

As someone who’s been around the publishing industry for a while, this concept was one of the hardest things for me to wrap my head around when I first started creating ebooks: that using color wasn’t verboten.

As you probably know, printing a book using even a single color image often more than doubles the production cost of the book. Why? Well, you know that your desktop printer has four colors of ink: cyan, magenta, yellow, and black (CYMK). And unless you tell it not to, it will print every page — even one with only black letters — using all four inks.

A professional offset printing press is essentially the same, though with the ability to use many more (or fewer) colors if needed.[2] A commercial print-on-demand press is exactly like your inkjet — except it’s built to work with much higher volume and with much more consistency.

So unless you do something really special (and expensive) like getting the printer to insert a single plate by hand into each book before it is bound, you’re going to be printing the entire book in full CYMK+ color. Ouch!

With ebooks, none of that is an issue at all! Many dedicated ereaders and all ereader apps used on computers, tablets, or smart phones display in three colors (red, green, and blue — RGB). There is no black pixel! And if you remember your high school science, white light is made up by shining all three colors at once. So color is (in most cases) the default. Why not take advantage of that?

Okay, so some Kindles and other ereader devices use an eInk screen that’s not in living color. These devices’ screens use much less energy, and many people find them easier to read, so there will be folks who will be viewing your beautiful, fully saturated snapshot as if it were being displayed on a 1984 Macintosh. As with those trailblazing computers, the eInk devices are still capable of displaying your picture beautifully — just not in color.


So one word of warning: do make sure that you look at every image in both color and grayscale before you convert it. A picture that looks crisp and clear in brilliant color can lose its contrast when seen in black and white.

Also, make sure that it’s saved as an RGB (screen) image, not a CYMK (print) image.

Stepping on the scale

What ebooks give us in color, they take away in file size. When you send an image off to a printer or print designer, the idea is to send it at the highest possible quality, in a lossless format like TIFF (Tagged Image File Format, if you care). The print files for my 36-page illustrated children’s book The Seven Gods of Luck weigh in at a healthy 128 megabytes (MB).

Many ebook retailers won’t even allow you to upload a file larger than 20MB. And even with those that do, such as Apple, you need to consider how many of your readers will be accessing your masterpiece: on a wireless device, where download speeds are slow, and empty space is taken up by cat videos and audio recordings of a niece’s singing recital. Nothing frustrates a reader more than buying your book — but not being able to download it.

On top of that, our favorite elephant in the room, Amazon, deducts fifteen cents per megabyte from every royalty payment as a “transport fee.”[4] (I always imagine a group of burly truckers carrying floppy disks with your ebook on them from a storage locker to the download bay on the other side of Jeff Bezos’s kingdom.)

So for a 20MB book, that would be $3.00. If you’re charging $9.99 (a high price by indie-published ebook standards), you’ve just lowered your royalty from 70% to 40%. If you’re charging less, the damage is even worse.

What can we do to avoid this catastrophe? What is the cause of all of this bloat?

Well, you’ll need to trust me on this: it isn’t your words. If you don’t believe me, look at this picture of the innards of an ebook:

These are the files that make up the text portion of an average-sized book (Joseph Campbell’s Myths to Live By; my paperback copy is 288 pages). See those numbers in the third column, the column headed size? They range from under a kilobyte to 21KB — the total, including the front and back matter, is 104KB, or just over a tenth of a megabyte.

If you were to buy the ePub file of this ebook, you’d see that the file is actually somewhere around 4.2MB.

So where did the other 4.1MB come from?

A few kilobytes of it can be found in the stylesheets, navigation files, and such.

But most of it came from the ninety-odd lovely pictures that I added when I was creating the ebook edition.[5]

Ouch. That’s sixty cents off the top of every Amazon sale. But the images were integral to the new edition, the first put out by the Joseph Campbell Foundation. So in they stayed.

So what’s a body supposed to do?

Taking a byte out of file size

Before we start our pictures on their weight-loss program, I need to explain something about images in ebook files: they have to be either JPEG or PNG (portable network graphics) files. No bitmap (.bmp) files, no vector (.eps or .ai) files,[6] no Photoshop (.psd) files, no raw camera (RAW or Exif) files. Just .jpg and .png files.

This turns out to be a good thing, because these two formats allow the most control over the final size of your image file.

We’re almost ready to start working with the images — but remember: never work with the original file. Always work with a copy, so that if something goes horribly wrong, all you’ve lost is a little time. Rename your working files. Put them in a different folder. On a different computer. In a different city. (And make sure that there’s a backup of the…. Oh, you know the drill.)

One of the most important, most technical jobs involved in designing an ebook is massaging the images so that they don’t take up too much space, but at the same time still display beautifully.

There are three parts to making that happen:

  1. Sizing (making sure that the height and width of the image are in the right range of pixels)
  2. Compression (using software to make the file as small as possible without losing quality)
  3. Optimization (getting rid of some unnecessary bloat that your image carries around with it needlessly)



The easiest way to decrease the file size of your image is to decrease the number of pixels — in other words, simply making the picture smaller.

At this point most phones (let alone dedicated cameras) are capable of taking pictures over 10 megapixels — that is, ten million little collections of red, green, and blue dots. The native dimensions of a picture taken on an iPhone 5s like mine is 3264×2448 pixels.

Guess what?

Even an high-resolution Retina iPad can’t squeeze that many pixels onto its screen. Neither can a Retina MacBook 15”.

So, I ask, why include pixels that will never actually be seen by anyone not reading your ebook on a super-high-definition 30” computer monitor?

In this next section I’m going to assume that you’re used to working with a basic image editing program like PhotoScape, GIMP, or Apple Preview — if you can find your way around Adobe Photoshop (even an old version), this should be easy.

So. Open the file.

Wait — you aren’t going to work with the original image, are you? Good. Just checking.

In your app, find the menu item to resize the picture. In Photoshop, it’s under the Image menu: Image Size… In Preview, it’s under the Tools menu. In PhotoScape, click the Resize Photo button at the bottom of the window.

You’ll be shown a box that looks something like this (from PhotoScape):

You’ll see the existing width and height (in pixels, inches, centimeters, or whatever), with a box next to it to fill in a new measurement. Somewhere there will be something like that little check box in the picture above that reads “Preserve aspect ratio”; this will keep the height and width of the image proportional. Which is, usually, a good thing.

So what size should you set your image to?

It depends on a number of criteria:

  • How important is the fine detail of the image?
  • How many total images are there in the book?
  • Are the pictures primary, or are they secondary to the text?
  • How sharp is the image to begin with?
  • Is the image a photograph, a painting, or line art?

If the ebook is a picture book or a collection of photographs that you expect readers to examine closely, then by all means, keep the image as close to full-sized as you can. Still, there’s no point in making the image bigger than can be viewed on the device.

The short side on the largest current tablet screens (including the iPad and Kindle Fire HDX) is around 1600 pixels.

If you’re trying to keep your image as large as possible, then set the short side of your image to that size.

If, on the other hand, your picture is more decorative or illustrative than central, you might consider setting that short-side size to something closer to a standard smart phone or ereader width — between 600 and 800 pixels.

Click the “OK” button.

Suddenly, your picture will look tiny on screen. Don’t worry — you can zoom in to see it as it really is. Make sure that you don’t see any “jaggies” (ragged, pixelated lines instead of smooth, flowing ones), and that the important detail is all still visible. If you aren’t happy with the size you chose, go up to the Edit menu and select Undo — then try it again, until you’re happy.

Another way to decrease your file size by a whopping 25%? If your file is still in CYMK color (intended for use on a printer), convert it to RGB (intended for display on a screen). There are no black pixels, remember? In Photoshop’s Image menu, select Mode>RGB, and watch those kilobytes drain away.


Once you’re happy, you’re going to save the file, and when you do, you’re going to apply software compression — basically squeezing out the unneeded detail from the image, with the emphasis on unneeded.

At this point, I almost always save files in the JPEG format, since it is very, very good at compressing images.

We’re going to go up to the File menu and select Save As… (in Mac OS X Yosemite, they changed the label to “duplicate” for some reason). You’ll be confronted with a dialog box that looks something like this :

See that slider labeled “Quality”? That’s going to do the magic for us.

How much should you compress the image? As much as you can without compromising the quality of the image. Unfortunately, that scale isn’t calibrated uniformly — different software uses different compression algorithms at different settings. So you’re going to need to play it by ear.

I started out being very conservative in compressing images — close to the right-hand, “Best” side of the slider. At this point, I am often extremely aggressive, around the second tick mark from the left. If I’ve got multiple images in the book, I aim for each to be under 50KB, if I can help it. If this is the only, or one of the few images, I shoot for a file size in the 100–150KB range.

I then type in a new name — so that I still have the previous version, if I want to go back. Generally, I take the width that I choose in step 1 and add that at the end of the file name (that’s the  -800 in the file name above)  oh, and I take out any spaces and replace them with hyphens or dashes, since ePub doesn’t like spaces in file names.

Then open the new photo — if it isn’t opened automatically — and see what the compression gods have wrought. Look for lines of gradation in smooth color bands (posterization), or jaggies. See if the detail in the image is still acceptable.

If not, or if the file is still too big, go back to the previous version (this is why you saved it!) and start again.[7]


Now we get into some real black magic. Sort of.

Each image carries in it a bunch of metadata — information about when and how the picture was taken, the camera, the date and time, maybe the geolocation. If you’re trying to put together a slide show, this sort of information can be invaluable.

Locked inside of an ebook, it’s useless. And it can add as much as 20KB to an image.

There are several ways to strip this last bit of dead weight away. I use an open source (aka freeware) utility app called ImageOptim that gets rid of the metadata, as well as some other crud, without further compressing the file — Mac only, I’m afraid.

In Windows, however, you can simply right click on the image file in Windows Explorer, click on the Properties tab, and then select the link at the bottom of the tab that reads “Remove Properties and Personal Information.” That should help — and it ought to slim down the file at least a bit.

If you’re a Linux user, you can use the command line utility JPEGRescan (one of the ones on which ImageOptim is based).

Once you’ve gone through the whole process with each of your images (including the cover art), you’ll be ready to start making your ebook!

[1] Note that I’m not going to be talking about choosing images to accompany the text. I’m going to assume that you’ve spent a lot of time finding the perfect pictures to illustrate what you’re saying — and that you’ve made absolutely sure that you have the right to include them in your book.

[2] Okay. There are many more differences between a home printer and a large web press. Work with me here.

[3] Image: Kindle vs. iPad by Zhao ! (@flickr.com) used through a Creative Commons license.

[4] This $0.15/MB fee applies only if you’re using the Kindle Direct Publishing 70% royalty rate, which you can choose for ebooks priced between $2.99 and $9.99. Go with the other option and you can charge whatever you’d like (well, $0.99–$199.99), and you won’t get charged a fee — but you’ll only make 35%.

[5] And that’s 4.1MB after I did all of the things I’m about to tell you to do. When I first converted the book, the Images folder was a bit under 14MB. And that’s not including another 15MB of lovely but ultimately unusable video. By the way, the 1MB that shows up attached to the Images folder? I forgot when I took this screenshot that I’d partially emptied the folder.

[6] You can, in theory, use Scalable Vector Graphics (SVG) files to do all sorts of nifty things in ebooks — but it’s a very difficult format to work in, and the format isn’t fully supported in all ereaders. Likewise, you can, in theory, use Graphics Interchange Format (GIF) files — even animated ones. However, Apple is the only retailer that will accept them.

[7] Be careful not to compress the same image too many times — if you open a JPEG and then select Save As…, you’re going to apply a whole new round of compression. Do that often enough, and your beautiful photo will start to look awful.

FYI — I’m having another giveaway of my YA historical adventure novel Risuko over on Goodreads! Go check it out — enter for a chance to win a signed copy of your very own.

Goodreads Book Giveaway

Risuko by David Kudler


by David Kudler

Giveaway ends January 15, 2016.

See the giveaway details at Goodreads.

Enter Giveaway

https://stillpointdigital.com/prepping-ebook-images/feed/ 0