kdp:ebook

Build a Kindle-oriented EPUB for Amazon KDP upload.

papyrus kdp:ebook
papyrus kdp:ebook --require-epubcheck
papyrus kdp:ebook -d /path/to/book -e /path/to/out

Requires kdp.ebook.enabled => true.

#Options

#Output

export/<slug>-kdp.epub

Papyrus runs an internal KDP-oriented check and, when available on PATH, epubcheck (install with brew install epubcheck, or from w3c/epubcheck). Warnings from those checks are printed to the console. Without epubcheck, the build still succeeds with a warning unless you pass --require-epubcheck.

#Cover

'kdp' => [
    'ebook' => [
        'enabled' => true,
        'cover' => 'cover-ebook.jpg', // under assets/
    ],
],

If kdp.ebook.cover is unset, Papyrus falls back to the light theme cover (cover.light or cover.image).

#Metadata

Description falls back to "{title} - {author}" when kdp.metadata.description is empty. Language uses kdp.metadata.language when set, otherwise project language (default en).

#Versus build:epub

Internal checks also warn on an empty kdp.metadata.description and on eBook cover images smaller than 1600 px on the shortest side (when GD can read the file).