aboutsummaryrefslogtreecommitdiff
path: root/_extensions
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2025-02-11 13:36:37 +0100
committerJonas Smedegaard <dr@jones.dk>2025-02-11 22:18:37 +0100
commit5f94375136e231aedafb4854d0546951af323f79 (patch)
tree7db9badea9d83049a0b9182289b93d39c73c7fa9 /_extensions
parent32d546c07df2701820c1d96f332cd77fd1d84451 (diff)
add core parts of stylish-report extension
Diffstat (limited to '_extensions')
-rw-r--r--_extensions/ruc-play/stylish-report/README.md28
-rw-r--r--_extensions/ruc-play/stylish-report/TODO.md2
-rw-r--r--_extensions/ruc-play/stylish-report/_extension.yaml65
-rw-r--r--_extensions/ruc-play/stylish-report/revealjs-british.scss10
-rw-r--r--_extensions/ruc-play/stylish-report/revealjs.scss4
-rw-r--r--_extensions/ruc-play/stylish-report/styles/british.scss10
-rw-r--r--_extensions/ruc-play/stylish-report/styles/common.scss4
7 files changed, 123 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"
diff --git a/_extensions/ruc-play/stylish-report/TODO.md b/_extensions/ruc-play/stylish-report/TODO.md
new file mode 100644
index 0000000..6e2de22
--- /dev/null
+++ b/_extensions/ruc-play/stylish-report/TODO.md
@@ -0,0 +1,2 @@
+ * Move `revealjs.scss` below `styles/`
+ when Quarto can resolve font paths for RevealJS from subdir
diff --git a/_extensions/ruc-play/stylish-report/_extension.yaml b/_extensions/ruc-play/stylish-report/_extension.yaml
new file mode 100644
index 0000000..a2f64fd
--- /dev/null
+++ b/_extensions/ruc-play/stylish-report/_extension.yaml
@@ -0,0 +1,65 @@
+name: Stylish-report
+author: Jonas Smedegaard
+version: 0.0.3
+contributes:
+ formats:
+ common:
+ pdf:
+ number-sections: true
+ toc: true
+ default-image-extension: tex
+ colorlinks: true
+ hyperrefoptions:
+ - linktoc=all
+ pdf-engine: lualatex
+ documentclass: scrbook
+ classoption:
+ - DIV=calc
+ - twoside=false
+ csquotes: true
+ papersize: a4
+ fontsize: 12pt
+
+ include-in-header:
+# declare license
+ - text: |
+ \usepackage{hyperref}
+ \usepackage[type={CC}, modifier={by-sa}, version={4.0}]{doclicense}
+ \publishers{\vspace*{\fill}\small\par\doclicenseThis}
+# recalculate page margins, since mainfont was set after documentclass
+ - text: |
+ \KOMAoptions{DIV=last}
+# avoid widow or orphan lines
+ - text: |
+ \usepackage[defaultlines=4,all]{nowidow}
+# implement \abstract
+ - text: |
+ \newenvironment{abstract}
+ {\cleardoublepage\chapter*{Abstract}\thispagestyle{empty}}
+ {\cleardoublepage}
+# use page numbers A1, A2, A3, B1, B2 etc. for appendices
+ - text: |
+ \let\oldchapter\chapter
+ \newcommand*{\appendixmore}{%
+ \setcounter{secnumdepth}{\chapternumdepth}
+ \setcounter{chapter}{0}%
+ \setcounter{section}{0}%
+ \renewcommand{\thechapter}{\Alph{chapter}}%
+ \renewcommand{\theHchapter}{\thechapter}%
+ \renewcommand{\thesection}{\thechapter\arabic{section}}%
+ \renewcommand{\thepage}{\thechapter\arabic{page}}%
+ \renewcommand{\chapter}[1]{%
+ \oldchapter{##1}%
+ \setcounter{page}{1}%
+ }%
+ }
+
+ html:
+ html-q-tags: true
+ theme:
+ light: [flatly, styles/british.scss]
+ dark: [darkly, styles/british.scss]
+
+ revealjs:
+ html-q-tags: true
+ theme: [default, revealjs-british.ccss]
diff --git a/_extensions/ruc-play/stylish-report/revealjs-british.scss b/_extensions/ruc-play/stylish-report/revealjs-british.scss
new file mode 100644
index 0000000..4d41fb3
--- /dev/null
+++ b/_extensions/ruc-play/stylish-report/revealjs-british.scss
@@ -0,0 +1,10 @@
+/*-- scss:mixins --*/
+
+scss @import 'revealjs';
+
+/*-- scss:rules --*/
+
+// use british style quotation
+q {
+ quotes: "‘" "’" "“" "”";
+}
diff --git a/_extensions/ruc-play/stylish-report/revealjs.scss b/_extensions/ruc-play/stylish-report/revealjs.scss
new file mode 100644
index 0000000..2c7c1c8
--- /dev/null
+++ b/_extensions/ruc-play/stylish-report/revealjs.scss
@@ -0,0 +1,4 @@
+/*-- scss:defaults --*/
+
+// avoid web-loading internally declared default Bootswatch font
+$web-font-path: "";
diff --git a/_extensions/ruc-play/stylish-report/styles/british.scss b/_extensions/ruc-play/stylish-report/styles/british.scss
new file mode 100644
index 0000000..613dd3f
--- /dev/null
+++ b/_extensions/ruc-play/stylish-report/styles/british.scss
@@ -0,0 +1,10 @@
+/*-- scss:mixins --*/
+
+scss @import 'common';
+
+/*-- scss:rules --*/
+
+// use british style quotation
+q {
+ quotes: "‘" "’" "“" "”";
+}
diff --git a/_extensions/ruc-play/stylish-report/styles/common.scss b/_extensions/ruc-play/stylish-report/styles/common.scss
new file mode 100644
index 0000000..2c7c1c8
--- /dev/null
+++ b/_extensions/ruc-play/stylish-report/styles/common.scss
@@ -0,0 +1,4 @@
+/*-- scss:defaults --*/
+
+// avoid web-loading internally declared default Bootswatch font
+$web-font-path: "";