Validate epubs for Amazon Kindle upload only
Requirements
Plugin Type: Validation
MIT Licence(OSI)
Minimum Sigil requirement: v0.9.3 or higher
Python Requirements: Python 3.4+ (Bundled or External)
OS Requirements: Windows, Linux or OSX
*** Tested on Windows 7, 8 & 10 only ***
Current Version: "0.1.3"
Installation
* Select
Manage Plugins from the
Plugins menu. In the dialog box, select either the Bundled Python or the External Python(Python 3.4+ should be installed on your computer to run this plugin externally).
* Click
Add Plugin and select
KDPValidator_vXXX.zip. This will load and install the plugin into Sigil, which you can then run by selecting
Plugins > Validation > KDPValidator
Description
This plugin checks and validates epubs for Amazon Kindle upload only and should be used for epub 2.0 ebooks that are going to be viewed on KF8 or KF7 devices. This plugin gives the user a last quick check before upload to KDP.
The plugin checks for the following:
* Unsupported html tags.
* Usupported html attributes.
* Unsupported style attributes in the css, html <styles> and html inline styling(very basic check).
* Cover pages not allowed warning.(added in v0.1.2)
* Bad ebook image format.
* Bad internal links
* SVG image warning
* Flags ebook images smaller than max page size that are not dual formatted
* Non-use of heading styles.
* Inappropriate use of absolute values in the css.
* Missing TOC file.
* Logical TOC does not contain the same toc items as the epub TOC file.
* Missing or too many opf guide references.
* Look Inside formatting issues.
User Suppressed Warnings(added in v0.1.2)
The plugin user can now turn off or suppress any plugin warning by accessing the
KDPValidator.json file and changing any of the listed warning values to "false". Initial default warning values are all set to "true".
Caveat
Be aware that if you've used an epub converter that uses indexed styling -- such as calibre23, scrivener15 etc -- then only a few of the plugin's css checks can be run. However, all further checks on the epub's content.opf, toc.ncx and xhtml files should run without any problems.
Plugin Run
* First load your epub into Sigil, run Epubcheck and ensure there are no errors.
* Run this plugin. All errors/warnings will be displayed in the validation pane.
Changes
Spoiler:
v0.1.3
-- Fixed a bug in cover page detection. The plugin now detects the epub cover page by searching for the presence of the guide cover reference in the opf.Thanks to DiapDealer.
v0.1.2
-- The plugin will now give a warning if there is a cover image file in the epub. There should be no cover image on upload to KDP as per the Kindle Guidelines.Thanks to st_albert and Hitch.
-- The user can now turn off or suppress any plugin warning by accessing the KDPValidator.json file and changing any of the listed warning values to "false". The initial default warning values are all set to "true". Thanks to DiapDealer.
v0.1.1
-- Changed from using standard cover file names to using the actual cover file name derived from the guide cover href for searches in the cover file checks. Thanks to KevinH for the suggested change.
.
v0.1.0
-- Initial release