From 4edc48bb89bfdd1b16fbe145bc8a3e6c03641d06 Mon Sep 17 00:00:00 2001 From: tannevaled Date: Mon, 9 Nov 2026 12:22:50 +0100 Subject: [PATCH] docs: the pieces in one zip, and the tokens every stamp fills in Two sentences the workbench page did not have. Splitting hands the pieces over in one zip since go-pdfkit/app#97, for the reason the old verb said out loud in its own status line -- a browser asks about each download separately. And a stamp has always filled {page}, {pages} and {n} in, not only `Number them`, which makes a stamp at top centre a header with a page number in it; nothing anywhere said so, and a capability nobody can find is not delivered. Covers go-pdfkit/app#97. Co-Authored-By: Claude Opus 5 --- content/working-with-a-file/workbench.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/content/working-with-a-file/workbench.md b/content/working-with-a-file/workbench.md index 5456815..1407bff 100644 --- a/content/working-with-a-file/workbench.md +++ b/content/working-with-a-file/workbench.md @@ -412,6 +412,19 @@ Three things worth knowing before you press: one picture per page. The difference is the name: a comic reader opens the `.cbz` and not the `.zip`. +**Split and hand them over** gives the pieces in one zip as well, and for the +same reason: a browser asks about each download separately, so a 200-page +document split into twenties was ten prompts, each refusable on its own — +leaving somebody with four pieces and no way of knowing which four. One piece +is handed over as the PDF itself, since a zip holding a single file is a +wrapper to open for nothing. Nothing is changed by it: the pieces are copies of +what stays open. + +A **stamp** may say what it is being drawn on. `{page}`, `{pages}` and `{n}` are +filled in for every stamp, not only for *Number them* — so a stamp at *top +centre* reading `Report — {page} of {pages}` is a header with a page number in +it, and one at *bottom centre* is a footer. + ## Every change is applied, written, and read back Before it is drawn. So what is on the screen is what would come out of Save,