add back a serif math font and document

Author: chrisfenner

Dockerfile

@@ -83,7 +83,8 @@ FROM ${BASE} as build-fonts
 
 RUN apt update && apt install -y \
     wget \
-    xfonts-utils
+    xfonts-utils \
+    xz-utils
 
 # Install Arial via ttf-mscorefonts
 RUN wget http://ftp.us.debian.org/debian/pool/contrib/m/msttcorefonts/ttf-mscorefonts-installer_3.8.1_all.deb
@@ -96,6 +97,12 @@ RUN wget https://github.com/kaienfr/Font/raw/master/font/ARIALUNI.TTF -P /usr/sh
 # Install Noto Sans Mono
 RUN apt install -y fonts-noto
 
+# Install Libertinus Math
+RUN wget https://github.com/alerque/libertinus/releases/download/v7.040/Libertinus-7.040.tar.xz && \
+    tar -xJf Libertinus-7.040.tar.xz && \
+    mkdir -p /usr/share/fonts/OTF/ && \
+    cp Libertinus-7.040/static/OTF/*.otf /usr/share/fonts/OTF/
+
 # Build's done. Copy what we need into the actual container for running.
 FROM ${BASE} as run
 
@@ -109,6 +116,7 @@ COPY --from=build-texlive /texlivebins /usr/local/texlive
 COPY --from=build-fonts \
     /usr/share/fonts/truetype/msttcorefonts/Arial* \
     /usr/share/fonts/TTF/ARIAL* \
+    /usr/share/fonts/OTF/Libertinus* \
     /usr/share/fonts/truetype/noto/NotoSansMono* \
     /usr/share/fonts/
 
@@ -177,7 +185,6 @@ RUN tlmgr update --self && tlmgr install \
     ragged2e \
     selnolig \
     setspace \
-    tex-gyre \
     textpos \
     titling \
     unicode-math \

guide.tcg

@@ -77,6 +77,12 @@ Reach out to <admin@trustedcomputinggroup> with any questions about this documen
 
 # Scope and Purpose
 
+::: Note :::
+This document demonstrates the TCG Pandoc toolset, which automatically adds
+"TCG Confidential" at the bottom of all drafts. This document is itself not TCG
+Confidential because it is a part of an open-source repository.
+::::::::::::
+
 The purpose of this guide is to demonstrate the usage of Markdown-plus-GitHub
 document-authorship flows for TCG workgroup usage.
 
@@ -877,6 +883,14 @@ Use the `.plain` class to avoid drawing any lines or background shading.
 This is useful when you want to present some tabular text without styling it
 like "an actual table".
 
+```md
+: {.plain}
+
+----- -----
+ like this
+----- -----
+```
+
 : {.plain}
 
 ----- -----
@@ -988,16 +1002,24 @@ we recommend using the functions `\mathbf` (for functions) and `\mathit` (for id
 This avoids strange kerning issues where a string is treated as a product of single-character symbols, like in @eq:hmac-iso-bad-kerning:
 
 ```md
-$$ \mathbf{HMAC}(K, \mathit{someTEXT}) \coloneq H((\bar{K} \oplus \mathit{OPAD}) \Vert H((\bar{K} \oplus \mathit{IPAD}) \Vert \mathit{someTEXT})) $$ {#eq:hmac-iso}
+$$ \mathbf{HMAC}(K, \mathit{someTEXT}) \coloneq H((\bar{K} \oplus \mathit{OPAD}) \parallel H((\bar{K} \oplus \mathit{IPAD}) \parallel \mathit{someTEXT})) $$ {#eq:hmac-iso}
 ```
 
-$$ \mathbf{HMAC}(K, \mathit{someTEXT}) \coloneq H((\bar{K} \oplus \mathit{OPAD}) \Vert H((\bar{K} \oplus \mathit{IPAD}) \Vert \mathit{someTEXT})) $$ {#eq:hmac-iso}
+$$ \mathbf{HMAC}(K, \mathit{someTEXT}) \coloneq H((\bar{K} \oplus \mathit{OPAD}) \parallel H((\bar{K} \oplus \mathit{IPAD}) \parallel \mathit{someTEXT})) $$ {#eq:hmac-iso}
+
+```md
+$$ HMAC(K, someTEXT) \coloneq H((\bar{K} \oplus OPAD) \parallel H((\bar{K} \oplus IPAD) \parallel someTEXT)) $$ {#eq:hmac-iso-bad-kerning}
+```
+
+$$ HMAC(K, someTEXT) \coloneq H((\bar{K} \oplus OPAD) \parallel H((\bar{K} \oplus IPAD) \parallel someTEXT)) $$ {#eq:hmac-iso-bad-kerning}
+
+You can use Unicode characters to make equations a little more readable in plain-text:
 
 ```md
-$$ HMAC(K, someTEXT) \coloneq H((\bar{K} \oplus OPAD) \Vert H((\bar{K} \oplus IPAD) \Vert someTEXT)) $$ {#eq:hmac-iso-bad-kerning}
+$$ \mathbf{HMAC}(K, \mathit{someTEXT}) := H((\bar{K} ⊕ \mathit{OPAD}) \parallel H((\bar{K} ⊕ \mathit{IPAD}) \parallel \mathit{someTEXT})) $$ {#eq:hmac-unicode}
 ```
 
-$$ HMAC(K, someTEXT) \coloneq H((\bar{K} \oplus OPAD) \Vert H((\bar{K} \oplus IPAD) \Vert someTEXT)) $$ {#eq:hmac-iso-bad-kerning}
+$$ \mathbf{HMAC}(K, \mathit{someTEXT}) := H((\bar{K} ⊕ \mathit{OPAD}) \parallel H((\bar{K} ⊕ \mathit{IPAD}) \parallel \mathit{someTEXT})) $$ {#eq:hmac-unicode}
 
 # Advanced Features
 

template/tcg.tex

@@ -332,8 +332,8 @@
 \newunicodechar{→}{\textfallback{→}}
 
 \usepackage{unicode-math}
-% \setmathfont{TeX Gyre Schola} % For math mode in equations
-% \setmathrm{TeX Gyre Schola} % For text mode in equations
+\setmathfont{Libertinus Math} % For math mode in equations
+\setmathrm{Libertinus Serif} % For text mode in equations
 
 % Customize the spacing for math to relax it a bit.
 \thinmuskip=6mu