engineering/remarkbox
1
0
Fork 0
Code Issues 3 Pull requests 1 Projects Releases Packages Wiki Activity Actions

feat: side-by-side provenance header (text left, QR right)

Browse source 
Wraps the provenance header in an HTML table so the source/snapshot/
generator block sits left and the QR sits right at the same horizontal
level. Pandoc converts the table cleanly into native table cells across
HTML, PDF (wkhtmltopdf), DOCX, ODT, EPUB.

Without a QR (qr_data_uri=None) we fall back to the plain blockquote.
This commit is contained in:
russell@unturf.com 2026-04-25 16:26:21 -04:00
parent 37350324ea
commit b35c136f7f
No known key found for this signature in database
1 changed files with 23 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

31
remarkbox/lib/provenance.py
View file

@ -93,24 +93,39 @@ def header_md(canonical_uri, snapshot_iso=None, version="dev",
qr_data_uri: Result of `qr_png_data_uri`; if None, no QR rendered.
kind: "thread", "namespace", "subthread" — used in the snapshot caption.
Returns markdown intended to sit at the very top of a document. Pandoc
propagates this verbatim into HTML, then through wkhtmltopdf for PDF.
Returns markdown intended to sit at the very top of a document. When a QR
is present we lay out text on the left and QR on the right via an HTML
table; pandoc converts the table cleanly into HTML, PDF (wkhtmltopdf),
DOCX, ODT, EPUB native table cells. Without a QR we fall back to a plain
blockquote.
"""
if snapshot_iso is None:
snapshot_iso = _utc_now_iso()
lines = [
text_lines = [
"> **Source:** [{}]({}) ".format(canonical_uri, canonical_uri),
"> **Snapshot:** {} ".format(snapshot_iso),
"> **Generator:** Remarkbox `{}` ".format(version),
">",
"> *This is a {} snapshot. The living document lives at the source URI above — it may have been edited, extended, or replied-to since.*".format(kind),
"",
]
if qr_data_uri:
lines.append("![Scan to visit the living source]({})".format(qr_data_uri))
lines.append("")
return "\n".join(lines)
if not qr_data_uri:
return "\n".join(text_lines + [""])
text_block = "\n".join(text_lines)
return (
'<table class="provenance-header" style="border: 0; border-collapse: collapse; margin: 0 0 16px 0; width: 100%;">\n'
'<tr style="border: 0;">\n'
'<td style="border: 0; vertical-align: top; padding: 0 24px 0 0;">\n\n'
'{text}\n\n'
'</td>\n'
'<td style="border: 0; vertical-align: top; width: 160px; text-align: right;">\n\n'
'![Scan to visit the living source]({qr})\n\n'
'</td>\n'
'</tr>\n'
'</table>\n'
).format(text=text_block, qr=qr_data_uri)
def footer_md(canonical_uri, snapshot_iso=None, version="dev"):