From d6bcc2b413fb0bf3ccd51d5353b728f57604967e Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Tue, 14 May 2024 23:02:24 +0200
Subject: enable tagged PDF, and conform to PDF/A-2b spec

---
 _TODO.md                 |  3 ---
 _article.yml             |  2 ++
 _templates/README.md     | 28 ++++++++++++++++++++++++++++
 _templates/doc-class.tex |  1 +
 4 files changed, 31 insertions(+), 3 deletions(-)
 create mode 100644 _templates/README.md

diff --git a/_TODO.md b/_TODO.md
index 9be5c9b..49588ad 100644
--- a/_TODO.md
+++ b/_TODO.md
@@ -143,9 +143,6 @@ auxiliary metadata:
 
   * maybe render with ConTeXt engine for richer PDF metadata
     <https://pandoc.de/#tip-082-untitled>
-  * generate PDF/A compliant PDF files
-    <https://www.aalto.fi/en/services/creating-a-pdfa-compliant-file-of-your-thesis>
-    <https://tex.stackexchange.com/a/655531/309738>
   * support adding DOI to XMP metadata
     <https://www.crossref.org/blog/marking-up-doi/>
   * maybe tweak PDF tagging
diff --git a/_article.yml b/_article.yml
index 6a17ef9..5a10e49 100644
--- a/_article.yml
+++ b/_article.yml
@@ -10,6 +10,8 @@ format:
     csquotes: true
     papersize: a4
     fontsize: 12pt
+    template-partials:
+      - ../_templates/doc-class.tex
 
     include-in-header:
 # recalculate page margins, since mainfont was set after documentclass
diff --git a/_templates/README.md b/_templates/README.md
new file mode 100644
index 0000000..fa966b5
--- /dev/null
+++ b/_templates/README.md
@@ -0,0 +1,28 @@
+# Template customizations
+
+This directory contains Pandoc template files
+derived from Quarto version 1.4.549.
+
+## Tagged PDF/A
+
+The PDF workflow is tweaked to embed semantically structured metadata,
+a.k.a. [tagged PDF] files,
+which conforms to the [PDF/A-2b] standard,
+using experimental LaTeX hint
+[`\DocumentMetadata` declaration][DocumentMetadata].
+
+PDF/A comes in multiple flavors.
+[Some guidelines] advice to use the 2b flavor,
+so that is what is currently done.
+
+[tagged PDF]: https://taggedpdf.com/
+  "tagged PDF - PDF containing semantically structured metadata"
+
+[PDF/A-2b]: https://pdfa.org/pdfa-faq/
+  "PDF/A - PDF standards for archiving and long-term preservation"
+
+[DocumentMetadata]: https://ctan.org/pkg/latex-lab
+  "DocumentMetadata - LaTeX hint for generating modern tagged PDF"
+
+[Some guidelines] https://www.aalto.fi/en/services/creating-a-pdfa-compliant-file-of-your-thesis
+  "Aalto guide to creating a PDF/A -compliant file of your thesis"
diff --git a/_templates/doc-class.tex b/_templates/doc-class.tex
index b9c942e..19f9c04 100644
--- a/_templates/doc-class.tex
+++ b/_templates/doc-class.tex
@@ -2,6 +2,7 @@
 $if(lang)$
   lang={$lang$},
 $endif$
+pdfstandard=A-2b,
 }
 \documentclass[
 $if(fontsize)$
-- 
cgit v1.2.3