PDF features¶
From the document itself kolinsky writes internal and external links, the metadata of <title> and
<meta> and the files of <link rel="attachment">; with outline also the bookmarks of its headings
(bookmark-level, bookmark-label, bookmark-state). The options below add to or replace what the
document sets.
Options¶
The options of writing the PDF; the Rust names are the fields of PdfOptions, the Python names the
keys of kolinsky.PdfOptions.
| Feature | Rust and Python option | Command line |
|---|---|---|
| The document title | title |
--title TEXT |
| An author | authors |
--author TEXT |
| The document subject | subject |
--subject TEXT |
| A keyword | keywords |
--keyword TEXT |
| The document language (BCP 47) | language |
--lang TAG |
| The creation date (RFC 3339) | creation_date |
--creation-date DATE |
| PDF/A and PDF/UA levels, comma separated | standards |
--pdf-standard LIST |
| Write a tagged PDF | tagged |
--tagged |
| Write the outline of the document's bookmarks | outline |
--outline |
| The pages written, for example 1-3,5 | pages |
--pages RANGES |
| Embed a file | attachments |
--attach FILE[:REL] |
| Reproducible output | deterministic |
--deterministic |
Standards¶
The conformance levels a PDF can claim (standards, --pdf-standard).
| Standard | Name in options |
|---|---|
| PDF/A-2b | a-2b |
| PDF/A-3u | a-3u |
| PDF/A-4 | a-4 |
| PDF/UA-1 | ua-1 |
| PDF/UA-2 | ua-2 |
Checks¶
Each PDF feature is measured by small check tests: an HTML input and assertions on the PDF written (links, outline, metadata, fonts, text, tags, attachments and so on). Results of 2026-11-14; the conformance page describes the method. The checks run every engine through one adapter that maps a check's options to the engine's command line. For kolinsky it passes tagging, interactive form fields and the levels PDF/A-2b, PDF/A-3u and PDF/UA-1; checks of page ranges, attachments given as options, reproducible output, PDF versions, encryption and viewer settings get no option and count as not passed, even where kolinsky has the option (see the table above). Interactive form fields are not part of the options of this release.
| Area | Feature | Checks passed |
|---|---|---|
| Accessibility | Alt text | 3 of 5 |
| Accessibility | Language | 0 of 3 |
| Accessibility | Links | 3 of 3 |
| Accessibility | PDF/A | 4 of 10 |
| Accessibility | PDF/UA | 6 of 6 |
| Accessibility | Reading order | 4 of 5 |
| Accessibility | Structure types | 13 of 15 |
| Accessibility | Tagging | 5 of 6 |
| Attachments | Html attachments | 6 of 7 |
| Attachments | Option attachments | 0 of 4 |
| Graphics | Blend modes | 0 of 7 |
| Graphics | Clipping | 6 of 7 |
| Graphics | Cmyk | 6 of 6 |
| Graphics | Gradients | 8 of 8 |
| Graphics | Images | 10 of 10 |
| Graphics | Output intent | 1 of 3 |
| Graphics | Transparency | 6 of 6 |
| Graphics | Vector output | 10 of 10 |
| Interactive | Buttons | 6 of 7 |
| Interactive | Choice fields | 4 of 4 |
| Interactive | Field flags | 5 of 5 |
| Interactive | Form structure | 5 of 6 |
| Interactive | Text fields | 8 of 8 |
| Metadata | Dates | 2 of 4 |
| Metadata | Info dictionary | 11 of 12 |
| Metadata | Language | 4 of 4 |
| Metadata | Xmp | 1 of 6 |
| Navigation | External links | 12 of 12 |
| Navigation | Internal links | 10 of 10 |
| Navigation | Named destinations | 6 of 6 |
| Navigation | Outline CSS | 10 of 10 |
| Navigation | Outline headings | 10 of 10 |
| Navigation | Outline nesting | 6 of 6 |
| Output | Compression | 1 of 3 |
| Output | Deterministic | 0 of 3 |
| Output | Encryption | 0 of 8 |
| Output | File structure | 2 of 3 |
| Output | Linearization | 0 of 2 |
| Output | Page ranges | 0 of 4 |
| Output | Version | 2 of 5 |
| Page geometry | Bleed trim | 6 of 6 |
| Page geometry | Marks | 5 of 5 |
| Page geometry | Mediabox | 4 of 4 |
| Page geometry | Page labels | 0 of 3 |
| Page geometry | Page size | 17 of 17 |
| Page geometry | Per page size | 3 of 4 |
| Text | Bidi | 4 of 4 |
| Text | Font embedding | 6 of 6 |
| Text | Font subsetting | 4 of 4 |
| Text | Ligatures | 4 of 4 |
| Text | Reading order | 6 of 6 |
| Text | Real text | 5 of 5 |
| Text | Text extraction | 12 of 12 |
| Viewer | Open action | 0 of 5 |
| Viewer | Page layout | 0 of 4 |
| Viewer | Page mode | 0 of 4 |
| Viewer | Viewer preferences | 0 of 8 |