diff options
| author | Ralph Amissah <ralph.amissah@gmail.com> | 2026-09-21 00:02:21 -0400 |
|---|---|---|
| committer | Ralph Amissah <ralph.amissah@gmail.com> | 2026-09-22 12:50:33 -0400 |
| commit | 67d27829788d49eab208d871cf4dfc95c5f3ba6e (patch) | |
| tree | 0d19f03b18c1dbf393e5c429de8e45e4397ab1e2 /src/sisudoc/ocda | |
| parent | conf: read conf/document_make, drop the dr_ prefix (diff) | |
epub: dcterms:modified timestamp, reproducibility
timestamp dcterms:modified from the document, not the clock
EPUB3 requires exactly one dcterms:modified on the package
It is now read in order: SOURCE_DATE_EPOCH where the environment sets
it, which is the reproducible-builds convention and lets a build pin
every artefact of one run; then the document's own date.modified; then
date.published. The clock remains the last resort, for a document that
says nothing about when it is from.
A document date is loose markup. "1991", "2006-03" and "2021-12-00" all
occur in the sample set, and a month or day of 00 is not a date. A
missing or zero part becomes 01, and a day out of range for its month
falls back to the first, so what is written is always a valid
CCYY-MM-DDThh:mm:ssZ.
Over the sample set two consecutive runs now produce all 36 epubs byte
identical, and epubcheck reports no change: 0 fatal, 0 errors.
(previously taken from the clock at build time. Two runs over unchanged
markup therefore produced different epub bytes, so no comparison of epub
output could tell a real change from the seconds between two builds. It
also meant an epub was a function of when it was built rather than of
what it was built from.)
(assisted by Claude-Code)
Diffstat (limited to 'src/sisudoc/ocda')
0 files changed, 0 insertions, 0 deletions
