Press reference
Generated by press selftest --write-docs from the
artifact registry and the CLI’s own usage; the selftest fails when this
file drifts from the machinery it describes.
Artifacts
| pdf |
{slug}.pdf |
- |
yes |
| epub |
{slug}.epub |
- |
yes |
| html |
{slug}.html |
- |
yes |
| markdown |
{slug}.md |
- |
yes |
| txt |
{slug}.txt |
- |
yes |
| docx |
{slug}.docx |
- |
yes |
| site |
site, {slug}-site.zip |
- |
yes |
| source |
{slug}-source.zip |
- |
yes |
| sources |
{slug}-sources.md |
markdown |
yes (when authorities configured) |
| pages |
pages |
pdf, epub, html, markdown, txt, docx, site, source, sources |
no |
| print |
{slug}-interior.pdf |
- |
no |
| coverwrap |
{slug}-coverwrap.pdf |
print |
no |
Builders, verifiers, and
destinations
| pdf |
build (pandoc + latexmk) |
verify_pdf |
Pages downloads + GitHub Release |
| epub |
build |
verify_formats + epubcheck |
Pages downloads + GitHub Release |
| html |
build |
verify_formats |
Pages downloads + GitHub Release |
| markdown |
build |
verify_formats |
Pages downloads + GitHub Release |
| txt |
build |
verify_formats |
Pages downloads + GitHub Release |
| docx |
build |
verify_formats |
Pages downloads + GitHub Release |
| site |
build |
verify_formats + verify_archives |
Pages downloads + GitHub Release |
| source |
package_source |
verify_archives |
Pages downloads + GitHub Release |
| sources |
gen_authorities |
verify_archives |
Pages downloads + GitHub Release (when authorities configured) |
| pages |
build |
verify_pages |
deployed as the Pages site |
| print |
build (print profile) |
verify_pdf (print profile) |
GitHub Release when built (print pack) |
| coverwrap |
gen_coverwrap |
verify_coverwrap |
GitHub Release when built (print pack) |
Targets
usage: press <target>
building pdf epub html markdown site txt docx pages source all
checking check style verify verify-formats verify-pages
print pack print verify-print coverwrap publish kdp|ingram [--report-only] isbn status | assign print|epub onix [--forthcoming] pcn lookup lccn|issn [<number>]
utilities render wordcount figures clean new <directory> add chapter|appendix <name> [--front] config get|set|unset|list|validate selftest doctor migrate [plan] | apply | rollback | status
instruments skills workflows desk
art art commission [targets] | accept <file> --as <target> cover [--style <id>] [--subject <text>] | --list illustrate <name> [--style <id>] [--from <image>] | --list
operator improve [--apply] research aesthetic ["<brief>"]
