User`s guide

Publishing on Kindle: Guidelines for Publishers
Appendix C: Guidelines for Converting XMDF to KF8 11.3
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 85