aboutsummaryrefslogtreecommitdiff
path: root/_extensions/ruc-play/stylish-report/README.md
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2025-10-06 10:08:39 +0200
committerJonas Smedegaard <dr@jones.dk>2025-10-06 10:08:39 +0200
commitf3672ff20c7b7d1dccfa8de5f6df78b863d124b5 (patch)
tree896d33e2ffd9c17cbed5e83793c5405dbfb5f31b /_extensions/ruc-play/stylish-report/README.md
parent04f16e64c4fe576a1d94b1ee32ca76b2d2e7d726 (diff)
add initial report structure
Diffstat (limited to '_extensions/ruc-play/stylish-report/README.md')
-rw-r--r--_extensions/ruc-play/stylish-report/README.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/_extensions/ruc-play/stylish-report/README.md b/_extensions/ruc-play/stylish-report/README.md
new file mode 100644
index 0000000..d9ee44d
--- /dev/null
+++ b/_extensions/ruc-play/stylish-report/README.md
@@ -0,0 +1,28 @@
+# Template customizations
+
+This directory contains Pandoc template files
+derived from Quarto version 1.6.40.
+
+## 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"