Amazon Kindle User guide

Amazon Kindle Publishing

Guidelines

How to make books available for the Kindle platform

version 2013.3

This document describes the primary ways publishers, authors, and conversion houses can make their content available on the Amazon Kindle platform. This document includes guidelines and suggestions to ensure a smooth conversion and publication process.

Copyright © 2013 Amazon.com, Inc. or its affiliates. All rights reserved.

Publishing on Kindle: Guidelines for Publishers

Table of Contents

1 Getting Started ............................................................................................................................ 6

2 Paths to Getting Your Content on Kindle ................................................................................. 6

2.1 Amazon’s Kindle Direct Publishing Platform .......................................................................... 6

2.2 Creating Kindle Books In-House Using Kindle Publisher Tools ............................................. 6

2.2.1 Kindle Plugin for Adobe InDesign ..................................................................................................................... 6

2.2.2 KindleGen ........................................................................................................................................................ 6

2.2.3 Kindle Previewer Software ............................................................................................................................... 9

2.3 Third-Party Conversion Services ............................................................................................ 9

3 General Formatting Guidelines ............................................................................................... 10

3.1 Text Guidelines ..................................................................................................................... 11

3.1.1 Text Guideline #1: Body Text Must Use Defaults ........................................................................................... 11

3.1.2 Text Guideline #2: Use CSS for Page Breaks ................................................................................................ 11

3.1.3 Text Guideline #3: Formatting Paragraphs ..................................................................................................... 11

3.1.4 Text Guideline #4: Other Encodings Are Supported ....................................................................................... 12

3.1.5 Text Guideline #5: Spaces and Unicode Characters ...................................................................................... 12

3.1.6 Text Guideline #6: Monospaced Font Is Supported ........................................................................................ 12

3.1.7 Text Guideline #7: CSS Support .................................................................................................................... 12

3.1.8 Text Guideline #8: Page Numbers.................................................................................................................. 14

3.1.9 Text Guideline #9: Customizing Font Selection .............................................................................................. 14

3.2 Cover Image Guidelines ....................................................................................................... 14

3.2.1 Cover Image Guideline #1: Marketing Cover Image Is Mandatory .................................................................. 14

3.2.2 Cover Image Guideline #2: Internal Content Cover Image Is Mandatory ........................................................ 15

3.2.3 Cover Image Guideline #3: Internal Cover Must Not Appear Twice ................................................................ 15

3.3 Table of Contents Guidelines ............................................................................................... 16

3.3.1 TOC Guideline #1: Logical TOC Is Recommended ........................................................................................ 16

3.3.2 TOC Guideline #2: HTML TOC Must Be Linked ............................................................................................. 18

3.3.3 TOC Guideline #3: HTML TOC Must Be Referenced ..................................................................................... 18

3.3.4 TOC Guideline #4: No Tables in TOC ............................................................................................................ 19

3.3.5 TOC Guideline #5: No Page Numbers in TOC ............................................................................................... 19

3.3.6 TOC Guideline #6: Place the TOC at the Front of the Book ............................................................................ 19

3.3.7 TOC Guideline #7: Include a TOC for Bundled Editions ................................................................................. 19

3.4 landmarks nav Elements Guidelines .................................................................................... 19

3.4.1 landmarks nav Elements Guideline #1: Recommended landmarks nav Elements .......................................... 19

3.5 Guide Item Guidelines .......................................................................................................... 19

3.5.1 Guide Item Guideline #1: Recommended Guide Items ................................................................................... 19

3.6 Image Guidelines .................................................................................................................. 19

3.6.1 Image Guideline #1: Use Supported Input Formats ........................................................................................ 20

Kindle Publishing Guidelines Amazon.com 2

Publishing on Kindle: Guidelines for Publishers

3.6.2 Image Guideline #2: KindleGen Performs Automatic Image Conversions ....................................................... 20

3.6.3 Image Guideline #3: Use Color Images .......................................................................................................... 20

3.6.4 Image Guideline #4: Photographs Should Use JPEG Format ......................................................................... 20

3.6.5 Image Guideline #5: Use GIF for Line-Art and Text ........................................................................................ 20

3.6.6 Image Guideline #6: Image and Font Size Requirements for Line-Art and Text .............................................. 21

3.6.7 Image Guideline #7: Prefer HTML to Images.................................................................................................. 23

3.6.8 Image Guideline #8: Image Caption Placement .............................................................................................. 24

3.6.9 Image Guideline #9: Controlling Image Aspect Ratio ...................................................................................... 24

3.6.10 Image Guideline #10: Displaying Text Correctly within SVG ......................................................................... 24

3.7 Table Guidelines ................................................................................................................... 25

3.7.1 Table Guideline #1: Use Tables for Tabular Data Only ................................................................................... 25

3.7.2 Table Guideline #2: Avoid Large Tables ......................................................................................................... 25

3.7.3 Table Guideline #3: Create Simple HTML Tables ........................................................................................... 26

3.7.4 Table Guideline #4: Split Tables as Needed ................................................................................................... 26

3.7.5 Table Guideline #5: Optimize for Maximum Table Size .................................................................................. 27

3.8 Adobe Digital Editions Compatibility Guidelines .................................................................. 27

3.8.1 Adobe Digital Editions Compatibility Guideline #1: Use Unique Item IDs ........................................................ 27

3.9 Styling Guidelines ................................................................................................................. 27

3.9.1 Styling Guideline #1: Use a Nested HTML TOC ............................................................................................. 27

3.9.2 Styling Guideline #2: Format Sidebars Correctly ............................................................................................ 28

3.10 HTML Guidelines ................................................................................................................ 28

3.10.1 HTML Guideline #1: Constructing Well-Formed HTML Documents (XHTML) ............................................... 28

3.10.2 HTML Guideline #2: Anchors Must Be Added Before Formatting Tags ......................................................... 28

3.10.3 HTML Guideline #3: EPUB Guide Items Are Optional .................................................................................. 28

3.10.4 HTML Guideline #4: Using Single Column Layout and Avoiding Absolute Positions ..................................... 28

3.10.5 HTML Guideline #5: Using position:absolute for Text on Image.................................................................... 28

3.10.6 HTML Guideline #6: Avoid Using Negative Values ....................................................................................... 29

3.10.7 HTML Guideline #7: Avoid Using Scripting ................................................................................................... 29

3.10.8 HTML Guideline #8: Avoid Using Negative Values for Line Height ............................................................... 29

3.11 Embedded Font Guidelines ................................................................................................ 29

4 Creating Fixed-Layout Children’s Books ............................................................................... 29

4.1 Metadata Fields Supporting Fixed-Layout Books ................................................................ 29

4.2 Content Requirements.......................................................................................................... 31

4.2.1 Requirement #1: Using HTML File Structure .................................................................................................. 31

4.2.2 Requirement #2: Using Region Magnification (Pop-ups) ................................................................................ 31

4.2.3 Requirement #3: Setting Images as Background Images ............................................................................... 33

4.3 Content Recommendations .................................................................................................. 33

4.3.1 Recommendation #1: Applying CSS Reset .................................................................................................... 33

4.3.2 Recommendation #2: Including One CSS File Per HTML Page ..................................................................... 33

4.3.3 Recommendation #3: Optimizing Content for Full Screen .............................................................................. 33

4.3.4 Recommendation #4: Using Large Region Magnification Tap Targets in Children’s Books ............................ 33

Kindle Publishing Guidelines Amazon.com 3

Publishing on Kindle: Guidelines for Publishers

4.3.5 Recommendation #5: Future-Proofing Fixed-Layout Content in Children’s Books .......................................... 34

4.3.6 Recommendation #6: Including Specific Fonts ............................................................................................... 34

4.3.7 Recommendation #7: Including HTML Front Cover ........................................................................................ 34

4.3.8 Recommendation #8: Including Back Cover ................................................................................................... 34

4.4 Creating Children’s Books with Multipage Background Images and Text ........................... 34

4.4.1 Using Side-by-Side Images to Form a Double-Page Spread When Orientation-Lock Is Set to Landscape ..... 34

4.4.2 Positioning Text Blocks .................................................................................................................................. 36

4.4.3 Aligning Text .................................................................................................................................................. 36

5 Creating Fixed-Layout Graphic Novels/Manga/Comics ........................................................ 36

5.1 Metadata Fields Supporting Fixed-Layout Books ................................................................ 36

5.2 Asset Requirements ............................................................................................................. 38

5.3 Image Quality ....................................................................................................................... 38

5.4 Panel View (Region Magnification) ...................................................................................... 38

5.5 Optimizing Content for the Graphic Novel Experience ......................................................... 40

5.5.1 Optimizing Tap Targets .................................................................................................................................. 40

5.5.2 Optimizing View Panels.................................................................................................................................. 40

5.5.3 Optimizing for Wide or Tall Action Scenes ...................................................................................................... 40

5.5.4 Optimizing for Large Text Blocks .................................................................................................................... 41

5.6 Virtual Panels in Comics and Manga ................................................................................... 43

5.6.1 Requirement #1: Pairing Pages When Orientation-Lock Equals None ............................................................ 44

6 Audio and Video Guidelines .................................................................................................... 48

6.1 Embedded Video .................................................................................................................. 48

6.2 Streaming Video ................................................................................................................... 48

6.3 Embedded Audio .................................................................................................................. 48

6.4 Streaming Audio ................................................................................................................... 49

6.5 Multimedia Directory ............................................................................................................. 49

6.6 Audio Guidelines .................................................................................................................. 49

6.7 Video Guidelines .................................................................................................................. 49

6.8 Audio and Video Metadata ................................................................................................... 50

6.9 NCX File ............................................................................................................................... 50

6.10 Images with Play Controls .................................................................................................. 50

6.11 File Names Are Case-Sensitive ......................................................................................... 51

6.12 Confirm Correct Mime-Type ............................................................................................... 51

6.13 File Size .............................................................................................................................. 51

6.14 Narration ............................................................................................................................. 51

6.15 Table of Contents ............................................................................................................... 51

6.16 Guidance on Media Captions ............................................................................................. 52

6.17 Custom Sample File ........................................................................................................... 52

Kindle Publishing Guidelines Amazon.com 4

Publishing on Kindle: Guidelines for Publishers

7 Dictionary Overview .................................................................................................................. 52

7.1 Metadata: Creating the OPF File .......................................................................................... 53

7.2 Basic Dictionary HTML ......................................................................................................... 53

7.3 Inflections for Dictionaries .................................................................................................... 53

7.3.1 Advanced inflection syntax ............................................................................................................................. 54

7.3.2 Simplified inflection syntax ............................................................................................................................. 54

7.4 Building a Dictionary with Kindlegen .................................................................................... 54

7.5 Testing Kindle Dictionaries ................................................................................................... 54

7.5.1 Format Testing ............................................................................................................................................... 54

7.5.2 Lookup Testing .............................................................................................................................................. 55

8 Media Queries ............................................................................................................................ 56

8.1 Using Media Queries ............................................................................................................ 56

8.2 Using Media Queries for Backward Compatibility With Mobi ............................................... 59

8.3 Submitting a Media Query .................................................................................................... 60

8.3.1 Option 1: Using One CSS File. ....................................................................................................................... 60

8.3.2 Option 2: Using Different CSS Files ............................................................................................................... 61

8.3.3 Option 3: Using Style tags .............................................................................................................................. 61

8.3.4 Option 4: Using @import ................................................................................................................................ 61

8.4 Using the display:none Property with Media Queries .......................................................... 61

8.4.1 Using the display:none Property with Complex Tables ................................................................................... 62

8.4.2 Using the display:none Property with SVG Images......................................................................................... 63

8.4.3 Limitation on Using the display:none Property ................................................................................................ 64

9 Kindle Best Practices ............................................................................................................... 64

9.1 Testing Kindle Books ............................................................................................................ 64

10 Kindle Quality Guidelines ...................................................................................................... 65

11 Appendices .............................................................................................................................. 66

11.1 Appendix A: HTML Tags Supported in Kindle Format 8 .................................................... 66

11.2 Appendix B: CSS Selectors, Attributes, and Properties Supported in Kindle Format ........ 70

11.3 Appendix C: Guidelines for Converting XMDF to KF8 ....................................................... 75

11.3.1 Kindlegen Command .................................................................................................................................... 75

11.3.2 Source Issues .............................................................................................................................................. 75

11.3.3 Unsupported Features.................................................................................................................................. 77

Kindle Publishing Guidelines Amazon.com 5

Publishing on Kindle: Guidelines for Publishers

1 Getting Started

There are several options for making your books available for the Amazon Kindle platform. Which option is best for you depends upon the nature of your publications (such as your source file format), your available resources and technical expertise, and your eBook sales model. To help you choose, here are examples of common publishing scenarios and recommendations:

• For self-publishers or authors who would like to take advantage of Amazon’s self-service tools to

create Kindle Books and sell them on Amazon, see section 2.1, Amazon’s Kindle Direct

Publishing Platform.

• For publishers with many titles to convert and the expertise to create Kindle books in-house using

Kindle Publisher Tools software, see section 2.2, Creating Kindle Books In-House Using Kindle

Publisher Tools.

• For publishers who do not wish to convert titles in-house or do not have the technical expertise to

do so, outsourcing to a conversion house is described in section 2.3, Third-Party Conversion

Services.

2 Paths to Getting Your Content on Kindle

2.1 Amazon’s Kindle Direct Publishing Platform

Self-publishers can convert books into electronic format using Amazon's self-publishing tools and sell them on Amazon Kindle with Amazon's Kindle Direct Publishing Platform (KDP). KDP is a fast, easy selfpublishing system for the Amazon Kindle. Upload your content, enter sales copy and pricing information, and publish in minutes. To learn more or sign up, visit http://kdp.amazon.com

.

2.2 Creating Kindle Books In-House Using Kindle Publisher Tools

Publishers can create Kindle books in-house from Adobe InDesign content, HTML, XHTML, and EPUB files by using the Kindle Publisher tools. Amazon officially supports these tools to convert files to Kindle

Format 8. Kindle files created with these tools are designed to be compatible with current and future

Kindle devices and applications. Files created with third-party software may not work properly on current or future Kindle devices and applications.

2.2.1 Kindle Plugin for Adobe InDesign

Publishers can create Kindle books in-house from Adobe InDesign content by using a free software program called Kindle Plugin for Adobe InDesign. This plug-in allows the publisher to convert content from InDesign into Kindle format. The current version of the Kindle Plugin for Adobe InDesign supports

Kindle Format 8. Go to www.amazon.com/kindleformat/kindleplugin for plug-in download, installation documentation, help documentation, and details of the options currently supported in Kindle Plugin for

Adobe InDesign.

2.2.2 KindleGen

Publishers can create Kindle books in-house by using a free software program called KindleGen. This is a command line tool designed for building Kindle ebook. KindleGen accepts source content in HTML,

XHTML, or EPUB format.

The most recent version of KindleGen can be downloaded for free from www.amazon.com/kindleformat/kindlegen . Amazon periodically releases new versions of the KindleGen software. Check the site regularly for updates. To create books for Kindle Format 8, use KindleGen 2 or later versions.

2.2.2.1 Source Files to Use with KindleGen

To create Amazon Kindle files using KindleGen, you need:

• A single HTML file that represents the entire book; or

Kindle Publishing Guidelines Amazon.com 6

Publishing on Kindle: Guidelines for Publishers

• EPUB-compliant files. (IDPF’s EPUB spec is available at http://idpf.org/EPUB/30/spec/EPUB30overview.html

)

Using the EPUB spec, you can create a Kindle book with multiple HTML files and a single OPF file that links all of them together.

2.2.2.2 Installing KindleGen

IMPORTANT: Follow these steps to run KindleGen. Double-clicking the KindleGen icon does not launch this program.

KindleGen for Windows (XP, Vista, 7)

1. Download the KindleGen zip file from www.amazon.com/kindleformat/kindlegen to the desktop.

2. Right-click the zip file, select Extract All, and enter the folder name as c:\Kindlegen.

3. Open a command prompt by selecting Start menu > All Programs > Accessories > Command

Prompt.

4. Type c:\KindleGen\kindlegen. Instructions on how to run KindleGen are displayed.

Conversion Example: To convert a file called book.html, use change directory (cd) to go to the directory where the book is located, for example cd desktop, and type c:\KindleGen\kindlegen

book.html. If the conversion was successful, a new file called book.mobi displays on the desktop.

KindleGen for Linux 2.6 i386 or higher

1. Download the KindleGen tar.gz from www.amazon.com/kindleformat/kindlegen to a location such as the home (~) directory.

2. Extract it to ~/KindleGen.

3. Open a command prompt and type ~/KindleGen/kindlegen. Instructions on how to run

KindleGen are displayed.

Conversion Example: To convert a file called book.html, use change directory (cd) to go to the directory where the book is located, for example, cd desktop, and type ~/KindleGen/kindlegen

book.html. If the conversion was successful, a new file called book.mobi displays on the desktop.

KindleGen for Mac OS 10.5 and above i386

1. Download KindleGen.zip from www.amazon.com/kindleformat/kindlegen . By default, the file is downloaded in the Downloads folder

2. Unzip the file. In Safari, the zip file is automatically unzipped after download. If this setting is disabled or if another browser was used, double-click the downloaded file to unzip it.

3. Click the spotlight icon in the top right corner and type Terminal. Click the application to open it.

4. To view the instructions on how to run KindleGen, locate the kindlegen program in the Finder window. Click and drag it to Terminal window where the cursor is. The cursor writes in the path and moves to the end of the line. Press Enter to view the instructions. o

Alternatively, view the instructions by typing the command cd

~/Downloads/KindleGen_Mac_i386_v2 in Terminal and then typing the command

kindlegen.

Conversion Example:

1. To convert a file called book.html, copy book.html to the desktop.

2. In the Finder window, locate the kindlegen program. Click and drag it to the Terminal window, and drop it where the cursor is. The cursor inserts the path automatically and moves to the end of that line.

Kindle Publishing Guidelines Amazon.com 7

Publishing on Kindle: Guidelines for Publishers

3. In the Finder window, locate the document. Click and drag it to the Terminal window, and drop it where the cursor is. The cursor writes in the path and moves to the end of the line.

Press Enter. If the conversion was successful, a new file called book.mobi displays on the desktop. o

Alternatively, convert the file by typing the command cd

~/Downloads/KindleGen_Mac_i386_v2 in Terminal and then typing the command

kindlegen ~/Desktop/book.html. If the conversion was successful, a new file called

book.mobi displays on the desktop.

2.2.2.3 Using KindleGen

To convert an EPUB or HTML book to the Kindle Format 8, use KindleGen version 2 or higher as described below:

C:> kindlegen filename.opf/.htm/.html/.epub [-c0 or -c1 or c2] [-verbose] [-western]

[-o <file name>]

Options:

-c0: no compression

-c1: standard DOC compression

-c2: Kindle huffdic compression (recommended for large, text-heavy files)

-o <file name>: Specifies the output file name. Output file will be created in the same directory as that of input file. <file name> should not contain directory path.

-verbose: provides more information during ebook conversion

-western: force build of Windows-1252 book

-releasenotes: display release notes

-gif: images are converted to GIF format (no JPEG in the book)

-locale <locale option>: To display messages in the selected language.

en: English

de: German

fr: French

it: Italian

es: Spanish

ch: Chinese

ja: Japanese

bp: Brazilian Portuguese

2.2.2.4 KindleGen Messages

If KindleGen encounters issues while converting a file, it displays a warning or error.

• Errors impair the readability of the book in the Kindle Reader. It is critical to address errors before the book can be converted and published.

• Warnings cause loss of non-essential functionality when the file is converted. KindleGen will attempt to introduce a work-around that will not impair the reading experience. However, it is best practice to address all warnings as well as errors before publishing.

As conversion progresses, KindleGen displays detailed informational messages.

Kindle Publishing Guidelines Amazon.com 8

Publishing on Kindle: Guidelines for Publishers

2.2.3 Kindle Previewer Software

Kindle Previewer is graphical user interface tool that imitates how books display on Kindle devices and applications. Kindle Previewer makes it easy to preview the layout of a book and make sure its text displays properly for any orientation or font size. To produce the highest quality Kindle books, Amazon recommends this tool in combination with KindleGen.

Kindle Previewer is available for the Windows and Mac OS X platforms.

2.2.3.1 Installing Kindle Previewer

The most recent version of Kindle Previewer can be downloaded for free from www.amazon.com/kindleformat/kindlepreviewer . Installation and help documentation can be found at http://kindlepreviewer.s3.amazonaws.com/UserGuide.pdf

.

Kindle Previewer for Windows (XP, Vista, 7, 8)

1. Download Kindle Previewer for Windows from www.amazon.com/kindleformat/kindlepreviewer .

2. Store the executable (KindlePreviewerInstall.exe) to the local disk.

3. Execute KindlePreviewerInstall.exe by double-clicking it.

4. Accept the EULA from the dialog box with details to install Kindle Previewer.

5. Kindle Previewer appears in Start > Programs > Amazon > Kindle Previewer after successful installation.

Kindle Previewer for Mac OS 10.6 and above i386

1. Download Kindle Previewer for Intel Mac from www.amazon.com/kindleformat/kindlepreviewer .

2. Save the zip file (KindlePreviewer.zip) to the local disk.

3. Double-click the zip file to unzip Kindle Previewer.

4. Drag Kindle Previewer from Downloads folder to Application folder.

5. Start Kindle Previewer.

Use F1 or the Help menu to find the Kindle Previewer User’s Guide.

2.3 Third-Party Conversion Services

Publishers have the option to outsource conversion of titles from a variety of formats to eBook formats.

Conversion houses offer publishers solutions and services that include taking a variety of input formats and creating eBook or print-ready output. The typical input formats are:

• Word (.DOC, .DOCX), Rich Text Format (.rtf), Text (.txt)

• PDF

• Scan of print book

• FrameMaker, InDesign, PageMaker, QuarkXPress

• XML (such as DocBook, etc.)

• HTML, XHTML

• EPUB (also known as IDPF or OEB)

The process of converting non-reflowable content (such as PDF or scans) to reflowable content is laborintensive and requires specialized formatting knowledge.

As you explore conversion house options, Amazon recommends that you confirm which source format(s) the conversion house requires to convert files for use on Kindle.

The preferred outputs from conversion houses to be processed by Amazon are:

Kindle Publishing Guidelines Amazon.com 9

Publishing on Kindle: Guidelines for Publishers

• Books in Amazon Kindle Format (.mobi/.prc)

• Metadata in ONIX format (XML)

Amazon can also process content in EPUB source format. KindleGen compiles the file and runs checks for common errors. Any errors or warnings will prevent the titles from becoming available. These errors must be fixed in the EPUB file before the title is published in the Kindle store. Titles in EPUB format must be tested on Amazon software and/or hardware and must abide by the publishing guidelines in this document.

Conversion houses can be of service in helping publishers supply eBook retailers with metadata. Search the web for “eBook conversion” to find a list of partners to work with.

3 General Formatting Guidelines

Kindle Format 8 (KF8) is the next generation file format (replacing Mobi 7) for Kindle books and supports

HTML 5 and CSS 3. The following table outlines Kindle Format 8 features and device/application support:

Features & Benefits

Full support for CSS to enable publishers to control all elements of the text layout, including line spacing, alignment, justification, margin, color, style, & border.

Support for drop cap character at the beginning of paragraphs.

Support for floating elements that includes boxed text, callouts, sidebars, & images with text wrapping.

Support for numbered and bulleted lists.

Support for nested tables and merged cells required by technical and textbooks.

Support for background images on pages and for text on background images.

Support for Scalable Vector Graphics (SVG) that can be zoomed without loss of fidelity.

Support for embedded fonts that allows publishers to have a custom look & feel for the book.

Support for rounded corners of boxed elements.

Support for drop shadow.

Support for outline text.

Support for multiple and repeated background images.

Support for color gradient.

Enables fine-grained control of attributes for text and other elements through CSS selectors.

Support for fixed-layout pages for specified screen sizes.

All Kindle Devices and Apps except 1 st

& 2 nd

Generation

Kindles and Kindle DX

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

There are important differences between writing HTML for websites and for Kindle books. To provide a good reading experience, many website design practices should be avoided when creating Kindle books.

Refer to the following sections for more information.

Kindle Publishing Guidelines Amazon.com 10

Publishing on Kindle: Guidelines for Publishers

Support for Chinese, Japanese, and Korean Text

Kindle devices newer than and including the Paperwhite and Fire HD support right to left vertical scripts and Japanese Ruby script. Older e Ink and tablet devices are limited to horizontal left to right Chinese,

Japanese, and Korean text.

3.1 Text Guidelines

3.1.1 Text Guideline #1: Body Text Must Use Defaults

The body text in a reflowable Kindle book (fiction and non-fiction) must be all defaults. Amazon encourages content creators to use creative styles for headings, special paragraphs, footnotes, tables of contents, etc., but not for body text. The reason for this is that any styling on body text in the HTML will override the user’s preferred default reading settings. Users report such behavior as a poor reading experience. Here are the most important points:

• Body text must not have a forced alignment (such as left aligned or justified).

• Body text must use the default font size and line height. Body text should not use the <font size=”…”>

tag or the font-size and line-height attributes in CSS.

• Body text should not be primarily bold or italicized. Selected parts of the text can be bold or italicized for emphasis. This guideline only prohibits a book from being entirely bold, for example.

• Body text should not have an imposed font color throughout the book. If you prefer to use imposed font color in some sections of your book, please do not use too light or too dark color.

Light colors will not display with enough contrast on devices set to white backgrounds or on e Ink devices. Dark colors will not display well on devices set to black backgrounds. For grays, use colors within the hex value range of #666 to #999.

• Body text must not have a white or black font color. Customers report this as a bad user experience because the text can become invisible when the Kindle is set to the same background color as the font.

• Body text must not have a black or white background color. Customers report this as a bad user experience because it can create an awkward, boxy reading experience when the device background is set to a different color and because the text can become invisible when a user changes the background color setting on their device and the font color automatically inverts.

• Customers report that they enjoy having the option to select a preferred typeface from a list of device defaults..

3.1.2 Text Guideline #2: Use CSS for Page Breaks

Do not insert blank lines of text to create page breaks. Use the CSS page-break-before and pagebreak-after

attributes.

3.1.3 Text Guideline #3: Formatting Paragraphs

KindleGen automatically indents the first line of every paragraph by default. To change this behavior, use the text-indent style on the <p> tag. For example:

• <p style=”text-indent:0"> - no indentation of the first line

• <p style=”text-indent:10%"> - positive indent, 10% of the width of the page

• <p style=”text-indent:5em"> - positive indent, 5 em

To change the space before each paragraph, use the margin-top style on the <p> tag.

Kindle Publishing Guidelines Amazon.com 11

Publishing on Kindle: Guidelines for Publishers

3.1.4 Text Guideline #4: Other Encodings Are Supported

The source of a Kindle book can be encoded in many different ways. All encodings are supported, provided that:

• The encoding of the HTML files is clearly stated in the HTML; and

• The computer used for compiling the sources supports the encoding and knows how to convert it to UNICODE.

Amazon recommends specifying the encoding of the HTML files in the HTML itself by using the <meta> tag in the <head> section.

Example

<html>

<head>

…

<meta http-equiv="content-type" content="text/html; charset=iso-

8859-1">

…

3.1.5 Text Guideline #5: Spaces and Unicode Characters

The only supported spaces are the normal space, the non-breakable space (&nbsp;) and the zero-width non-joiner (&zwnj;). Use of any other space can break the selection, dictionary lookup, and line-wrap algorithms.

Do NOT use Unicode format characters, as they may cause problems.

3.1.6 Text Guideline #6: Monospaced Font Is Supported

Kindle uses a default font for content if none is specified; it also supports a monospaced font.

Kindle uses the monospaced font to render content in the following tags: <pre>, <code>, <samp>,

<kbd>, <tt>, <font face=”courier”>, <font face=”monospace”>.

With the exception of <pre>, the tags listed above do not change the text alignment. If the content in these tags should be left-aligned, wrap the tags listed above in a <div> styled with CSS using textalign:left

.

Publishers can include their own font for their content. Amazon has a quality assurance process to ensure that these fonts display well on e Ink-based devices and do not impair the reading experience. Do not include the Charis font; it is replaced with a higher quality font in the Kindle Readers.

3.1.7 Text Guideline #7: CSS Support

The earlier Kindle platform offered very basic support for Cascading Style Sheets (CSS). This has been

significantly enhanced in KF8 with support for CSS 2/CSS 3. (See section 11.2 for the list of supported

CSS attributes/selectors). To verify that your use of CSS elements displays the way you intended, preview your Kindle book on different devices before publishing it.

Avoid using fixed values such as points and pixels for CSS properties such as font-size, width, height

, margin, padding, text-indent, and line-height. To enable rendering across various screen sizes and resolutions, specify these values in percentages.

When using the margin and padding CSS properties, specify the values in percentage (%) instead of em units. This ensures that the margins do not grow wide with large font sizes. Margins should be assigned values of 0 or greater to keep content from falling off the edge of the screen or overlapping

Kindle Publishing Guidelines Amazon.com 12

Publishing on Kindle: Guidelines for Publishers other content. Always set left and right margins to 0 for normal body text to allow users the full range of margin selection using device defaults.

To ensure pagination, the Kindle Reader does not honor line-height value less than 1.2 em or 120%.

Elements such as drop caps should be specified using percentages or relative units (positive or negative) instead of fixed values such as points and pixels. (Example: drop caps: Use font-size: 300%). The top of the drop cap should be aligned with the body text. To create drop caps, Amazon recommends using the following sample CSS:

Example

p.para {

font-family: "Times New Roman";

font-size: 4em;

margin-bottom: 0;

margin-top: 0;

text-align: justify;

text-indent: 0;

}

@media amzn-kf8

{

span.dropcaps

{

font-weight:normal;

font-size:320%;

float:left;

margin-top:-0.3225em;

margin-bottom:-0.3245em;

}

}

@media amzn-mobi

{

span.dropcaps

{

font-size:3em;

font-weight: bold;

}

}<p class="para"><span class="dropcaps">T</span>here is a sample

Kindle Publishing Guidelines Amazon.com 13

Publishing on Kindle: Guidelines for Publishers

To verify that the drop caps display as intended, test the book as described in section 9.1, Testing Kindle

Books.

3.1.8 Text Guideline #8: Page Numbers

Kindle books do not always map directly to page numbers in physical editions of the book. For this reason, there should not be any reference to page numbers in the book. Page numbers should not be included in cross-references or the index. Amazon may make page numbers available for books as additional book metadata. Amazon generates these page numbers based on its own internal technology.

3.1.9 Text Guideline #9: Customizing Font Selection

The primary or main font in a book should be set at the <body> level. If you prefer to use additional text styling such as bold or italics, ensure that the styles are set on the text rather than the font so that any font that the customer selects correctly displays these styling elements. Below are examples of both correct and incorrect implementation of customizing fonts in an ebook.

Correct HTML Code Incorrect HTML Code

<html>

<body>

<p style=

"

font-family:PrimaryFont

"

>

Primary font content </p>

<html>

<body style=

" font-family:PrimaryFont

"

>

<p> Primary font content </p>

<p style=

" font-family:SecondaryFont

"

>

Secondary font content</p>

<p style=

" font-family:SecondaryFont

"

>

Secondary font content </p>

<p style="font-family:PrimaryFont

Primary font content </p>

"

>

<p> Primary font content </p>

<p> Primary font content </p>

</body>

</html>

<p style="font-family:PrimaryFont">

Primary font content </p>

</body>

</html>

The same behavior can be achieved by using CSS classes as shown below.

Incorrect CSS Code body{ font-size: asize;

}

.indent { font-size: asize;

font-family: PrimaryFont;

}

.sidebar-text { font-family: SecondaryFont; weight: bold;

}

Correct CSS Code body { font-family: PrimaryFont; font-size: asize;

}

.indent { font-size: asize;

}

.sidebar-text { font-family: SecondaryFont; weight: bold;

}

3.2 Cover Image Guidelines

3.2.1 Cover Image Guideline #1: Marketing Cover Image Is Mandatory

Kindle books must have a marketing cover image provided for use on the website detail page. The preferred format for the cover is a JPEG image of 2500 pixels on the longest side (with a minimum of

1000 pixels on the longest side). Covers with less than 500 pixels on the smaller side are uploaded, but

Kindle Publishing Guidelines Amazon.com 14

Publishing on Kindle: Guidelines for Publishers are not displayed on the website. No error message is given at time of upload if the image size is too small. If the cover is smaller than the required size, do not stretch it, because this does not add any quality.

The content of the cover image should not:

• Infringe another publisher’s or artist’s copyright on the same cover.

• Mention pricing or other temporary promotional offers.

3.2.2 Cover Image Guideline #2: Internal Content Cover Image Is Mandatory

Kindle books must have an internal cover image provided for use within the book content. Provide a large, high-resolution cover, because Amazon quality assurance will fail the book if the cover is too small.

Define covers in the OPF file using either of the following methods:

Method 1:

<manifest>

...

<item id="cimage" media-type="image/jpeg" href="other_cover.jpg" properties="coverimage"/>

...

</manifest>

This syntax is part of IDPF 3.0 standard and described at http://idpf.org/epub/30/spec/epub30publications-20111011.html#sec-item-property-values .

Method 2:

<metadata>

...

<meta name="cover" content="my-cover-image" />

...

</metadata>

...

<manifest>

...

<item href="MyCoverImage.jpg" id="my-cover-image" media-type="image/jpeg" />

...

</manifest>

The use of name=”cover” in the metadata element name is mandatory.

This syntax is not part of the IDPF standard, because the standard does not provide for cover images.

However, it was designed with help from the IDPF and will validate in an IDPF validator.

3.2.3 Cover Image Guideline #3: Internal Cover Must Not Appear Twice

Do not add cover images to the content in any way other than those described in section 3.2.2, Cover

Image Guideline #2: Internal Content Cover Image Is Mandatory, or the cover might appear twice in the

book.

Kindle Publishing Guidelines Amazon.com 15

Publishing on Kindle: Guidelines for Publishers

There is one exception for reflowable books (fiction and non-fiction): if you want an HTML cover page for compatibility with software from other vendors, in addition to the proper logical cover, add all of the following tags in the OPF file (underlined elements are mandatory):

<spine> <itemref idref="my-html-cover" linear="no" /> </spine>

...

<manifest> <item id="my-html-cover" href="cover.html" mediatype="application/xhtml+xml" /> </manifest>

...

And in the landmarks nav element, add the following tags (underlined elements are mandatory):

<nav epub:type="landmarks">

<ol> <li><a epub:type="cover" href="cover.html "> Cover Image </a> </li></ol>

</nav>

The cover can also be specified using a guide item in OPF instead of a landmarks nav element

(underlined elements are mandatory):

<guide> <reference type="cover" title="Cover Image" href="cover.html" /> </guide>

3.3 Table of Contents Guidelines

Amazon strongly recommends the use of an HTML TOC for all books that would benefit from this navigation feature. This applies to most books, with the exception of fixed-layout children's books (see

section 4) and fixed-layout graphic novels/manga/comics (see section 5).

3.3.1 TOC Guideline #1: Logical TOC Is Recommended

Amazon strongly recommends that all Kindle books include both logical and HTML TOCs. The logical

TOC is very important for a good reading experience, because it allows a reader to navigate between chapters easily. Users expect to see an HTML TOC when paging through a book from the beginning, while the logical TOC is an additional way for users to navigate books. The inclusion of a logical TOC is especially important for books that are longer than 20 pages.

Logical TOCs are generated using toc nav elements or a navigational control file for XML application

(NCX). Creating a logical TOC exposes the hierarchical structure of a Kindle book and allows the user to navigate through it.

In logical TOC-enabled books, users can see where they are in the book because the part, chapter, or section is exposed. This progress indicator also shows relative progress through the book.

Important: Nested anchor tags are not supported in fixed-layout books. Fixed-layout books with nested anchor tags will be suppressed.

3.3.1.1 Creating a Logical TOC Using a toc nav Element

The toc nav element is part of the IDPF 3.0 specification and is described at http://idpf.org/epub/30/spec/epub30-contentdocs-20111011.html#sec-xhtml-nav-def-model and http://idpf.org/epub/30/spec/epub30-contentdocs-20111011.html#sec-xhtml-nav-def-types-toc .

Creating a toc nav element provides both a logical TOC and an HTML TOC.

Example:

<nav epub:type="toc">

<ol>

<li><a href=”Sway_body.html#preface_1">AUTHOR'S NOTE</a></li>

<li><a href=”Sway_body.html#part_1">PART ONE</a>

Kindle Publishing Guidelines Amazon.com 16

Publishing on Kindle: Guidelines for Publishers

<ol>

<li><a href="Sway_body.html#chapter_1">THE HOUSES, 1969</a></li>

<li><a href="Sway_body.html#chapter_2">ROCK AND ROLL, 1962</a></li>

<li><a href="Sway_body.html#chapter_3">THE EMPRESS, 1928–1947</a></li>

</ol>

</li>

</ol>

</nav>

The example above defines the following TOC hierarchy:

AUTHOR'S NOTE

PART ONE

THE HOUSES, 1969

ROCK AND ROLL, 1962

THE EMPRESS, 1928–1947

This excerpt from the OPF (publication header file) shows how to declare the toc nav element in the

<manifest>

:

Example:

<manifest>

<item id="toc" properties="nav" href="xhtml/toc.xhtml" mediatype="application/xhtml+xml"/>

Using it in the <spine> is optional if it will be used as the HTML TOC.

<spine>

<itemref idref="toc"/>

3.3.1.2 Creating a Logical TOC Using NCX

NCX is part of the IDPF 2.0 specification and is described at http://www.niso.org/workrooms/daisy/Z39-

86-2005.html#NCX.

NCX Example:

<navMap>

<navPoint class="titlepage" id="L1T" playOrder="1">

<navLabel><text>AUTHOR'S NOTE</text></navLabel>

<content src=”Sway_body.html#preface_1" />

</navPoint>

<navPoint class="book" id="level1-book1" playOrder="2">

<navLabel><text>PART ONE</text></navLabel>

<content src=”Sway_body.html#part_1" />

<navPoint class="chapter" id="level2-book1chap01" playOrder="3">

<navLabel><text>THE HOUSES, 1969</text></navLabel>

Kindle Publishing Guidelines Amazon.com 17

Publishing on Kindle: Guidelines for Publishers

<content src="Sway_body.html#chapter_1" />

</navPoint>

<navPoint class="chapter" id="level2-book1chap02" playOrder="4">

<navLabel><text>ROCK AND ROLL, 1962</text></navLabel>

<content src="Sway_body.html#chapter_2" />

</navPoint>

<navPoint class="chapter" id="level2-book1chap03" playOrder="5">

<navLabel><text>THE EMPRESS, 1928–1947</text></navLabel>

<content src="Sway_body.html#chapter_3" />

</navPoint>

</navPoint>

</navMap>

The NCX example above defines the following TOC hierarchy:

AUTHOR'S NOTE

PART ONE

THE HOUSES, 1969

ROCK AND ROLL, 1962

THE EMPRESS, 1928–1947

This excerpt from the OPF (publication header file) shows how to add an NCX table of contents to a book.

Declare the NCX in the <manifest>:

<manifest>

<item id="toc" media-type="application/x-dtbncx+xml" href="toc.ncx"/>

And use it in the <spine>:

<spine toc="toc">

3.3.2 TOC Guideline #2: HTML TOC Must Be Linked

Place an HTML page with a table of contents at the beginning of the book, so that users can easily jump to locations within it (typically to a chapter). The entries in the TOC must be HTML links so that users can click to go to a specific location. A table of contents that is not made of links is not useful on Kindle.

3.3.3 TOC Guideline #3: HTML TOC Must Be Referenced

To enable the customer to jump to the TOC from the Kindle menu, the OPF file must reference the TOC from a TOC guide item or the navigation html file must reference a TOC in a landmarks nav element.

Every Kindle device or application has a user interface element that allows the user to jump to the TOC guide item or TOC item in a landmarks nav element from anywhere in the book.

Here is an example of a guide item for a TOC (underlined elements are mandatory):

<guide> <reference type="toc" title="Table of Contents" href="toc.html"/> </guide>

Here is an example of a landmarks nav element for a TOC (underlined elements are mandatory):

<nav epub:type="landmarks">

<ol><li><a epub:type="toc" href="toc.html">Table of Contents</a></li></ol>

Kindle Publishing Guidelines Amazon.com 18

Publishing on Kindle: Guidelines for Publishers

</nav>

3.3.4 TOC Guideline #4: No Tables in TOC

Do not create a TOC using HTML <table> tags. When the TOC includes HTML <table> tags, the links of the TOC become not clickable/ non-functional. Tables are for tabular data only, not for layout.

3.3.5 TOC Guideline #5: No Page Numbers in TOC

Do not use page numbers in the TOC. Kindle books do not always map directly to page numbers in physical editions of the book.

If you are importing the document from Word, use the “Heading” styles and the "Table of Contents" feature of Microsoft Word. The TOC created by Word will be imported correctly and will convert to a TOC that follows these guidelines.

3.3.6 TOC Guideline #6: Place the TOC at the Front of the Book

Place the HTML TOC towards the beginning of the book and not at the end of the book. This ensures that a customer paging through the book from the beginning encounters the TOC naturally. Incorrect placement of the TOC affects the accuracy of the “Last Page Read” feature. Correct placement ensures that the TOC appears in sample downloads of the book.

3.3.7 TOC Guideline #7: Include a TOC for Bundled Editions

For bundled editions containing more than one individual book, include an overarching TOC at the beginning of the file.

3.4 landmarks nav Elements Guidelines

3.4.1 landmarks nav Elements Guideline #1: Recommended landmarks nav Elements

The Kindle platform supports landmarks nav elements for defining the cover, table of contents (TOC), and start reading location (”Go to Beginning”). Do not set the start reading location to a blank page.

Amazon does not recommend adding additional landmarks nav elements to the OPF file, because they will be grayed out in the menu options and may cause customer confusion.

IMPORTANT: The landmarks nav elements, especially the TOC landmarks nav element, do not replace the table of contents.

The landmarks nav elements are part of the IDPF 3.0 specification and are described at: http://idpf.org/epub/30/spec/epub30-contentdocs-20111011.html#sec-xhtml-nav-def-model and http://idpf.org/epub/30/spec/epub30-contentdocs-20111011.html#sec-xhtml-nav-def-types-landmarks .

3.5 Guide Item Guidelines

3.5.1 Guide Item Guideline #1: Recommended Guide Items

The Kindle platform supports guide items for defining the cover, the table of contents (TOC), and the start reading location (”Go to Beginning”). Do not set the start reading location to a blank page.

Amazon does not recommend adding additional guide items to the OPF file, because they will be grayed out in the menu options and may cause customer confusion.

IMPORTANT: Guide items, especially the TOC guide item, do not replace the table of contents.

3.6 Image Guidelines

These guidelines apply to most books, but are not applicable to the image-intensive fixed-layout children's

books (see section 4) and fixed-layout graphic novels/manga/comics (see section 5).

Kindle Publishing Guidelines Amazon.com 19

Publishing on Kindle: Guidelines for Publishers

3.6.1 Image Guideline #1: Use Supported Input Formats

The Kindle platform supports GIF, BMP, JPEG, non-transparent PNG, and Scalable Vector Graphics

(SVG) images.

When using images for schemas, charts, tables, maps, or anything that includes text, pay special attention to the legibility of the final image.

Add images to the source using the standard HTML <img> tag.

Use a resolution of 300 dpi or 300 ppi for all images.

3.6.2 Image Guideline #2: KindleGen Performs Automatic Image Conversions

The limitation on the image size depends upon the book’s format:

• Reflowable books (fiction and non-fiction): 127 KB maximum

• Fixed-layout books (other than comics): 256 KB maximum

• Comic books: 800 KB maximum

You will obtain the best results by optimizing your images to the highest quality possible within the file size limit before inputting your files into KindleGen.

If the automatic image conversion is unsatisfactory, try optimizing the images before feeding them to

KindleGen. If the images are in the JPEG or GIF formats and are less than 127 KB in size, KindleGen does not alter them. For fixed-layout books and comic books, KindleGen reduces the quality factor of the image, but not the resolution. If the image cannot be scaled down to meet the size limits by reducing quality factor up to 40%, KindleGen fails the conversion process.

3.6.3 Image Guideline #3: Use Color Images

Use color images whenever possible and relevant. The Kindle e Ink devices currently have a black and white screen, but color is available on the Kindle Fire, Kindle for iPhone, and Kindle for PC.

3.6.4 Image Guideline #4: Photographs Should Use JPEG Format

Photographs should use the JPEG format with a quality factor of 40 or higher. Photographs should use the highest resolution available within the file size limit. KindleGen reprocesses the photographs as needed to adapt them to the requirements of the file format.

Photographs should not be too small. Make sure that input photos are at least 600 x 800 pixels in size,

unless you optimize them according to section 3.6.2, Image Guideline #2: KindleGen Performs Automatic

Image Conversions. Photographs of less than 300 x 400 pixels are much too small and can be rejected.

If the photographs are in GIF format or are too small, converting them to JPEG or artificially increasing the size does not improve the quality. Go back to the original source to create a JPEG image with sufficient resolution.

3.6.5 Image Guideline #5: Use GIF for Line-Art and Text

Line-art is graphics drawn with a limited number of solid colors (such as images drawn by Illustrator,

Paint, or Power Point). Text, graphics, charts, and tables are examples of images that are line-art.

Line-art should be in GIF format. The JPEG algorithm tries to blend parts of the image together, and blurs the sharp edges of the line-art.

Text appearing in line-art images should be sharp and legible.

Optimize line-art GIFs before submitting them to KindleGen. Resizing or JPEG compression can introduce blurriness or unwanted artifacts in line-art images, which is why the automatic conversions applied by KindleGen are best avoided.

To optimize the GIFs and make them fit in the 127 KB limit, try the following tips:

Kindle Publishing Guidelines Amazon.com 20

Publishing on Kindle: Guidelines for Publishers

• Try reducing the number of colors used. This can often be done without altering the quality of the image. Line-art images that appear to be black and white might actually be in color because of certain anti-aliasing algorithms. Here is an example (notice the shades of red and blue around the

“A” in the left picture):

• Remove white margins around the image, if any exist. When cropping, consider how the image will look on devices set to white, sepia, and black backgrounds.

• Resize the image, if necessary, but pay close attention to the legibility of text (see section 3.6.6,

Image Guideline #6: Image and Font Size Requirements for Line-Art and Text).

3.6.6 Image Guideline #6: Image and Font Size Requirements for Line-Art and Text

An image containing text should not be significantly larger than a screen. The Kindle e Ink devices offer the possibility to rotate an image to use more screen real estate. The Kindle Fire and the Kindle for iPhone application allow zooming and panning. However, reading experience degrades rapidly for very large line-art images.

The following rules ensure a good rendering on all Kindle platforms for line-art images containing text:

• The MAXIMUM image size is 500 x 600 pixels. This ensures that the image is not shrunk on a

Kindle device, which could make the text illegible.

• The MINIMUM size of text is 6 pixels for the height of a lowercase “a.”

These rules limit the size of tables rendered as pictures. Larger tables should be reformatted.

Example Images

Image Description

A table with line-art/text content rendered as an image. This

GIF image is 317 x 233 pixels and 6 KB in size. The text is sharp and legible. The font size requirement is met (“a” is 7 pixels high).

Kindle Publishing Guidelines Amazon.com 21

Publishing on Kindle: Guidelines for Publishers

Description

The same image with JPEG compression. Compression artifacts appear, making the text blurry although it remains legible. The size has increased to 17 KB.

Image

Bad quality: The image is blurry because of resizing and JPEG compression. The text is not legible. This will be rejected.

An example of the largest acceptable table rendered as an image is given below. The size is 500 x 600 pixels, which is the maximum. The font uses a body size (height of an “a”) of 7 pixels, which is just above the 6 pixel minimum. The size of the GIF is 33 KB.

Kindle Publishing Guidelines Amazon.com 22

Publishing on Kindle: Guidelines for Publishers

3.6.7 Image Guideline #7: Prefer HTML to Images

Do not render large chunks of text as images. If an image contains whole paragraphs of text, it should not be an image. Instead, it should be HTML.

The following is an example of a text-heavy image that should be HTML.

Note: The image would be shrunk to fit the screen and become unreadable, while an HTML version would be paginated.

Kindle Publishing Guidelines Amazon.com 23

Publishing on Kindle: Guidelines for Publishers

3.6.8 Image Guideline #8: Image Caption Placement

Amazon recommends placing a caption below the related image, so that the reader views the image before the caption. Define a line break between the image and the caption (for example, using a <br /> tag) to make sure the caption text is not positioned adjacent to the image.

3.6.9 Image Guideline #9: Controlling Image Aspect Ratio

To preserve aspect ratio of images, width and height cannot both be set to a fixed percentage. Either width or height can be set to the fixed percentage (such as 100%), but then the other property should be set to “auto” to preserve the aspect ratio.

3.6.10 Image Guideline #10: Displaying Text Correctly within SVG

To display text correctly within an SVG, use the font-size attribute for <text> inside the SVG.

Example

<html>

<body>

<svg xmlns="http://www.w3.org/2000/svg" version="1.1">

Kindle Publishing Guidelines Amazon.com 24

Publishing on Kindle: Guidelines for Publishers

<text x="20" y="20" font-size=20 fill="red">svg text sample</text>

</svg>

</body>

</html>

3.7 Table Guidelines

3.7.1 Table Guideline #1: Use Tables for Tabular Data Only

IMPORTANT: Use tables for tabular data only. Using tables for layout is not allowed in Kindle books. Do not use tables for dialogue, transcripts, chronologies, tables of contents, lists, sidebars, or any other formatting purposes.

3.7.2 Table Guideline #2: Avoid Large Tables

A table rendered as an image cannot be paginated because the entire image is displayed on one screen.

If the table is rendered using HTML <table> tags, pagination is available and users can cursor through the cells in the table. If the table is significantly wider than the screen and forces panning, it creates a poor user experience.

For the best user experience, tables should not contain whole paragraphs of text or large pictures in a cell.

If a table is too large or contains too much text in its cells, consider reformatting it in a way that maintains legible text. Single columns of HTML text provide the best reading experience for customers using a variety of font sizes.

In the example below, rotating the table to better fit the screen does not help. To preserve the format and layout of the data, it would be better to have the paragraph text as plain HTML and only the right-most column rendered as an image or HTML table.

Kindle Publishing Guidelines Amazon.com 25

Publishing on Kindle: Guidelines for Publishers

Large table rendered as an image: illegible text, unacceptable quality

The same content, reformatted as HTML and resulting in a legible, good-quality table

Vitamin C

Functions/Roles in Metabolism

Antioxidant; biosynthesis of connective tissue components (collagen, elastin, fibronectin, proteoglycans, bone matrix, and elastin–associated fibrillin); carnitine, and neurotransmitters

Deficiency Symptoms

Scurvy (involves deterioration of elastic tissue); follicular hyperkeratosis, petechiae, ecchymoses, coiled hairs, inflamed and bleeding gums, perifollicular hemorrhages, joint effusions, arthralgia, and impaired wound healing; dyspnea, edema, Sjögren syndrome, weakness, fatigue, depression

Toxicity Symptoms

Nausea, abdominal cramps, and diarrhea (from supplements)

3.7.3 Table Guideline #3: Create Simple HTML Tables

Use the <table> tags to create simple tables that have standard rows and columns. These tables display as tables on currently available Kindle devices and Kindle for iPhone. On Kindle 1, these tables are flattened (all of the content appears in one column). KF8 has support for nested tables and merged cells, but Amazon recommends that publishers use this judiciously and only when necessary.

Colspan

and rowspan attributes should be less than or equal to the total number of columns or rows (as appropriate) in the table.

3.7.4 Table Guideline #4: Split Tables as Needed

There are times when it may be necessary to format a table as an image, but the image is still too large to be legible on one Kindle screen. In this case, it is a good idea to split the image. The following example is a guideline to use when splitting a 2-page table. This logic can be extended for multiple-page table images.

Example: Split the image in half horizontally 60% of the way down the image, then split the header, copy it to the bottom half of the image, and stitch these into a new image. The final two images should then be the same size, with table headers.

Revise the source image, not the converted GIF; otherwise, the image will be converted into GIF format twice, which might result in lower quality.

Kindle Publishing Guidelines Amazon.com 26

Publishing on Kindle: Guidelines for Publishers

3.7.5 Table Guideline #5: Optimize for Maximum Table Size

Optimize tables to be no larger than 10 Kindle screens. A Kindle screen is approximately 24 rows of 60 characters, although the Kindle DX shows more characters. The character limit is the maximum number of characters in any one row. There are a limited number of combinations for a table that looks like this

(see below). If a table has more characters than the maximum number specified below (given the number

of rows), split the table into smaller tables or images, as described in section 3.7.4, Table Guideline #4:

Split Tables as Needed. In this case, characters are non-formatting characters (the actual text that a user

sees when looking at the contents of a table).

Number of Rows Maximum

Characters

(Per Row)

1 - 24 600

25 - 48

49 – 72

72 – 120

121 – 240

300

180

120

60

3.8 Adobe Digital Editions Compatibility Guidelines

3.8.1 Adobe Digital Editions Compatibility Guideline #1: Use Unique Item IDs

When using Adobe Digital Editions, make sure that the item IDs in the manifest are unique. Adobe Digital

Editions does not enforce uniqueness of IDs, which is incorrect according to the IDPF standard.

<manifest>

<item id="css1" href="core.css" media-type="text/css"/>

<item id="css2" href="template.css" media-type="text/css"/>

...

</manifest>

3.9 Styling Guidelines

3.9.1 Styling Guideline #1: Use a Nested HTML TOC

To create useful, navigable, deep TOC entries, Amazon recommends using the following syntax in the

HTML TOC. The examples below show two ways of writing the same sample code: style attributes and

CSS classes.

Using style attributes:

<div>Section 1</div>

<div style="margin-left:1em;">Chapter 1</div>

<div style="margin-left:1em;">Chapter 2</div>

<div style="margin-left:1em;">Chapter 3</div>

<div style="margin-left:2em;">Subchapter 1</div>

<div style="margin-left:2em;">Subchapter 2</div>

<div style="margin-left:1em;">Chapter 4</div>

<div style="margin-left:2em;">Subchapter 1</div>

<div>Section 2</div>

Using CSS classes:

<style> div.chapter { margin-left: 1em}

Kindle Publishing Guidelines Amazon.com 27

Publishing on Kindle: Guidelines for Publishers div.subchapter { margin-left: 2em}

</style>

<div>Section 1</div>

<div class="chapter">Chapter 1</div>

<div class="chapter">Chapter 2</div>

<div class="chapter">Chapter 3</div>

<div class="subchapter">Subchapter 1</div>

<div class="subchapter">Subchapter 2</div>

<div class="chapter">Chapter 4</div>

<div class="subchapter">Subchapter 1</div>

<div>Section 2</div>

3.9.2 Styling Guideline #2: Format Sidebars Correctly

When inserting sidebar content into the main flow of a book formatted for Kindle Format 8, use float via

CSS. However, if the book is formatted for Mobi 7, use the <hr/> HTML tags before and after the sidebar to differentiate it from the main body of text. Avoid using negative em values when specifying dimensions for a float element.

3.10 HTML Guidelines

3.10.1 HTML Guideline #1: Constructing Well-Formed HTML Documents (XHTML)

Kindle Format 8 supports most HTML 5.0 features, although the following HTML features are not fully supported: forms, frames, and JavaScript.

When creating source HTML or XHTML for the Kindle, refer to one of the following books as a primer on constructing well-formed HTML documents:

HTML, XHTML, and CSS by Elizabeth Castro (published by Peachpit Press): http://www.amazon.com/HTML-XHTML-and-CSS/dp/B000SEFC5Q

Beginning HTML with CSS and XHTML: Modern Guide and Reference by David Schultz and Craig Cook

(published by Apress): http://www.amazon.com/Beginning-HTML-CSS-XHTML-

Reference/dp/B001D25ZPE

Beginning Web Programming with HTML, XHTML, and CSS by John Duckett (published by Wrox): http://www.amazon.com/Beginning-Programming-HTML-XHTML-ebook/dp/B000VZQVVG

3.10.2 HTML Guideline #2: Anchors Must Be Added Before Formatting Tags

Correct:

<a name=”Chapter1”/><h1>Chapter 1</h1>

Incorrect:

<h1><a name=”Chapter1”/>Chapter 1</h1>

3.10.3 HTML Guideline #3: EPUB Guide Items Are Optional

Guide items are an optional feature in the EPUB format but are highly recommended. Kindle provides support for the cover, TOC, and text guide items. If you choose not to include guide items for the cover and TOC, these list items will still appear in the Kindle menus, but will be grayed out and not selectable.

3.10.4 HTML Guideline #4: Using Single Column Layout and Avoiding Absolute Positions

Create the content using single column layout and avoid using position:absolute for alignments.

3.10.5 HTML Guideline #5: Using position:absolute for Text on Image

For text on an image that needs to be positioned exactly, use the position:absolute attribute. Only use this attribute for books that need a fixed layout, such as children’s picture books with text specifically positioned in relation to background image elements.

Kindle Publishing Guidelines Amazon.com 28

Publishing on Kindle: Guidelines for Publishers

3.10.6 HTML Guideline #6: Avoid Using Negative Values

Avoid using negative values for positioning text and margins. Positioning with negative values without adding padding for compensation can cause content to display with the edge cut off. For example, if you want to use text-indent: -2em you also need to apply padding-left: 2em.

3.10.7 HTML Guideline #7: Avoid Using Scripting

Scripting is not supported. All scripts are stripped from the source during conversion. SVG with animation is not supported.

3.10.8 HTML Guideline #8: Avoid Using Negative Values for Line Height

Do not use negative values for the line-height attribute. They are not supported.

3.11 Embedded Font Guidelines

Kindle Format 8 supports embedded fonts within the eBook. These fonts can be either Open Type (OTF) or True Type (TTF). Kindle does not recommend the use of Type 1 (Postscript) fonts. To provide Kindle customers with the best possible reading experience, reflowable books that use Type 1 fonts are rendered using Kindle fonts by default. On KF8-enabled devices and apps, customers have the option to turn publisher-provided fonts on or off.

The font files within the book are intentionally obfuscated to reduce the probability of reuse, but it is the responsibility of the publisher to secure the appropriate license rights for fonts. Unless embedded fonts are necessary to convey intent, Amazon recommends using the default set of fonts installed on Kindle devices and apps because they have been tuned for high quality rendering.

Only embed fonts that are not currently available on devices and apps. Publishers do not need to include the Charis font with their Kindle books because it is an Open Font Licensed typeface. When selecting a font, consider usability for visually impaired readers and select a simple, clear font which will contrast well against all tablet and e Ink backgrounds.

4 Creating Fixed-Layout Children’s Books

Certain books have elements with fixed dimensions and orientation that do not allow fonts to be resized or text to be reflowed. For example, children’s books and graphic novels have full-page images with text set precisely in relation to the background art. To accommodate these media types, KF8 introduces new metadata fields and corresponding guidelines.

Fixed-layout books do not support reflowable text and should only be used when the entire book is a fixed-layout format; books cannot be partially reflowable or partially fixed-layout.

To demonstrate best practices in creating fixed-layout books, Amazon provides a children’s book example at www.amazon.com/kindleformat (under the KindleGen Examples heading). This example is a demonstration of how to create content to take advantage of fixed-layout with Region Magnification. It is not intended to be an HTML tutorial.

4.1 Metadata Fields Supporting Fixed-Layout Books

The OPF file specifies metadata necessary for fixed-layout books. For a demonstration, see the children’s book example at www.amazon.com/kindleformat (under the KindleGen Examples heading).

Metadata

Layout can be specified using one of the following metadata fields:

1) <meta property="rendition:layout">prepaginated</meta>

2) <meta name="fixed-layout" content="true"/>

Description

Required. Identifies the book as having a fixed layout.

Valid values for rendition:layout metadata are reflowable or prepaginated

. The default value is reflowable

.

Kindle Publishing Guidelines Amazon.com 29

Publishing on Kindle: Guidelines for Publishers

Metadata

<meta name="original-resolution" content="1024x600"/>

Description

Valid values for fixed-layout metadata are true or false. The default value is false

.

Required. Identifies the original design resolution of the content (“1024x600” is only an example). The pixel dimensions can have any positive integer value. These values must equal the overall aspect ratio of the original content.

Orientation can be specified using one of the following metadata fields:

1) <meta property="rendition:orientation">landscape</meta>

2) <meta name="orientation-lock" content="landscape"/>

Optional.

Valid values for rendition:layout metadata are portrait, landscape, or auto

. Locks the orientation of the book to either portrait or landscape. If the value is auto

, both portrait and landscape modes are supported. The default value is auto.

Valid values for orientation-lock metadata are portrait, landscape or none

. Locks the orientation of the content to either portrait or landscape. If the value is none, both portrait and landscape modes are supported. The default value is none

.

<meta name="RegionMagnification" content="true"/>

Optional. Enables Kindle Panel View and

Kindle Text Pop-Up. Valid values are true or false. The default value is false.

Enabling this feature requires additional

CSS instructions as specified in section

4.2.2.

<meta name="primary-writing-mode" content="horizontal-rl"/>

Optional. Defines page rendering order, reading mode, and reader navigation

(including Kindle Text Pop-Up, Kindle

Panel View, and Kindle Virtual Panels).

Valid values are horizontal-lr, horizontal-rl

, vertical-lr, and vertical-rl

. The default value is horizontal-lr

.

<meta name="book-type" content="children"/>

Optional for children’s books. Removes reader functionality (e.g., share) which may not be relevant for certain books such as children’s. Valid values are children or comic

.

Kindle Publishing Guidelines Amazon.com 30

Publishing on Kindle: Guidelines for Publishers

4.2 Content Requirements

4.2.1 Requirement #1: Using HTML File Structure

Fixed-layout content must have a single HTML file for each page represented on a Kindle device.

Publishers may use the OPF metadata to create double-page spread reading experiences.

Portrait orientation lock:

1 print page = 1 HTML file

Example:

Landscape orientation lock:

2 print pages (1 two-page spread) = 1 HTML file

Example:

4.2.2 Requirement #2: Using Region Magnification (Pop-ups)

Fixed-layout content does not allow the user to change the font size; allowing font sizes to change could obfuscate content relevant to storytelling. Kindle uses Region Magnification (pop-ups) to enlarge fixedlayout text without altering the original layout. For an example of Region Magnification, see the example below.

The user activates Region Magnification by double tapping an “active area” on touch screen devices. (On non-touch screen devices, clicking the up arrow on the 5-way controller selects the region and clicking the

Kindle Publishing Guidelines Amazon.com 31

Publishing on Kindle: Guidelines for Publishers center button activates Kindle Text Pop-Up or Kindle Panel View.) During Region Magnification, the active area (source element) is hidden and the magnification area (target element) is displayed.

To support Region Magnification, the following steps are required:

1. Set the active area by creating a well-defined HTML anchor (<a>)element around the text to be enlarged. The anchor must specify the app-amzn-magnify class. The anchor should also have the following attributes stored in a JSON object ( http://www.w3schools.com/json/json_syntax.asp

) as part of the data-app-amzn-magnify value: a. "targetId":"<string:elementId>" = unique element id of the magnification area

(position and font size are set in CSS file) b. "sourceId":"<string:elementId>" = unique element id of the source that will be magnified c. "ordinal":<integer:reading order>" = reading order of the magnification areas (the order in which panels appear as part of the reading flow). This is required for all text that uses

Region Magnification.

2. Create a target <div> element that is aligned to completely cover the text being magnified and positioned to minimize covering the background art of the page. This ensures that when a user activates Region Magnification, the source text will not disappear from the page view. When magnification is activated, the source text is no longer displayed. It is also important to not position a popup directly abutting the right or bottom edges of the screen. Differences between device types can create content overflow error if popups are too close to these edges. Check content on as many different kinds of devices as possible before publishing.

3. The font size of text in the Region Magnification <div> should be set to 150% of the regular font size on the page. There are several exceptions to this:

• One exception is when the text on the page is so large that magnifying it to 150% would make it harder to read instead of improving readability.

•

Another exception is when the text on the page needs to be increased by more than 150% to improve readability in the Region Magnification <div>. For example, if the font size of the text on the page is 45%, the font size of the text in the Region Magnification <div> may need to be magnified to 225% to be readable.

Fixed-layout sample page

Example:

Kindle Publishing Guidelines

Same sample page with Region Magnification activated

Amazon.com 32

Publishing on Kindle: Guidelines for Publishers

<div id="fs1-4-org" class="txt fs1-txt4">

<a class="app-amzn-magnify"

data-app-amzn-magnify='{"targetId":"fs1-txt4-magTarget", "sourceId":"fs1-4-txt",

"ordinal":4}'>

<p id="fs1-4-txt"><span class="dropcap">D</span>stands for DONKEY, - a poor patient beast<br/>Who thinks some fresh thistles a very great feast.</p></a></div>

…

<div id="fs1-txt4-magTarget" class="target-mag fs1-txt4"></div>

4.2.3 Requirement #3: Setting Images as Background Images

The images in fixed-layout books must be set as background images using the CSS backgroundimage

property (instead of using HTML <img> tags). This is important for children’s content and comic books because HTML images interfere with Region Magnification if they are not set as background images. If background images are correctly set, the images will not open in the image viewer when double tapped.

4.3 Content Recommendations

4.3.1 Recommendation #1: Applying CSS Reset

Apply a CSS reset to fixed-layout books. A CSS reset removes the inconsistent styles that browsers automatically apply, such as font sizes, margins, etc. Adding a CSS reset, such as the YUI reset

( http://yuilibrary.com/yui/docs/cssreset ), removes these inconsistencies, allowing designers to build on a dependable styling template.

4.3.2 Recommendation #2: Including One CSS File Per HTML Page

To increase page-turn performance on fixed-layout books, include one short, relevant CSS file per HTML page. CSS files should only contain information that is directly referenced by the associated HTML files.

4.3.3 Recommendation #3: Optimizing Content for Full Screen

Kindle books are read across a wide variety of devices (e.g., Kindle e Ink, Kindle Fire, and other manufacturers’ smartphones and tablets) and a wide variety of screen dimensions. The Kindle Fire has a resolution of 1024 x 600 pixels. Design the content to maintain this aspect ratio, if possible.

For the best user experience, Amazon strongly encourages publishers to design fixed-layout content to maximize the available space of the screen dimensions. If the content has a different aspect ratio or size, the Kindle devices and apps display it scaled to fit the screen, centered, and surrounded by a white margin (letterbox).

Fixed-layout and other image-heavy content is more likely to be magnified because customers prefer to read with Kindle Panel View or on devices with large screens. Amazon recommends submitting images scaled to support at least 2X magnification with high quality. For example, if planning for Kindle Fire, the image pixel dimensions should be at least 2048 x 1200 (this matches the aspect ratio and would support

2X zoom). Always use Kindle Previewer to validate the quality of the content.

4.3.4 Recommendation #4: Using Large Region Magnification Tap Targets in Children’s Books

The primary purpose of Region Magnification is to aid accessibility and is more effective when the tap target is larger than the area being magnified. To enable a larger area, consider adding a padding of 20 to

40 pixels to the app-amzn-magnify anchor elements, but do not let the tap targets overlap.

Kindle Publishing Guidelines Amazon.com 33

Publishing on Kindle: Guidelines for Publishers

4.3.5 Recommendation #5: Future-Proofing Fixed-Layout Content in Children’s Books

By definition, fixed-layout is designed for a single screen size. To future-proof your content, Amazon recommends using percentage or em values instead of pixels or points for all positioning of text blocks and Region Magnification pop-ups. Specifying text position or font size with pixels prevents the content from scaling to new devices.

For example, the children’s book example at www.amazon.com/kindleformat (under the KindleGen

Examples heading) includes a sample style sheet (style-150.css) that demonstrates the minimal set of changes required to scale to a device that is 150% larger. These changes are limited to a base font-size and changes in the container height and widths (approximately 5 updates).

4.3.6 Recommendation #6: Including Specific Fonts

Fixed-format titles do not allow users to choose and vary fonts. Using CSS @font-face and packaging fonts with the title guarantees book design look-and-feel to be consistent across all devices and screens.

This not only ensures that the exact fonts used for the source are used in the fixed-format title, but that

HTML text has more fluid rendering between the page view and the Region Magnification view.

Example:

@font-face { font-family:

"Arial"; /* assigns the name of the font to use */ src: url(../fonts/arial.otf); /* includes the file for the correct font

*/

}

4.3.7 Recommendation #7: Including HTML Front Cover

Include an HTML front cover page with the cover image set as a background image. This will act as the beginning of the book. This HTML page must be the first page listed in the <spine> in the OPF file, with

the linear attribute assigned to yes. See sections 3.2.2 and 3.2.3 for other guidelines surrounding

cover images.

4.3.8 Recommendation #8: Including Back Cover

While Kindle ebooks in previous formats and reflowable text do not use back covers, it provides a sense of closure to the narrative for children’s content. It is best to include a back cover as part of the fixedformat children’s book design. Remove barcodes, price listings, and promotional content from the back cover image. Do not include popups for any text on the back cover unless the back cover includes story text.

4.4 Creating Children’s Books with Multipage Background Images and Text

This section explains the proper way to create pages that contain a single background image and text.

While there are many potential solutions, Amazon’s goal is to ensure that markup is easily portable with minimal effort. The provided template meets this goal by updating the CSS rules without changing the

HTML.

4.4.1 Using Side-by-Side Images to Form a Double-Page Spread When Orientation-Lock Is Set to

Landscape

Many books have two-page spread that consists of a single image. Other books have a two-page spread that consists of two side-by-side images.

In the example below, the double-page spread is 1024 x 600 pixels, which is full-screen resolution for the

Kindle Fire. The images for each page should have dimensions exactly half the width of the full screen:

512 x 600 pixels. The unique parts of each element are labeled using CSS IDs; the common parts use

CSS classes. The left image displays on the left side of the spread. The right image is shifted to the right side of the page by defining a margin-left style set to the width of the left side image.

Kindle Publishing Guidelines Amazon.com 34

Publishing on Kindle: Guidelines for Publishers

HTML

<div class="fs">

<div id="fs1-left" class="leftPage"></div>

<div id="fs1-right" class="rightPage"></div>

</div>

CSS

/* Region sized for both pages */ div.fs {

height: 600px;

width: 1024px; /* 2 x page width */

position: relative;

} div.leftPage {

position: absolute;

background-repeat: no-repeat;

height: 600px;

width: 512px; /* 1 x screen width */

} div.rightPage {

position: absolute;

Kindle Publishing Guidelines Amazon.com 35

Publishing on Kindle: Guidelines for Publishers

background-repeat: no-repeat;

height: 600px;

width: 512px; /* 1 x screen width /

margin-left: 512px; /* this value equals the value of the left side image width */

}

4.4.2 Positioning Text Blocks

Specify the proper position and font size using percentages. This allows the position to scale consistently at different resolutions, ensuring compatibility across a wider range of devices and screens. Each paragraph should be grouped within a single <div> element, with multiple lines broken by <br/> elements. If custom line spacing is required, assign this via CSS style declarations instead of adding extra markup such as multiple <div> containers or extra line break tags.

The example in section 4.2.2, Requirement #2: Using Region Magnification (Pop-ups), expands on the

two-page spread example and illustrates how to place text on top of a background image: text is positioned within a fixed spread block, uses percentages for the margin attribute, and is aligned and spaced via CSS.

4.4.3 Aligning Text

By default, text aligns to the upper left corner of the containing HTML element. Many books may have text that is right-aligned, bottom-aligned, or justified. The easiest way to identify the alignment is to imagine an outline around the text and identify which edges of the paragraph are associated with a margin (top, left, right, bottom). If the alignment is unclear, use the default upper left, although this makes positioning of the magnified element more difficult.

Never use non-breaking space (&nbsp;) characters for text alignment. Instead, use CSS top, right, bottom and left to position <div> elements that contain absolutely positioned text. Use two adjacent sides to position each <div> element. For example, top and left but never top, left, and bottom. CSS text-indent

and line-height are useful in aligning text within HTML block elements.

5 Creating Fixed-Layout Graphic Novels/Manga/Comics

Graphic novels, manga, and comics (hereafter referred to as graphic novels) are similar to children’s books, but present a unique challenge because they tend to be longer and have more complex content.

Graphic novels include a large amount of detail in images that displays on a 1024 x 600 screen. To overcome this and other accessibility concerns, Amazon encourages the use of customized content and our Kindle Panel View feature, which optimizes the content for a high-resolution reading experience.

When designing for graphic novels, the following generic fixed-layout requirements also apply:

5.1 Metadata Fields Supporting Fixed-Layout Books

The OPF file specifies metadata necessary for fixed-layout books. For a demonstration, see the Graphic

Novel example at www.amazon.com/kindleformat (under the KindleGen Examples heading).

Metadata

Layout can be specified using one of the following metadata fields:

1) <meta property="rendition:layout">prepaginated</meta>

2) <meta name="fixed-layout" content="true"/>

Description

Required. Identifies the book as having a fixed layout.

Valid values for rendition:layout metadata are reflowable or prepaginated

. The default value is reflowable

.

Valid values for fixed-layout metadata

Kindle Publishing Guidelines Amazon.com 36

Publishing on Kindle: Guidelines for Publishers

Metadata Description are true or false. The default value is false

.

<meta name="original-resolution" content="1024x600"/>

Required. Identifies the original design resolution of the content (“1024x600” is only an example). The pixel dimensions can have any positive integer value. These values must equal the overall aspect ratio of the original content.

Orientation can be specified using one of the following metadata fields:

Optional.

1) <meta property="rendition:orientation">landscape</meta>

2) <meta name="orientation-lock" content="landscape"/>

Valid values for rendition:orientation

metadata are portrait, landscape, or auto.

Locks the orientation of the book to either portrait or landscape. If the value is auto, both portrait and landscape modes are supported. The default value is auto.

Valid values for orientation-lock metadata are portrait, landscape or none

. Locks the orientation of the content to either portrait or landscape. If the value is none, both portrait and landscape modes are supported. The default value is none

.

<meta name="RegionMagnification" content="true"/>

Optional. Enables Kindle Panel View and

Kindle Text Pop-Up. Valid values are true or false. The default value is false.

Enabling this feature requires additional

CSS instructions as specified in section

5.4.

<meta name="primary-writing-mode" content="horizontal-rl"/>

Required for Virtual Panels in Manga with right-to-left reading order; optional for other fixed-layout books. Defines page rendering order, reading mode, and reader navigation

(including Kindle Text Pop-Up, Kindle

Panel View, and Kindle Virtual Panels).

Valid values are horizontal-lr, horizontal-rl

, vertical-lr, and vertical-rl

. The default value is horizontal-lr

.

<itemref idref="page-id" properties="page-spreadleft"/>

Required for Virtual Panels in Comics and

Manga; optional for other fixed-layout books. Allows publishers to specify page layouts (double-pages, facing pages) at the page level and can vary throughout the book. The page properties should be specified in the itemref elements (child of <spine> element in the OPF file).

Valid values are page-spread-left,

Kindle Publishing Guidelines Amazon.com 37

Publishing on Kindle: Guidelines for Publishers

Metadata

<meta name="book-type" content="comic"/>

Description page-spread-right

, facing-pageleft

, facing-page-right, and layout-blank

. The value layoutblank

can be used independently or in conjunction with other valid values. Default value is layout-blank.

Required for all graphic-novels; optional for other fixed-layout books. Removes reader functionality (e.g., share) which may not be relevant for certain books such as children’s. Valid values are children or comic

.

5.2 Asset Requirements

When optimized for the Kindle Fire, graphic novels should maintain a 1024 x 600 aspect ratio. The image resolution will differ depending on the zoom factor required for Kindle Panel View. However, Amazon recommends planning for a high quality reading experience at 2X magnification. Images must be in the

JPEG format and must be smaller than 800 KB in size. Image files larger than 800 KB greatly increase download time for the book and require more space on the device. Amazon recommends using an image resolution of 300 dpi or 300 ppi.

There are four standard zoom factors:

Zoom

Factor

When to Use

100%

125%

150%

250%

Avoid using this zoom factor. It offers no magnification and poses an accessibility challenge for users.

Only use this zoom factor when it is absolutely necessary to enlarge a very large panel. This allows the user to see a large action scene, but with the downside of limited enlargement.

This is the default and preferred zoom factor. Use this zoom factor whenever possible.

Only use this zoom factor on a two page spread image (two physical pages are displayed at once, and content appears especially small as a result). The downside is that the enlarged panel only represents a small portion of the original page.

Required

Image

Resolution

1024 x 600 pixels

1280 x 750 pixels

1536 x 900 pixels

1560 x 1500 pixels

5.3 Image Quality

Image quality for graphic novels requires that images follow the resolution standards listed in section 5.2,

Asset Requirements, and maintain a consistent aspect ratio. Most importantly, optimize images for clarity

of background art as well as readability of text. These two factors guarantee the highest quality for the graphic novel format.

5.4 Panel View (Region Magnification)

Panel View for graphic novels offers a unique reading experience. It addresses accessibility and lets users experience the flow of action on each page in a high-resolution, easy-to-use manner. Users can dismiss Panel View at any time to view the entire page. For an example of Panel View, see the following images.

Kindle Publishing Guidelines Amazon.com 38

Publishing on Kindle: Guidelines for Publishers

The user activates Panel View by double tapping a “tap target”. The active area (source element) is hidden and the Panel View (target element) is displayed.

To support Panel View, the following steps are required:

1. Set the tap target by creating a well-defined container (<div>) element that contains an anchor

(<a>) element. The <div> provides the size and position of the tap target. The <a> is sized to fill the <div> and must specify the app-amzn-magnify class. The anchor should also have the following attributes stored in a JSON object as part of the data-app-amzn-magnify value: a. "targetId":"<string:elementId>" = unique element id of the Panel View HTML element that represents the enlarged region b. "ordinal":<integer:reading order>" = reading order of the magnification areas (the order in which panels appear as part of the reading flow)

2. Create a target view panel <div> element that is sized and positioned to display the action that best reflects the tap target.

Snapshot of fixed layout content Snapshot of the same content with Panel View activated

Example:

<div>

<img src="images/hij.jpg" alt="Comic Book Images" class="singlePage" />

</div>

<div id="pagehij-1">

<a class="app-amzn-magnify" data-app-amzn-magnify='{"targetId":"pagehij-1magTargetParent", "ordinal":1}'></a>

</div>

…

Kindle Publishing Guidelines Amazon.com 39

Publishing on Kindle: Guidelines for Publishers

<div id="pagehij-1-magTargetParent" class="target-mag-parent">

<div class="target-mag-lb">

</div>

<div id="pagehij-1-magTarget" class="target-mag">

<img src="images/hij.jpg" alt="Comic Book Images"/>

</div>

</div>

5.5 Optimizing Content for the Graphic Novel Experience

5.5.1 Optimizing Tap Targets

Tap targets should effectively cover 100% of the screen. This ensures that the user gets a magnified experience whenever the user double taps the graphic novel.

5.5.2 Optimizing View Panels

View panels should be 150% of the tap target by default. It is acceptable to use different size view panels to emphasize a specific action scene within the tap target.

Position view panels so that they convey where the primary action scene occurred on the original page.

Typically, view panels are horizontally aligned to the left, center, or right edges and are vertically aligned to the top, center, or bottom edges.

When preserving context across multiple panels, it is acceptable to overlap slightly with other view panels.

5.5.3 Optimizing for Wide or Tall Action Scenes

To use the default 150% default zoom factor, an action scene often needs to be divided into two view panels (typically a left and right or top and bottom). This is a better user experience than using a smaller zoom factor, because it preserves accessibility and gives the user a higher resolution reading experience.

Split the tap targets so that the first tap target is between 50 and 75% the width of the entire area, and the second tap target is the remaining amount necessary to reach 100%. This ensures when a user double

Kindle Publishing Guidelines Amazon.com 40

Publishing on Kindle: Guidelines for Publishers taps an area near the middle of the action panel, they experience the first view panel first, and then the second view panel when they move forward.

To preserve the flow of the action, view panels should display a small amount of overlapped action.

First view panel of an action scene divided into two view panels

Second view panel of an action scene divided into two view panels

5.5.4 Optimizing for Large Text Blocks

To display large amounts of text, Amazon suggests a hybrid text treatment that mixes the experiences of the graphic novels and children’s books. Amazon recommends limiting the use of the hybrid text treatment to sections of text that are too wide to be magnified effectively. The hybrid text treatment should mimic the formatting of the text it represents in line-height, italic and/or boldface, and general appearance. This provides a better user experience.

Kindle Publishing Guidelines Amazon.com 41

Publishing on Kindle: Guidelines for Publishers

Hybrid Text HTML Example:

<div id="pageXXX-magTargetParent" class="target-mag-parent">

<div class="target-mag-lb"></div>

<div id="pageXXX-magTarget" class="target-mag">

<div class="text">

<p>WALTER CRANE'S <br />PICTURE BOOKS <br /></p>

<p> Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. </p>

</div>

</div>

</div>

Hybrid Text CSS Example:

div.target-mag div.text{

height: 100%;

padding: 5px;

background-color: #FFFFEF;

font-size: 150%;

font-family: "Georgia";

Kindle Publishing Guidelines Amazon.com 42

Publishing on Kindle: Guidelines for Publishers

}

5.6 Virtual Panels in Comics and Manga

The Virtual Panels feature is activated for comics and manga books in the absence of publisher-provided panels. The RegionMagnification metadata is used to identify whether the publisher has provided panel information. If the publisher has designed the content with panels, the Kindle Virtual Panel view is not enabled.

By default, every page is divided into four panels based on the primary-writing-mode value. The examples below indicate the order of the panels.

Example:

Portrait mode:

Horizontal-lr Horizontal-rl

Vertical-rl Vertical-lr

Kindle Publishing Guidelines Amazon.com 43

Landscape mode:

Publishing on Kindle: Guidelines for Publishers

Vertical-lr and Horizontal-lr

Horizontal-rl and Vertical-rl

5.6.1 Requirement #1: Pairing Pages When Orientation-Lock Equals None

If orientation is not locked, content should be designed for both portrait and landscape mode. Also, every page is expected to have a defined definitive pair to support landscape orientation. In portrait orientation, the pairs are ignored.

All single pages should be tagged with the properties facing-page-left or facing-page-right. In this case, the renderer will add the spine while stitching two pages together.

Example:

The following example shows a double-page spread with visual separator in landscape mode.

<spine>

<itemref idref="page1" properties="facing-page-left"/>

<itemref idref="page2" properties="facing-page-right"/>

</spine>

Kindle Publishing Guidelines Amazon.com 44

Publishing on Kindle: Guidelines for Publishers

Double-page spreads should be tagged with the properties page-spread-left or page-spreadright

. Every left page should have a right page associated and vice-versa. In this case, the renderer will not add the spine while stitching two pages together.

Example:

The following example shows a double-page spread without visual separator in landscape mode.

<spine>

<itemref idref="page1" properties="page-spread-left"/>

<itemref idref="page2" properties="page-spread-right"/>

</spine>

Kindle Publishing Guidelines Amazon.com 45

Publishing on Kindle: Guidelines for Publishers

In portrait mode, the two pages will be rendered separately as shown below:

If none of the properties are specified, Kindle assumes facing-page-left and facing-page-right for alternate pages based on the book’s writing mode.

The following example assumes primary-writing-mode equals horizontal-lr or vertical-lr.

Example:

<spine>

Kindle Publishing Guidelines Amazon.com 46

Publishing on Kindle: Guidelines for Publishers

-->

<itemref idref=

"page1" /> <!—assumed to be properties="facing-page-left"

-->

<itemref idref=

"page2" /> <!—assumed to be properties="facing-page-right"

<itemref idref=

"page3" properties="page-spread-left"/> <!—double page spread’s left viewport -->

<itemref idref=

"page4" properties="page-spread-right"/> <!—double page spread’s right viewport -->

</spine>

The following example assumes primary-writing-mode equals horizontal-rl or vertical-rl.

Example:

<spine>

-->

<itemref idref=

"page1" /> <!—assumed to be properties="facing-page-right"

-->

<itemref idref=

"page2" /> <!—assumed to be properties="facing-page-left"

<itemref idref=

"page3" properties="page-spread-right"/> <!—double page spread’s right viewport -->

<itemref idref=

"page4" properties="page-spread-left"/> <!—double page spread’s left viewport -->

</spine>

In cases where a left page does not have an equivalent right page (or vice-versa), the publisher should insert a blank HTML page and add the property layout-blank to the page, unless it is the last page.

Optionally, the blank page can include the book title and watermark by design.

Pages with the layout-blank property are only rendered in landscape mode and are ignored in portrait mode.

In some cases, the publisher may wish to insert a blank page that always renders in both portrait and landscape modes. In this instance, do not use the layout-blank property. Use the same facing (or double-page spread) rules as noted above and reference an image file that contains a “blank” jpeg.

The following example assumes primary-writing-mode equals horizontal-lr or vertical-lr.

Example:

<spine>

-->

<itemref idref=

"page1" /> <!—assumed to be properties="facing-page-left"

<itemref idref=

"blank-page" properties="layout-blank"/> <!—assumed to be properties=

"facing-page-right". Ignored in portrait mode. -->

<itemref idref=

"page2" properties="page-spread-left"/> <!—double page spread’s left viewport -->

<itemref idref=

"page3" properties="page-spread-right"/> <!—double page spread’s right viewport -->

</spine>

Kindle Publishing Guidelines Amazon.com 47

Publishing on Kindle: Guidelines for Publishers

6 Audio and Video Guidelines

Currently, Kindle Edition with Audio/Video content is available on Kindle Fire (2nd generation), Kindle Fire

HD, iPad, iPhone, and iPod Touch. Kindle e Ink devices do not support Kindle Editions with Audio/Video.

To add audio and/or video content to your Kindle book, follow the guidelines and examples below.

KF8 features are not currently supported in Kindle Edition with Audio/Video content. The file delivered to

Amazon should be a Mobi 7 EPUB with self-contained audio and video or a Mobi 7 .prc file with selfcontained audio and video. (If delivering a .prc, make sure the file was created using the latest version of

KindleGen available from www.amazon.com/kindleformat ).

6.1 Embedded Video

To embed a video inside a Kindle book, add a standard HTML 5 tag such as the following:

Example:

<video id="video_1" src="movie.mp4" controls poster="start.jpg" title="Video about

...">

<br/><br/><br/> "There is video content at this location that is not currently supported for your device. The caption for this content is displayed below."

<br/><br/><br/>

</video>

• src tag: (Required) Identifies the embedded video file.

• title tag: (Required) Identifies the description of the video.

• poster tag: (Required) Identifies the placeholder image file. Users see the placeholder in the eBook before the video is played. The placeholder could be the first frame of the video or a representative frame, depending on your preference. (If this file is not specified, a blank black image is displayed.)

• controls tag: (Required, unless you provide an image for use in starting the video playback)

Tells the Kindle application to display controls for the embedded video.

Note: The Kindle application may render a play button on top of the poster frame. It appears in the middle of the frame.

• text content: (Required) Devices that do not support video content display the text between the

<video>

and </video> tags. If users view this eBook on a device that does not support video, they see this text instead. (Example: “There is content at this location that is not currently supported for your device. The caption for this content is displayed below.”)

• id tag: (Optional) Must be unique to the document if it is used.

6.2 Streaming Video

Streaming video is not supported at this time. Use embedded video instead.

6.3 Embedded Audio

To embed an audio file inside a Kindle book, add a standard HTML 5 tag such as the following:

Example:

<audio id=”audio_1” src="audio.mp3" controls title=”Audio about ...">

<br/><br/><br/>

“There is audio content at this location that is not currently supported for your device. The caption for this content is displayed below.”

<br/><br/><br/>

Kindle Publishing Guidelines Amazon.com 48

Publishing on Kindle: Guidelines for Publishers

</audio>

• src tag: (Required) Identifies the embedded audio file, which must be in MP3 format.

• title tag: (Optional) Identifies the description of the audio.

• controls tag: (Required, unless you provide an image for use in starting the video playback)

Tells the Kindle application to display controls for the embedded audio.

• text content: (Required) Devices that do not support audio content display the text between the

<audio>

and </audio> tags. If users view this eBook on a device that does not support audio, they see this text instead. (Example: “There is content at this location that is not currently supported for your device. The caption for this content is displayed below.”)

• id tag: (Optional) Must be unique to the document if it is used.

6.4 Streaming Audio

Streaming audio is not supported at this time. Use embedded audio instead.

6.5 Multimedia Directory

When adding audio and video files to an eBook, create an “audiovideo” directory for storing these files.

When referring to the audio or video file, include the directory name (Example: “audiovideo/filename”) in the HTML.

6.6 Audio Guidelines

Amazon recommends using stereo channels in the MP3 source where possible, because Kindle supports playing back audio in stereo. Use as high a bitrate as you need to hear the audio content appropriately; this is a judgment call. For good results, consider bitrates between 128 kbps and 256 kbps (kilobits per second). The maximum supported by Kindle is 320 kbps at variable bit rate.

6.7 Video Guidelines

Since audio content can be part of the video content, Amazon recommends using stereo channels in your audio source where possible. Kindle supports playing back audio in stereo.

This is the ideal source spec:

Attribute Setting

Dimensions

Widescreen: 704 x 396 (or any other widescreen ratio); Fullscreen: 640 x 480

Interlacing

Color Space

Video Codec

Video Mode

Progressive

4:2:0 YUV

H.264 (recommended), MPEG-2

VBR (recommended) or CBR

Video Bit Rate 2500 kbps or higher recommended

Key Frame Interval 2 or 4 seconds recommended

Audio Codec

Audio Bit Rate

MP3

256 kbps or higher recommended

Audio Sample Rate 48 kHz (recommended), 44.1 kHz

The following container formats are acceptable:

Container File Extensions Mime Type RFC

Kindle Publishing Guidelines Amazon.com 49

Publishing on Kindle: Guidelines for Publishers

Container

MP4

File Extensions

.mp4

MPEG-2 video file .mpg, .mpeg

Mime Type video/h264 video/mpeg

RFC

RFC3984

RFC2045,

RFC2046

RFC3555 MPEG-2 program stream

MPEG-2 transport stream

.ps

.ts video/mp2p video/mp2t RFC3555

Will not work: any other video codec (such as Windows Media, Apple ProRes), AC3 audio, audio >2 channels

6.8 Audio and Video Metadata

Amazon requires that publishers (or their conversion houses) provide a description of the audio and video file, and the duration of the file in minutes and seconds, in the HTML immediately after the audio and video file is specified.

Example:

<p align=”center” style=”text-indent:0px”>

<video id=”video_1” src="movie.mp4" controls poster=”start.jpg” title=”How to create

Kindle content (5:01)”>

<br/><br/><br/>

“There is video content at this location that is not currently supported for your device. The caption for this content is displayed below.”

<br/><br/><br/>

</video>

<strong>How to create Kindle content (5:01)</strong>

</p>

6.9 NCX File

When creating eBooks with audio and video content, Amazon requires the creation of an NCX file that points to the audio and video assets. This file should list all video and audio files in reading order, with links to where they occur in the book. For descriptions of the audio and video files, reuse the same audio

and video metadata. (Example: A link to the video clip in section 6.8 would say “How to create Kindle

content (5:01)”.) This information should be embedded in the NavList portion of the NCX file.

6.10 Images with Play Controls

It is possible to tag images so that they can be played by clicking on them. The minimum pixel width and height for such images is 45 pixels by 45 pixels.

To add play controls to the image, superimpose the Amazon PLAY icon onto the lower right-hand side of any image via Photoshop or similar program. Then add the following tag to the HTML (in this example, the audio file has an id attribute of “audio1” and no controls tag):

Example:

<a onclick=”play(this);” data-AmznAudioTag=”audio1”><img src=”play.jpg”/></a>

However, if you are using KindleGen version 1.2 or earlier, use the following HTML instead:

Example:

<a onclick=”document.getElementById(‘audio1’).play()”><img src=”play.jpg”/></a>

Kindle Publishing Guidelines Amazon.com 50

Publishing on Kindle: Guidelines for Publishers

The Amazon PLAY icon is available upon request.

6.11 File Names Are Case-Sensitive

Kindle books are case-sensitive. When referencing audio and video files within the HTML, be careful about case sensitivity. (Example: “audiovideo/ThisFile.mp4” is different from “audiovideo/Thisfile.mp4”.)

To indicate a file in a directory, use “/” characters and not “\” characters. (Example:

“multimedia/ThisFile.mp4” is valid, but “multimedia\ThisFile.mp4” is not.)

6.12 Confirm Correct Mime-Type

When specifying video and audio files in the OPF, make sure that they have the correct mime-types, depending on the extensions used. (Example: MP4 video files should have a mime-type of “video/mp4” and not “audio/mpeg”.)

6.13 File Size

Limit the combined file sizes of all audio and video files to 600 MB or less for each title. If the files are larger than 600 MB, manually transcode them to reduce the file size(s). (The total maximum audio/video file size that can be converted from EPUB via KindleGen is 650 MB.)

Limit the number of individual audio and video files within each title to 1,000 or fewer.

6.14 Narration

Amazon does not currently accept any audio or video books with read-along content, which is defined as someone reading the full text or multiple pages of text from the book in either audio or video format.

6.15 Table of Contents

All books must have a TOC that begins with "List of Audio and Video." This line should be bold. On the next line, begin an indented list of hyperlinks to each audio and video file. The text of the link should include the file description, with the file duration in parentheses.

Use these guidelines for all audio and video files longer than 10 seconds that a user might want to see listed.

Here is an example of how the code below would display in the TOC:

List of Audio and Video

This is my video (5:01)

This is my audio (1:10)

This is the corresponding code for the example above:

<video id="video_1" src=" audiovideo//movie.mp4" controls poster="start.jpg" title="This is my video (5:01)">

<br/><br/><br/>”There is video content at this location that is not currently supported for your device. The caption for this content is displayed below.”<br/><br/><br/>

</video>

<br>This is my video (5:01)</br>

<audio id="audio_1" src=" audiovideo//audio.mp3" controls title="This is my audio

(1:10)">

<br/><br/><br/>

”There is audio content at this location that is not currently supported for your device. The caption for this content is displayed below.”

<br/><br/><br/>

Kindle Publishing Guidelines Amazon.com 51

Publishing on Kindle: Guidelines for Publishers

</audio>

<strong>This is my audio (1:10)</strong>

6.16 Guidance on Media Captions

Media captions describe the audio and video files to the user. Here are some general guidelines:

• Captions should not be generic. They should describe the media content they are referencing.

These media captions are not a good user experience:

1. Media 1

2. Track 1

3. Audio 1

4. Video 1

These media captions describe the content:

1. Introduction by the Author

2. The Making of the Movie

• Media captions cannot include file extensions (.mp3, .mp4, etc.).

6.17 Custom Sample File

Amazon requires that publishers create and supply a custom sample for each Kindle Edition with

Audio/Video. The sample file should include a full TOC and an audio/video list, with live links to only the content in the sample file.

The sample file should include at least one of each type of media available in the full file, including both audio and video, if applicable.

The sample file must have a “Buy It Now” link added to the end, or where appropriate.

7 Dictionary Overview

A dictionary is a Kindle eBook (.mobi file) with extra tags for dictionary functionality. Dictionary eBooks:

• Contain a primary index: a list of words or sentences that are sorted in alphabetical order.

Readers can quickly search in this list by typing the beginning of the word and selecting the entry they want.

• Are marked as being a dictionary. This tells the Kindle to use this book for the lookup feature on

Kindle e Ink devices. The input and output languages of the dictionary must be properly defined.

For example, an English (monolingual) dictionary lists English as both the input and output language. A French-English dictionary lists French as the input language and English as the output language.

Note: If you want to build a bidirectional bilingual dictionary (example: Spanish-French and French-

Spanish), you must create two separate eBooks: one for Spanish-French and one for French-Spanish.

A Kindle dictionary should have all the same components as a normal Kindle eBook. There should be an

OPF file and HTML files with CSS. Specifically, a dictionary should have:

• A cover image

• A copyright page

• Any relevant front or back matter (explanations of symbols, appendices, etc.)

• Definitions of words (this is the bulk of the file)

Kindle Publishing Guidelines Amazon.com 52

Publishing on Kindle: Guidelines for Publishers

7.1 Metadata: Creating the OPF File

The OPF file of a dictionary is similar to other Kindle books, but it also contains specialized metadata tags in the <x-metadata> section.

The OPF file of a dictionary sets the source language and the target language. If the dictionary has multiple indexes, the OPF file specifies the name of the primary lookup index.

•

•

•

<DefaultLookupIndex>

= Forces the default lookup index, i.e., the index that is opened when the eBook is used as a lookup dictionary from another eBook.

<DictionaryInLanguage>

= The language of the book this dictionary is designed to be used on. If you are creating a Spanish- French dictionary, the input language is Spanish.

<DictionaryOutLanguage>

= The language of the definitions. If you are creating a Spanish-

French dictionary, the output language is French.

Example:

<x-metadata>

<DictionaryInLanguage>en-us</DictionaryInLanguage>

<DictionaryOutLanguage>en-us</DictionaryOutLanguage>

<DefaultLookupIndex>Index Name goes here</DefaultLookupIndex>

...

</x-metadata>

7.2 Basic Dictionary HTML

In order to make an alphabetical index, you have to use special tags that are not standard HTML to tell the Kindle to index certain words.

The

<idx:entry>

tag is used to mark the scope of an entry in the index. In a dictionary, all definitions should be between

<idx:entry>

and

</idx:entry>

. You can put any type of HTML within this tag.

When there is more than one index in the eBook, use the name attribute to identify an index.

Example:

<idx:entry name="xxx">

The

<idx:orth>...</idx:orth>

tag is used to delimit the label that will appear in the index list. This is the text that users can enter in the search box to find an entry. For a dictionary, this is typically the headword. Use the value attribute to include a hidden label in the entry.

Example:

<idx:orth value="Label of entry in Index"/>

Here is an example of an extremely simple entry that could be part of an English dictionary. In this example, the word "chair" appears in the index list and can be searched by users.

Example:

<idx:entry>

<idx:orth>chair</idx:orth>

A seat for one person, which has a back, usually four legs, and sometimes two arms.

<idx:entry>

7.3 Inflections for Dictionaries

When building dictionaries, you may have multiple inflected forms of a single root word that should access the same entry. However, adding all of these inflected forms under the orthography

(pronunciation) of a single entry leads to the generation of a large index, which negatively affects performance and user experience. Kindle has a disinflection engine that uses a set of rules for disinflecting any given word to its headword. The index then has only the headword to look up.

Kindle Publishing Guidelines Amazon.com 53

Publishing on Kindle: Guidelines for Publishers

To generate the set of disinflection rules for the dictionary, the input must include some information about the inflections. There are two ways to provide this information: simplified inflection syntax and advanced inflection syntax.

7.3.1 Advanced inflection syntax

Inflections are handled by the inflection index, which is built into the dictionary based on the inflected forms which are tagged in the content using the

<idx:infl>

tag. Inflections are attached to the orthography of the entry. They must be specified inside of an

<idx:orth>

tag. If an entry has multiple orthographies, each must have its own inflections.

Example:

<idx:orth>record

<idx:infl inflgrp="noun">

<idx:iform name="plural" value="records" />

</idx:infl>

<idx:infl inflgrp="verb">

<idx:iform name="present participle" value="recording" />

<idx:iform name="past participle" value="recorded" />

<idx:iform name="present 3ps" value="records" />

</idx:infl>

</idx:orth>

The inflgrp

and name

attributes are optional. The idx:infl

, idx:iform

, and value

attributes are mandatory.

7.3.2 Simplified inflection syntax

For English dictionaries, simplified inflection syntax is a very simple way of giving information about the inflections. Previous versions of the file format supported using the infl

attribute in either the

<idx:orth>

or the

<idx:gramgrp>

tag and specifying a comma-separated list of inflected forms. This syntax is now deprecated, as it is not as accurate when disinflecting, particularly for non-English languages.

7.4 Building a Dictionary with Kindlegen

When building a dictionary with Kindlegen via the command line, use the following syntax: kindlegen.exe [filename.opf] -c2 -verbose

7.5 Testing Kindle Dictionaries

7.5.1 Format Testing

This component of dictionary testing ensures that the dictionary is formatted well and provides a good visual experience.

Check the formatting of the definitions by paging through the dictionary and reading several definitions.

This can be done on the Kindle Previewer or on any device. Amazon recommends:

• Horizontal rules between each definition.

• Check words for unsupported characters, broken or joined words, proper display of accented characters, symbols, pronunciation guide, etc.

• Start each new alphabet/letter section on a new page.

• The headword (word being defined) should come first, and be distinguished somehow (on its own line, in bold, etc.)

• Check that there are no typos.

• Check that links (if present) are working correctly.

• Check that images (if present) are clear and readable.

• Avoid using tables unless absolutely necessary.

Kindle Publishing Guidelines Amazon.com 54

Publishing on Kindle: Guidelines for Publishers

Check the code in the .epub file. This can be done in any text editor.

• Check metadata within the file. It is especially important to have the language tags correct so the dictionary can be used as default to return definitions on books of the specified language. The tags to check are below (Note: en-us is American English).

<x-metadata>

<DictionaryInLanguage>en-us</DictionaryInLanguage>

<DictionaryOutLanguage>en-us</DictionaryOutLanguage>

...

</x-metadata>

• Make sure the special dictionary XML tags are used properly. The example below shows the correct format.

<idx:orth>record

<idx:infl inflgrp="noun">

<idx:iform name="plural" value="records" />

</idx:infl>

<idx:infl inflgrp="verb">

<idx:iform name="present participle" value="recording" />

<idx:iform name="past participle" value="recorded" />

<idx:iform name="present 3ps" value="records" />

</idx:infl>

</idx:orth>

The inflgrp

and name

attributes are optional. The idx:infl

, idx:iform

, and value

attributes are mandatory.

<idx:orth>record

<idx:infl>

<idx:iform value="records" />

<idx:iform value="recording" />

<idx:iform value="recorded" />

<idx:iform value="records" />

</idx:infl>

</idx:orth>

• Do not force the font color. Some Kindle devices allow the reader to change the background color to black. If text is forced black, it won’t be readable in this mode and the book will be suppressed.

7.5.2 Lookup Testing

This component of dictionary testing ensures that definitions are returned correctly when using the dictionary as a default to look up words in other books. This component of testing can only be done with e

Ink devices (not including Previewer).

• Start by sideloading the dictionary onto the device. To do this, connect the Kindle to your computer with a USB to mini USB cord. Your computer should detect the device. In the window

Kindle Publishing Guidelines Amazon.com 55

Publishing on Kindle: Guidelines for Publishers that pops up, you should see a folder called documents. Put the dictionary file into this folder, and eject your Kindle from the computer.

• Look up a variety of words to see what definition is returned. This can only be done on an e Ink device. To do this, set the test dictionary as default, and look up words in other books. To set this dictionary as the default dictionary: o

Kindle Keyboard: Go to Home > Menu > Settings >Menu > Change Primary

Dictionary. o

Kindle 4 or Kindle Touch: Go to Home > Menu > Settings > Dictionaries.

Open a different title, select a word, and note the definition returned. If words are not returning the correct definition (or any definition), there is probably a problem with the HTML tagging.

Suggestions of words to look up include: o

Root words and conjugations of regular and irregular verbs. Example: walk, walks, walked, walking; go, goes, went, gone, going. o

Nouns, adjectives, adverbs and their conjugations/declensions if they exist. Example: desk, desks; wolf, wolves; hot, hotter, hottest. o

Any type of word or grammatical/punctuation convention commonly used in the language and not listed above. Example: contractions.

• Check the index view of the dictionary. This can only be done on an e Ink device. To do this, open the dictionary and start typing a word in the Search box. An alphabetized list of headwords should appear and should dynamically update based on which letters are typed.

8 Media Queries

The new Kindle Format 8 (KF8) includes greater support for Cascading Style Sheets (CSS). For devices without KF8 support, content creators may require more control over the Mobi 7 experience than provided by the standard conversions supported by KindleGen. To address this need, Amazon has implemented media queries as a way to apply the best CSS styles for each file format. This allows complex CSS formatting to be used for KF8 and more basic formatting to be used for the Mobi format. Media queries are part of the W3 standard. For more information, visit http://www.w3.org/TR/css3-mediaqueries/

Support for two new media types enables content creators to use specific CSS based on the Mobi or KF8 file format: amzn-mobi and amzn-kf8.

• For KF8 CSS styles, use the media query @media amzn-kf8. This is only applied for the KF8 format.

• For Mobi CSS styles, use the media query @media amzn-mobi. This is only applied for the

Mobi format.

The @media screen and @media all styles continue to apply to both KF8 and Mobi. If the media type is not amzn-mobi, amzn-kf8, screen, or all, Kindle ignores it.

8.1 Using Media Queries

The following table outlines examples of supported media queries and the CSS applied to KF8, Mobi, and other readers:

Media Queries in CSS CSS Applied to KF8 CSS Applied to

Mobi

CSS Applied to

Other Readers

- - @media amzn-mobi

{ font-

Kindle Publishing Guidelines Amazon.com 56

Publishing on Kindle: Guidelines for Publishers

Media Queries in CSS

.class1

{

font=size:3em;

font-weight: bold;

}

}

.class1

{

font-style: italic;

font-size:2em;

}

@media amzn-mobi

{

.class1

{

font-size:3em;

font-weight: bold;

}

}

}

}

@media amzn-mobi

{

.class1

{

font-size:3em

!important;

font-weight: bold

!important;

CSS Applied to KF8 CSS Applied to

Mobi size:3em;

CSS Applied to

Other Readers font-weight: bold;

font-style: italic; font-style: italic;

font-size: 2em; font-size:

3em; font-weight: bold;

font-style: italic;

font-size:2em; font-style: italic;

font-size:2em; font-style: italic; fontsize:3em; font-weight: bold;

font-style: italic;

font-size:2em;

Kindle Publishing Guidelines Amazon.com 57

Publishing on Kindle: Guidelines for Publishers

Media Queries in CSS

.class1

{

font-style: italic;

font-size:2em;

}

@media not amzn-mobi

{

.firstletter

{

float: left;

font-size: 3em;

line-height: 1;

font-weight: bold;

padding-right: .2em;

margin: 10px

}

}

@media amzn-mobi

{

.firstletter { font-size: 3em;

}

}

@media amzn-kf8

{

p {

color: red;

}

}

CSS Applied to KF8 CSS Applied to

Mobi

CSS Applied to

Other Readers

.firstletter

{

float: left;

font-size:

3em;

line-height:

1;

font-weight: bold;

padding-right:

.2em;

margin: 10px

} firstletter

.firstletter

{ { font-size:

3em;

}

float: left;

font-size:

3em;

line-height:

1;

font-weight: bold;

padding-right:

.2em;

margin: 10px

}

}

p {

color: red;

}

Kindle Publishing Guidelines Amazon.com 58

Publishing on Kindle: Guidelines for Publishers

8.2 Using Media Queries for Backward Compatibility With Mobi

Media queries allow one CSS file to supply complex CSS for KF8 and basic CSS for the Mobi format.

Some guidelines:

• Complex CSS can be overridden for the Mobi format by redefining the same class inside the

@media amzn-mobi

media query.

• Per the W3C standard, media queries should either be: o

Individual queries specified after the common CSS; or

Example: class1 {font-size: 2em;}

@media amzn-mobi {.class1 {font-size: 3em;}} o

Include !important with each property to enforce precedence.

Example:

@media amzn-mobi {.class1 {font-size: 3em !important;}}

.class1 {font-size: 2em;}

CSS CSS Styles Applied to Mobi CSS Styles Applied to KF8 p

{

font-style: normal;

} h

{

font-weight: bold;

} div.example {

margin: 10px

} ul {

margin: 20px

padding-left: 30px;

}

.firstletter { float: left; p

{

font-style: normal;

} h

{

font-weight: bold;

} div.example {

margin: 10px

} ul {

margin: 20px

padding-left: 30px;

}

.firstletter { p

{

font-style: normal;

} h

{

font-weight: bold;

} div.example {

margin: 10px

} ul {

margin: 20px

padding-left: 30px;

}

.firstletter {

Kindle Publishing Guidelines Amazon.com 59

Publishing on Kindle: Guidelines for Publishers

CSS font-size: 3em; line-height: 1; bold; font-weight:

CSS Styles Applied to Mobi CSS Styles Applied to KF8 float: 0; font-size: 3em; float: left; font-size: 3em;

.2em; padding-right:

}

@media amzn-mobi

{

.firstletter {

}

} float: 0; font-size: 3em; line-height: 0; bold; font-weight: padding-right: 0; line-height: 0; bold; font-weight: font-weight: bold; padding-right: 0; .2em; padding-right:

) } line-height: 1;

8.3 Submitting a Media Query

There are four options for submitting media queries:

• One CSS file;

• Different CSS files;

• Style tags; and

• @import.

8.3.1 Option 1: Using One CSS File.

Media queries can specify different CSS for Mobi and KF8 formats in the same CSS file. In the example below, a different .class1 class is specified for the Mobi format than for the other formats in the same

CSS file.

Example:

.class1

{

font-style: italic;

font-size:2em;

}

Kindle Publishing Guidelines Amazon.com 60

Publishing on Kindle: Guidelines for Publishers

@media amzn-mobi

{

.class1

{

font-size:3em;

font-weight: bold;

}

}

8.3.2 Option 2: Using Different CSS Files

Media queries can specify different CSS for Mobi and KF8 formats in different CSS files. In the example below, the Mobi and KF8 formats utilize different CSS style sheets and the common CSS styles apply to all media.

Example:

<link href="common.css" rel="stylesheet" type="text/css">

<link href="kf8.css" media="amzn-kf8" rel="stylesheet" type="text/css">

<link href="mobi.css" media="amzn-mobi" rel="stylesheet" type="text/css">

8.3.3 Option 3: Using Style tags

Media queries can specify different CSS for Mobi and KF8 formats directly using <style> tags.

Example:

<style type="text/css">

<style type="text/css" media="amzn-kf8">

<style type="text/css" media="amzn-mobi">

8.3.4 Option 4: Using @import

Media queries can specify different CSS for Mobi and KF8 formats directly using @import to include different CSS files.

Example:

@import

@import url(common.css);

@import url(kf8.css) amzn-kf8;

@import url(mobi7.css) amzn-mobi;

8.4 Using the display:none Property with Media Queries

To specify different CSS for the content in Mobi 7 and KF8 format, use the display:none property with media queries. Support for the display:none property in the Mobi 7 format is available in Kindlegen 2.4 and later versions.

Example:

.defaultcontent

Kindle Publishing Guidelines Amazon.com 61

Publishing on Kindle: Guidelines for Publishers

{ display: block; }

.mobicontent

{ display: none; }

@media amzn-mobi

{

.defaultcontent

{ display: none; }

.mobicontent

{ display: block; }

}

8.4.1 Using the display:none Property with Complex Tables

Tables have extensive support in KF8, but complex tables do not render well in Mobi 7. With the display:none

property, you can use an HTML-based table for the KF8 content and an image-based table for Mobi 7, as shown in the example below.

Example:

.defaultcontent

{ display: block; }

.mobicontent

{ display: none; }

@media amzn-mobi

{

.defaultcontent

{ display: none; }

.mobicontent

{ display: block; }

}

<table class="defaultcontent" bordercolor="#E66C2C" border="1" cellpadding="4">

<tr>

<th>Heading</th>

<th>Heading</th>

Kindle Publishing Guidelines Amazon.com 62

Publishing on Kindle: Guidelines for Publishers

<th>Heading</th>

</tr>

<tr>

<td>Cell</td>

<td>

<table bordercolor="#003399" border="1" cellpadding="4">

<tr>

<td>Nested</td>

<td>Nested</td>

</tr>

<tr>

<td>Nested</td>

<td>Nested</td>

</tr>

</table>

</td>

<td>Cell</td>

</tr>

</table>

<img class="mobicontent" src="tableimage.jpg"></img>

8.4.2 Using the display:none Property with SVG Images

The SVG image format is supported in KF8, but not in Mobi 7. With the display:none property, you can use an SVG image for the KF8 content and a JPEG image for the Mobi 7 content, as shown in the example below.

Example:

.defaultcontent

{ display: block; }

.mobicontent

{ display: none; }

@media amzn-mobi

{

.defaultcontent

{ display: none; }

.mobicontent

Kindle Publishing Guidelines Amazon.com 63

Publishing on Kindle: Guidelines for Publishers

{ display: block; }

}

<svg class="defaultcontent" xmlns="http://www.w3.org/2000/svg" version="1.1">

<circle cx="100" cy="50" r="40" stroke="black" fill="red" />

</svg>

<img class="mobicontent" src="circleimage.jpg"></img>

8.4.3 Limitation on Using the display:none Property

Kindle limits usage of the display:none property for content blocks beyond 10000 characters. If the display:none

property is applied to a content block that is bigger than 10000 characters, Kindlegen returns an error.

9 Kindle Best Practices

9.1 Testing Kindle Books

There are three ways to test your Kindle book before adding it to the Kindle store:

1. Use the Kindle Previewer. You can test your EPUB file using the Kindle Previewer software, available for both Windows and Mac OS X. The Kindle Previewer allows you to select views that represent the different devices including Kindle, Kindle Fire, Kindle for PC, and Kindle for IOS.

The Kindle Fire device view displays the content in Kindle Format 8. For installation instructions,

see section 2.2.3, Kindle Previewer Software.

2. Use Kindle devices and Kindle applications. You can test Mobi 7 content on a Kindle e Ink device and on Kindle applications for PC/Mac/Android. You can text KF8 content on a Kindle Fire.

3. Use KDP. The Kindle Direct Publishing Platform accepts a variety of book formats and provides preview capability on the website. To learn more or sign up, visit http://kdp.amazon.com

.

Consider device compatibility. Keep in mind that users may wish to read your content on an extremely wide variety of devices, with very small or large screens and low or high resolution. Try to test your content on as diverse a selection of devices as possible, especially for complex ebooks such as fixedlayout children’s books.

Once you can read your book, use this checklist to confirm that your Kindle book does not contain blatant errors. (For a finer level of quality assurance, check against the complete formatting guidelines in section

3, General Formatting Guidelines):

1. Open the book for the first time or go to the cover page. o

Cover: The Kindle book should have a cover. o

Single Cover: From the cover, flip to the next page. There should not be another image

of the cover page. For exceptions, see section 3.2.3 Cover Image Guideline #3: Internal

Cover Must Not Appear Twice.

2. Go to the table of contents. o

In the table of contents, each item should be clickable and should link to the correct location in the book. There should be no page numbers in the TOC.

3. Go to any location in the book (reflowable ebooks only). o

Font size: Change the font size in the Kindle menu; the book font should change accordingly. Regular text should not be bold or italicized, and its alignment should not be forced.

Kindle Publishing Guidelines Amazon.com 64

Publishing on Kindle: Guidelines for Publishers o

Typeface: Change the typeface in the Kindle menu; the book font should change accordingly. If you have designed your book to use only a specific font file, please make

sure that you have followed guidelines in section 3.1.9 Text Guideline #9: Customizing

Font Selection . Not following these guidelines could lead to the Kindle settings reverting

to the customer's preferred reading font.

4. Go back to the first page and flip through every page of the book. o

Images: Images should not be too small. Make sure that all text in images is legible.

Large pictures should be scaled to fit the page and display in their entirety on one screen. o

Tables: Tables should appear correctly. Make sure that all text in tables is legible. o

Page numbers: There should not be any references to page numbers in the book, including in the cross-references, TOC, and index. o

Material only included with physical book: There should not be any references to material (such as a CD or DVD) that is only included with the physical book. o

Background settings (reflowable ebooks only): On a Kindle tablet device or

Previewer, confirm that your text is legible in all background color modes (white, black, and sepia). o

Magnification (fixed-layout only): Activate popups/panel view and check that all text content and/or panels have corresponding magnification, no content is overflowing the edge of the screen, and magnified reading order is correct.

10 Kindle Quality Guidelines

Amazon strongly recommends that you verify your exported content before converting it into a Kindle book because some content creation tools format content differently when exported to HTML.

In addition, Amazon encourages you to review the entire book for:

• missing content;

• wrong content;

• typos and complete character support;

• alignment errors;

• forced typeface throughout the entire book (reflowable ebooks) or correct font (fixed-layout ebooks);

• proper paragraph spacing and indenting; and

• forced font color or background color.

These errors negatively affect readability and may require the Amazon team to suppress the title to protect the reader’s experience.

Kindle Publishing Guidelines Amazon.com 65

Publishing on Kindle: Guidelines for Publishers

11 Appendices

11.1 Appendix A: HTML Tags Supported in Kindle Format 8

HTML Tag Description Supported on

KF8-Enabled

Devices & Apps

Notes

<!--...-->

Specifies a comment Yes

<!DOCTYPE>

<?xml?>

<a>

Specifies the document type

This tag identifies a document as an XML document

Specifies a hyperlink

Yes

Yes

Yes

Not on e Ink

<address>

Specifies an address element Yes

Links can only refer to items within the same file

<article>

<aside>

<b>

Specifies an article

Specifies content aside from the page content

Specifies bold text

Yes

Yes

Yes

<big>

<blockquote>

Makes the enclosed text one font size larger than the current or default font size

Specifies a long quotation

Yes

Yes

Deprecated tag –

Recommend using CSS instead

<body>

<br>

Specifies the body element

Inserts a single line break

Yes

Yes

<caption>

<center>

<cite>

<code>

Specifies a table caption

Centers text horizontally

Specifies a citation

Specifies computer code text

Yes

Yes

Yes

Yes

Deprecated tag –

Recommend using CSS style text-align:center instead

<col>

<dd>

<del>

Specifies attributes for table columns

Specifies a definition description

Specifies deleted text

Yes

Yes

Yes

<dfn>

<div>

Defines a definition term Yes

Specifies a section in a document Yes

Kindle Publishing Guidelines Amazon.com 66

Publishing on Kindle: Guidelines for Publishers

HTML Tag

<dl>

<dt>

<em>

<font>

<figcaption>

<figure>

<footer>

<h1>

<h2>

<h3>

<h4>

<h5>

<h6>

<head>

<header>

<hgroup>

<hr>

<html>

Description

Specifies a definition list

Specifies a definition term

Specifies emphasized text

Alters the font appearance of the text it encloses

Specifies caption for the figure element.

Specifies a group of media content, and its caption

Specifies a footer for a section or page

Specifies a heading level 1

Specifies a heading level 2

Yes

Yes

Yes

Yes

Yes

Yes Specifies a heading level 3

Specifies a heading level 4

Specifies a heading level 5

Yes

Yes

Specifies a heading level 6 Yes

Specifies information about the document

Specifies a group of introductory or navigational aids, including hgroup elements

Yes

Yes

Yes Specifies a header for a section or page

Specifies a horizontal rule Yes

Specifies an html document Yes

Supported on

KF8-Enabled

Devices & Apps

Yes

Yes

Notes

Yes

Yes Deprecated tag –

Recommend using CSS instead

<i>

<img>

<ins>

<kbd>

<li>

<link>

Specifies italic text

Specifies an image

Specifies inserted text

Specifies keyboard text

Specifies a list item

Specifies a resource reference

Yes

Yes

Yes

Yes

Yes

Yes Can only reference items

Kindle Publishing Guidelines Amazon.com 67

Publishing on Kindle: Guidelines for Publishers

<samp>

<section>

<small>

<source>

<span>

<strong>

<style>

<strike>

<sub>

<sup>

<table>

<tbody>

<td>

<tfoot>

<th>

<thead>

<mark>

<menu>

<ol>

<output>

<p>

<pre>

<q>

<rp>

<rt>

HTML Tag Description

Specifies marked text

Specifies a menu list

Specifies an ordered list

Specifies some types of output

Specifies a paragraph

Specifies preformatted text

Specifies a short quotation

Used for the benefit of browsers that don't support ruby annotations

Specifies the ruby text component of a ruby annotation.

Specifies sample computer code

Yes

Yes

Yes

Specifies a section Yes

Yes

Yes

Yes

Yes

Yes

Supported on

KF8-Enabled

Devices & Apps

Notes

Yes

Yes within the same file

Specifies small text Yes

Specifies media resources Yes

Specifies a section in a document Yes

Specifies strong text

Specifies a style definition

Yes

Yes Can only reference items within the same file

Create a strikethrough text

Specifies subscripted text

Specifies superscripted text

Specifies a table

Specifies a table body

Specifies a table cell

Specifies a table footer

Specifies a table header

Specifies a table header

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes Use for tabular data only

Kindle Publishing Guidelines Amazon.com 68

Publishing on Kindle: Guidelines for Publishers

HTML Tag

<time>

Description

Specifies a date/time

Specifies the document title

Supported on

KF8-Enabled

Devices & Apps

Yes

Yes

Notes

<title>

<tr>

Specifies a table row Yes

<u>

Underlines any text it encloses

Specifies an unordered list

Yes

Yes

<ul>

<var>

Specifies a variable Yes

<wbr>

<nav>

<summary>

Specifies a line break opportunity for very long words and strings of text with no spaces.

Specifies navigation links

Specifies a summary/caption for the <details> element

Specifies a video

Yes

Yes

Yes

<video>

No

<audio>

Specified an audio content No

*Partial support (see

http://www.mobipocket.com/dev/article.asp?BaseFolder=prcgen&File=TagRef_OEB.htm

)

The following HTML tags are not supported in the Kindle format:

• Canvas

• Command

• Datalist

• Script (reserved for Amazon use only)

• Base

• Form

• Eventsource

• KeyGen

• Input

• Embed (Only SVG is supported for Kindle Fire)

• Object (Only SVG is supported for Kindle Fire)

• Param

• Noscript

• IFrame

Kindle Publishing Guidelines Amazon.com 69

Publishing on Kindle: Guidelines for Publishers

11.2 Appendix B: CSS Selectors, Attributes, and Properties Supported in Kindle

Format

Notes CSS Attribute Supported on

KF8-Enabled

Devices & Apps

/*Comment*/

Yes CSS comment

@import

@charset

Yes

Yes

Import external style sheets

Declares character encoding

@font-face

Yes Allows for linking to fonts

*

Yes Selects all elements

E

Yes Matches any E element (div, span, p)

E.class

Yes Class selector

E#id

E:link

Yes

Yes

ID selector

Link selector (not yet visited)

E:visited

Yes Link selector (visited)

Margin

Yes Sets margin properties

Padding

Yes Sets padding properties

Width

Yes Sets width of an element

Height

Float

Yes

Yes

Sets height of an element

Specifies if a box should float on the side

Clear

Yes Specifies which side of an element where other floating elements are not allowed

Specifies the type of box an element should generate

Sets minimum width of an element

Display

Yes

Yes min-width max-width

No min-height

Yes max-height

Yes

Clip

Yes

Visibility

Yes

Border

Yes border-color

Yes border-style

Yes

Sets maximum width of an element

Sets minimum height of an element

Sets maximum height of an element

Clips an absolutely positioned element

Specifies whether or not an element is visible

Sets all border properties

Sets the colors of all four borders

Sets the style of all four borders

Kindle Publishing Guidelines Amazon.com 70

Publishing on Kindle: Guidelines for Publishers

CSS Attribute Supported on

KF8-Enabled

Devices & Apps border-width

Yes border-top

Yes border-right

Yes borderbottom

Yes border-left

Yes borderradius

Yes line-height

Yes verticalalign

Yes

Position

Yes

Top

Yes

Right

Bottom

Yes

Yes

Left

Yes z-index

Yes list-style

Yes list-styleimage

Yes list-styleposition

Yes list-styletype

Yes

Opacity

Yes

Background

Yes backgroundattachment

Yes backgroundcolor

Yes backgroundimage

Yes

Notes

Sets the width of all four borders

Sets the top border properties

Sets the right border properties

Sets the bottom border properties

Sets the left border properties

Sets the radius for rounded corner in borders

Sets the vertical space between baselines

Sets vertical alignment

Sets type of positioning (static, relative, absolute)

Sets the top margin edge for a position box

Sets the right margin edge for a position box

Sets the bottom margin edge for a position box

Sets the left margin edge for a position box

Sets the stack order of an element

Sets the properties of a list

Specifies an image as the list-item marker

Specifies where to place the list item market

Specifies the type of list item marker

Sets the transparency of an element

Sets the background property

Sets whether a background image is fixed or scrolls with the rest of the page

Sets the background color of an element

Sets the background image of an element

Kindle Publishing Guidelines Amazon.com 71

Publishing on Kindle: Guidelines for Publishers

CSS Attribute Supported on

KF8-Enabled

Devices & Apps backgroundposition

Yes backgroundrepeat

Yes backgroundclip

Yes backgroundorigin

Yes backgroundsize

Yes

Font font-family

Yes

Yes

Notes

Sets the starting position of a background image

Sets how a background image is repeated

Specifies whether an element's background, either the color or image, extends underneath its border

Determines the background positioning area

Specifies the size of the background images font-size font-style

Yes

Yes

Sets all font properties

Allows for a prioritized list of font family names and/or generic family names to be specified for the selected element

Specifies the size of the font

Allows font style (italic or oblique) to be selected within a fontfamily

Selects a normal, or small-caps face from a font family

Specifies the weight or boldness of the font

Specifies the horizontal alignment of text

Specifies the decoration to be added to the text font-variant

Yes font-weight text-align

Yes

Yes textdecoration

Yes text-indent

Yes

Yes texttransform letterspacing

Yes word-spacing

Yes white-space

Yes text-shadow

Yes textoverflow

Yes word-wrap

Yes

Specifies the indentation of the first line in a text block

Controls the capitalization of the text

Increases or decreases the space between characters in a text

Increases or decreases the space between words in a text

Specifies how white space inside an element is handled

Specifies the shadow effect added to text

Specifies whether an ellipsis displays when text content has overflowed its given layout area

Specifies whether or not the browser is allowed to break lines within words to prevent overflow when an otherwise unbreakable string is too long to fit

Kindle Publishing Guidelines Amazon.com 72

Publishing on Kindle: Guidelines for Publishers

CSS Attribute Supported on

KF8-Enabled

Devices & Apps

Direction

Yes

Notes

Sets the base text direction and block-level elements and the direction that cells flow within a table row

Selects the border model bordercollapse borderspacing caption-side empty-cells

Yes

Yes

Yes

Yes

Specifies the distance between the borders of adjacent cells

Positions the content of table-caption at the specified side

Specifies how to render borders and backgrounds around cells that have no visible content.

Sets the outline properties

Outline

No outlinecolor

No Sets the color of an outline outlinestyle

No Sets the style of an outline outlinewidth

No Sets the width of an outline outlineoffset

Yes Sets the space between an outline and the edge or border of an element

Width

Yes

Height deviceheight

Yes device-width

Yes

Yes

Specifies the width of the content area of an element

Specifies the height of the content area of an element

The width of the screen in CSS pixels at zoom factor 1.0

The height of the screen in CSS pixels at zoom factor 1.0 deviceaspect-ratio

Yes Describes the aspect ratio of the output device

Color

Yes Sets the color of text color-index

Monochrome

Yes

Yes

Describes the number of entries in the color lookup table of the output device

Describes the number of bits per pixel in a monochrome frame buffer

The following CSS selectors, attributes, and properties are not supported in the Kindle format:

• E + F (Direct adjacent)

• E ~ F (Indirect adjacent)

• E: first-child

• E: first-of-type

Kindle Publishing Guidelines Amazon.com 73

Publishing on Kindle: Guidelines for Publishers

• E: last-child

• E: last-of-type

• E: only-child

• E: only-of-type

• E: nth-child

• E: nth-last-child

• E: nth-of-type

• E: nth-last-of-type

• E: first-letter

• E: first-line

• E: before

• E: after

• E::before

• E::afterCounter-incrementCounter-reset

Kindle Publishing Guidelines Amazon.com 74

Publishing on Kindle: Guidelines for Publishers

11.3 Appendix C: Guidelines for Converting XMDF to KF8

11.3.1 Kindlegen Command

Kindlegen accepts the folder containing the XMDF source file as input. Use the command: kindlegen <folder name>

You can use an additional command line option (-intermediate_only) to generate intermediate

OPF/HTML files: kindlegen -intermediate_only <folder name>

This option generates intermediate files as OPF/HTML files in a new folder next to the input folder.

Kindlegen names this folder with the input folder name followed by _dump. To change anything in the intermediate files, use these intermediate HTML or OPF files.

The OPF file is named current_content.opf and can be found at the same location as the main.xml file.

Use the following command to generate the KF8 from OPF/HTML files: kindlegen <OPF File>

11.3.2 Source Issues

An XMDF source can have multiple issues that degrade the reading experience on Kindle. You can correct these issues to improve the reading experience. The following sections list a few of the top source issues found in our testing,

11.3.2.1 Source Issue #1—Poor Image Quality

Bad quality images will result in the cover or other image being displayed too small. To avoid this, provide

good quality images. For quality requirements, see section 3.2 Cover Image Guidelines and section 3.6

Image Guidelines.

11.3.2.2 Source Issue #2—Blurred Gaiji characters

Replace Gaiji characters with corresponding code characters or provide high quality images of at least 64 x 64 to avoid blurring.

Requirements for Gaiji image files:

• Image format: PNG (8-bit) format or JPEG format (8-bit transparent image recommended)

• Size: 128 x 128 pixels or greater is recommended

11.3.2.3 Source Issue #3—TOC Entries Hanging Style

Use the proper style of positive margin and negative indent to create TOC text with the proper indentation.

Correct:

<p top_line_indent = "-1em" top = "1em">

<char_id char_id = "CR0002">Part 1</char_id><br/>

<char_id char_id = "CR0004">Sub-Part 1</char_id><br/>

<char_id char_id = "CR0006">Sub-Part 2</char_id><br/>

</p>

Incorrect:

<char_id char_id = "CR0002">Part 1</char_id><br/>

<char_id char_id = "CR0004">Sub-Part 1</char_id><br/>

Kindle Publishing Guidelines Amazon.com 75

Publishing on Kindle: Guidelines for Publishers

<char_id char_id = "CR0006">Sub-Part 2</char_id><br/>

11.3.2.4 Source Issue #4—TOC Entries Not Linked

All TOC items must be linked to the corresponding chapter.

11.3.2.5 Source Issue #5—Incorrect Number Orientation in TOC

Apply tate-chu-yoko style for TOC index numbers to avoid incorrect number orientation.

Correct:

<char_id char_id = "CR0020">

<yoko>10</yoko>

</char_id>

CHAPTER X

Incorrect:

<char_id char_id = "CR0020">10</char_id>

CHAPTER X

11.3.2.6 Source Issue #6—Bold Kanji Characters

Avoid bold style for Kanji characters. This sort of styling makes the characters look blurred.

Correct:

遺

Incorrect:

<font bold = "yes">遺</font>

11.3.2.7 Source Issue #7—Faded Text

Leave the text color unspecified. Using light colors results in faded text.

Some Kindle devices allow the reader to change the background color to black. If text is forced black, it will not be readable in this mode and the book will be suppressed.

11.3.2.8 Source Issue #8—No Space Between Images

Use line breaks (<br/>) to avoid images rendered without space.

Example:

<object type="image/png" src="image1.png"/>

<br/>

<object type="image/png" src="image2.png"/>

11.3.2.9 Source Issue #9—Images Not Shown In Separate Pages

To display images on separate pages, use separate chapters for each image.

11.3.2.10 Source Issue #10—TOC Not Shown

To ensure that the TOC is shown, include all of the important links in <special_page_link>.

Example:

<special_page_link>

<special_page title="Chapter 1">PG1111</special_page>

<special_page title="Chapter 2">PG1112</special_page>

Kindle Publishing Guidelines Amazon.com 76

Publishing on Kindle: Guidelines for Publishers

...

</special_page_link>

11.3.2.11 Source Issue #11—Large Amount of Text Is Not Centered

Do not use the valign="middle" style for large amounts of text.

11.3.2.12 Source Issue #12—Duplicate IDs

Do not use the same Flow ID/Page ID mentioned in the source. Use unique ID names.

11.3.2.13 Source Issue #13—File Path and File Name Requirements

Do not use the backward slash (\) for specifying file path; always use the forward slash (/) instead. Do not include special characters (such as !, @, #, $) in the file path or file name.

11.3.3 Unsupported Features

Some XMDF features are not supported in Kindle. If the file has such features, Kindlegen displays an error message and fails the conversion. These are the unsupported features.

Serial

No.

Feature Tag Example

1 Image animations flip_animation <flip_animation renewal_time="500ms" >

<flip_animation_source src="aaa9.jpg" type="image/jpeg"/>

2

3

4

Comic books comic_object_entry

Sound media sound_object_entry

Movie media movie_object_entry

<flip_animation_source src="aaa2.jpg" type="image/jpeg"/>

...

</flip_animation>

<parts_module>

<object_table>

...

<comic_object_entry src=”comic9.xml" type="application/x-bvf-comic" object_id="OB0001"/>

</object_table>

</parts_module>

<parts_module>

<object_table>

...

<sound_object_entry src=”movie9.3g2" type=”video/3gpp2” object_id=”OBmv00”/>

</object_table>

</parts_module>

<parts_module>

<object_table>

...

<movie_object_entry src=”movie9.3g2" type=”video/3gpp2” object_id=”OBmv00”/>

Kindle Publishing Guidelines Amazon.com 77

Publishing on Kindle: Guidelines for Publishers

Serial

No.

Feature

5

6

7

Tag Example

Search pages

Clickable area in images

Trigger action pointing to a

URL with ampersand

HTML entity

</object_table>

</parts_module> search_page_object_entry <parts_module>

<object_table>

...

<search_page_object_entry src="spage9.xml" type="text/x-bvf-searchpage" object_id="OBSP01" />

</object_table>

</parts_module> pointer_region <event>

<trigger>

<trigger_pointer id="OB003k/CR0001" action_flag="click">

<pointer_region>

<vertex position="(0,0)"/>

<vertex position="(100,0)"/>

<vertex position="(100,100)"/>

<vertex position="(0,100)"/>

</pointer_region>

</trigger_pointer>

</trigger> action_page_jump

<action>

<action_page_jump page_id="PG0043"/>

</action>

</event>

<event>

<trigger>

<trigger_pointer id="OB0006/CR0015" action_flag="click"/>

</trigger>

<action>

<action_page_jump book="http://www.japanvisitor.com/index.php?

cID=359&amp;pID=986" book_type="text/html"/>

</action>

</event>

Kindle Publishing Guidelines Amazon.com 78

Publishing on Kindle: Guidelines for Publishers

8

9

1

2

11.3.3.1 Ignored Features

For some features that are not supported, Kindlegen does not error out. Instead, Kindlegen ignores them and proceeds with the conversion. These are the ignored features.

Serial

No.

Feature Tag/Attribute Example

3

Pronunciation Reading attribute

Alternative code and set for Gaiji

Attributes alt_set and alt_code of tag external_char

Permission information permission_info

<title reading="PI">π</title>

<external_char alt_set="sh_extchars" alt_code="0x2345" alt="間"/>

<permission_info>

<print_permission permission="authorized"/>

</permission_info>

4

5

Line breaking method

Play back line_breaking_method action_play

<line_breaking_method method="word_wrap">

6 Opacity attribute

<event>

<trigger>

<trigger_pointer id="OB0006/CR0015" action_flag="click"/>

</trigger>

<action>

<action_play object_id="OBkj23"/>

...

</action>

</event>

<font color="#FF0000" opacity="100"/>

7

Opacity for font, background and others

Background music

10

Drop cap

Scrolling text content text_default_background_music <text_default_attribute>

<text_default_background_music src="9.mp3" type="application/x-smaf" loop="yes"/>

...

</text_default_attribute> drop_cap scrolling_text

Mask

<p drop_cap="2">Alice was...</p>

<scrolling_text>

This text will be scrolling over and over

</scrolling_text>

<mask>42 </mask>

11

Content masking

Key entries for search key_entry <key_entry>

<key_item search_word="color"

Kindle Publishing Guidelines Amazon.com 79

Serial

No.

Feature

Publishing on Kindle: Guidelines for Publishers

Tag/Attribute Example table_id="ST0001">

Color

</key_item>

<key_item search_word="colour" table_id="ST0002">

Colour

</key_item>

</key_entry>

Kindle Publishing Guidelines Amazon.com 80