diff options
| author | Albert Krewinkel <[email protected]> | 2025-08-05 17:25:42 +0200 |
|---|---|---|
| committer | John MacFarlane <[email protected]> | 2025-08-06 12:48:59 -0700 |
| commit | 3a185fb5d008f8ffb1cc1cb03b805a29df24a2c9 (patch) | |
| tree | 70e284fe29acce3a258b3393e2be89f76e0d96cd /MANUAL.txt | |
| parent | 48e59436ec0cb19bd7ee3966d71af0e41d2debc2 (diff) | |
LaTeX writer: set `pdf-trailer-id` if `SOURCE_DATE_EPOCH` envvar is set
The `SOURCE_DATE_EPOCH` environment variable is used to trigger
reproducible PDF compilation, i.e., PDFs that are identical down to the
byte level for repeated runs.
Closes: #6539
Diffstat (limited to 'MANUAL.txt')
| -rw-r--r-- | MANUAL.txt | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index 1f9f04362..4bd8c9e14 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -3209,6 +3209,16 @@ These variables function when using BibLaTeX for [citation rendering]. `natbiboptions` : list of options for natbib +#### Other + +`pdf-trailer-id` +: the PDF trailer ID; must be two PDF byte strings if set, + conventionally with 16 bytes each. E.g., + `<00112233445566778899aabbccddeeff> + <00112233445566778899aabbccddeeff>`. + + See the section on [reproducible builds]. + [KOMA-Script]: https://ctan.org/pkg/koma-script [LaTeX Font Catalogue]: https://tug.org/FontCatalogue/ [LaTeX font encodings guide]: https://ctan.org/pkg/encguide @@ -7541,6 +7551,11 @@ be taken from it instead of the current time. `SOURCE_DATE_EPOCH` should contain an integer unix timestamp (specifying the number of seconds since midnight UTC January 1, 1970). +For reproducible builds with LaTeX, you can either specify the +`pdf-trailer-id` in the metadata or leave it undefined, in which +case pandoc will create a trailer-id based on a hash of the +`SOURCE_DATE_EPOCH` and the document's contents. + Some document formats also include a unique identifier. For EPUB, this can be set explicitly by setting the `identifier` metadata field (see [EPUB Metadata], above). |