The Numbers Reading Software Shows

Restart the numbering somewhere in the document, in roman numerals, in letters, or behind a prefix.

See It in a Real PDF

Custom Page Labels

Fourteen pages numbered by their labels rather than their position: small and capital roman numerals, ordinary figures, letters, a prefix before figures or letters, and a back cover labelled with the prefix alone.

Open the PDF The Whole Example

Also shown in: A Whole Novel in English · A Whole Novel in French · Showing Page One Before the File Has Arrived

Summary

In a book, the opening pages — the preface, the contents — are numbered in small roman numerals, and the real text starts again at page 1. The annex often shows A-1, A-2. What you are setting is the number the reading software shows in its little box, the one you type to jump straight to a page — rather than the number printed on the sheet, which is yours to draw.

Technically

Written at the top level of a request, under "renumber"

renumber writes the /PageLabels number tree: each entry opens a range of pages at a one-based page, with its style in /S, its prefix in /P and its first number in /St, and makes the number reading software shows start again from that sheet. That number is a separate thing from the sheet's physical position in the file; it lives in the page label. Six spellings exist, one of which writes a prefix and no figure at all. The {page_label} substitute inside a text draws that label as reading software shows it.

Request Schema

  • renumber — array, optional, empty by default.
  • renumber[].from_page — integer, required. The sheet the restart takes effect from; sheets count from 1.
  • renumber[].value — integer ≥ 1, required. The number shown on that sheet. Zero is refused: the numbering reading software shows has no way to spell it.
  • renumber[].style — string, optional, decimal by default. Six values: decimal (1, 2, 3), upper_roman (I, II, III), lower_roman (i, ii, iii), upper_letters (A, B, C then AA, BB), lower_letters (a, b, c then aa, bb), prefix_only (the prefix alone, no figure).
  • renumber[].prefix — string, optional, empty by default. What each page of the range shows before its number: A- for an annex numbered A-1, A-2.

A Whole Request That Creates a PDF

{
  "renumber": [
    { "from_page": 1, "value": 1, "style": "lower_roman" },
    { "from_page": 3, "value": 1, "style": "decimal" }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 60, "urx": 535, "ury": 74 },
      "content": ["Page {page_label}"],
      "font": "sans",
      "font_size": 10,
      "align": "center"
    },
    {
      "type": "text",
      "pages": [4],
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
      "content": ["The annex"],
      "font": "sans",
      "font_size": 14
    }
  ]
}

The line that sends it, in three languages

The document as a whole

A Hundred Letters in a Single File What the Document Says about Itself What the Document Says about Itself, Said Once Text Nobody Can Copy The Notes a Program Leaves in the File for Itself The Notes a Program Leaves on One Page The Data a Program Hangs on a Run of Ink A File Still Readable Decades from Now The Print Standard the Document Claims The Variable Print Standard the Document Claims The Password That Opens It, and What May Be Done with It An Invoice a Person and a Machine Both Read The Address Relative Links Are Read Against The PDF Version the File Declares The Extensions to PDF the File Says It Uses What a Picture Says about Itself, and How It Is Read The Attachments the Document Carries Beside Its Pages Files the Document Names without Carrying The Attachments Shown as a Portfolio Which Attachments a Page Claims Which Attachments a Font Claims The Identity Card a Single Font Carries Which Attachments the Document's Card Claims A Document Card Written Elsewhere The Areas of a Page a Reader Measures In The Identity Card a Single Page Carries The Accessibility Standard the Document Claims The Standards the Finished Document Is Measured Against

Where to Go Next

Every JSON key of a request, in one page The other forty-one settings of a request

See the Prices See the Examples