Chapter LedgerBooks · writing · the life of an edition

Entry 03 / Editions & access

Calibre Checks Should Follow the Reading Order

A practical route through Calibre’s editor: preserve a checkpoint, inspect the spine as a reader will meet it, and treat automated findings as questions for the edition.

Calibre editor: file browser, source code and reading preview
Calibre documentation screenshot; a source example, not a Chapter Ledger test. calibre / Kovid Goyal. REFERENCE ONLY — NOT CLEARED FOR PRODUCTION. Local reference image · owner review pending.

Begin with the route

An EPUB is not only a folder of competent files. It is also an order in which a reader meets title page, contents, chapter, note, and return link. Calibre’s editor presents the book’s HTML files in reading order; its manual identifies that order as the spine. Before changing a word, read that list aloud as a route. Does the edition begin where it should? Does a foreword come before the first chapter? Are notes and end matter placed deliberately rather than merely present?

Make a copy outside the working folder, then create a Calibre checkpoint before a multi-file change. The manual says checkpoints preserve a book state and are also made when automated tools run. That is not an instruction to distrust automation. It is a way to leave the editor a recoverable record when a global replacement, cleanup, or repair changes more than was intended.

Read the report as a finding list

Calibre’s Check book tool reports malformed markup, malformed or unknown CSS, broken internal links, unreferenced files, OPF problems, and some known compatibility concerns. Run it after a contained change, not only at the end when a report has become a thicket. Give each item a small decision: fix, investigate, or retain with a reason. A warning is not a verdict on literary or editorial quality; it is a prompt to inspect the object named by the report.

Open a broken link at its destination and then approach it from the reader’s direction. A link may resolve technically while still landing before the relevant note, at a blank anchor, or in the wrong chapter. Likewise, an unreferenced image may be waste, or it may be a resource that a stylesheet calls in a way the report cannot read. The inspection is the work; the message merely tells you where to begin.

Finish in a different reader

The live preview is useful while editing: it follows code changes and lets a click in the preview return to the corresponding element. But Calibre’s own manual says the preview is not a substitute for a reader device or software emulator. It can tolerate sloppy markup and does not show every margin, page-break, or embedded-font behavior. Treat its view as a working proof, not a final reader’s experience.

A modest release pass is enough to reveal much: move through the contents, every chapter transition, a note link, an external link, a table or image, and the final page. Change type size once. Then repeat the route in a second reading system if the edition’s destination makes that relevant. Record device, app, version, and the exact file tested. This is practical interpretation, not a claim that Calibre itself certifies a book for every device.

Keep the ledger beside the file

Save the checkpoint date, the report’s unresolved items, and the reader-route checks with the delivered EPUB. If a later editor needs to move a dedication or correct a broken note, they inherit a reasoned record instead of an immaculate-looking archive with no history. The edition becomes easier to revise because its route was made visible.

Sources & limits

This is editorial workflow guidance. No Calibre build, EPUB, device, or emulator was tested for this entry; current behavior belongs to the inspected documentation.

  1. Editing e-books
    calibre Documentation · Source undated · Consulted 16 Sept 2026

    The editor supports EPUB, KEPUB, and AZW3; its file browser presents text files in reading order; Check book reports structural and compatibility issues; preview is not a substitute for testing in an actual reader or emulator.

  2. Frequently Asked Questions
    calibre Documentation · Source undated · Consulted 16 Sept 2026

    calibre says it does not guarantee every EPUB it produces is valid and distinguishes content and metadata tables of contents in its conversion guidance.

Send a correction with the passage and supporting source.

The weekly letter

Something to return to.

A weekly letter about the writing life, the making of books, and the details that reward a slower look.

How we handle your email

Newsletter signup is separate from submissions and contact messages.