Tools/build pdfs only when needed

.github/workflows/nodejs.yml

@@ -1,6 +1,7 @@
 name: Node CI
 
-on: push
+on: 
+  push:
 
 jobs:
   build:
@@ -24,11 +25,17 @@ jobs:
       - name: Build docs
         run: |
           npm ci
-          npm run build --if-present
+          npm run build
           git config user.name ${GITHUB_ACTOR}
           git config user.email ${PUSHER_EMAIL}
           git add docs/*/*.html docs/*/*.md docs/*/styles/*
-          git diff-index --quiet HEAD docs/*/*.html docs/*/*.md docs/*/styles/* || (npm run pdf --if-present && git add docs/*/*.pdf && git commit -m "auto-refreshed")
-          test `git branch --show-current` && git push
+          for dir in docs/*/ # list directories in the form "docs/dirname/"
+          do
+              doc=${dir%/}   # remove the trailing "/"
+              doc=${doc##*/} # retain everything after the final "/"
+              git diff-index --quiet HEAD $dir/*.html $dir/styles/* || npm run pdf $doc
+          done
+          git add docs/*/*.pdf
+          git diff-index --quiet HEAD docs/* || ( git commit -m "auto-refreshed" && git push )
         env:
           PUSHER_EMAIL: ${{ github.event.pusher.email }}

docs/odata-url-conventions/odata-url-conventions.html

@@ -4,7 +4,7 @@
   <meta charset="utf-8" />
   <meta name="generator" content="pandoc" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
-  <title>OData Version 4.01. Part 2: URL Conventions</title>
+  <title>OData Version 4.02. Part 2: URL Conventions</title>
   <style>
     code{white-space: pre-wrap;}
     span.smallcaps{font-variant: small-caps;}
@@ -32,7 +32,7 @@
 <h1 id="odata-version-402-part-2-url-conventions">OData Version 4.02. Part 2: URL Conventions</h1>
 <h2 id="committee-specification-draft-01">Committee Specification Draft 01</h2>
 <h2 id="14-july-2023">14 July 2023</h2>
-<p> </p>
+<p><span class="math inline">\(\hbox{}\)</span></p>
 <h4 id="this-stage">This stage:</h4>
 <p><a href="https://docs.oasis-open.org/odata/odata/v4.02/csd01/odata-v4.02-csd01-part2-url-conventions.md">https://docs.oasis-open.org/odata/odata/v4.02/csd01/odata-v4.02-csd01-part2-url-conventions.md</a> (Authoritative)<br />
 <a href="https://docs.oasis-open.org/odata/odata/v4.02/csd01/odata-v4.02-csd01-part2-url-conventions.html">https://docs.oasis-open.org/odata/odata/v4.02/csd01/odata-v4.02-csd01-part2-url-conventions.html</a><br />
@@ -143,7 +143,7 @@ <h3 id="123-document-conventions"><a name="Documentconventions" href="#Documentc
        --mathjax
        --eol=lf
        --wrap=none
-       --metadata pagetitle=&quot;OData Version 4.01. Part 2: URL Conventions&quot;
+       --metadata pagetitle=&quot;OData Version 4.02. Part 2: URL Conventions&quot;
        odata-v4.02-csd01-part2-url-conventions.md</code></pre>
 <p>This uses pandoc 3.1.2 from <a href="https://github.com/jgm/pandoc/releases/tag/3.1.2">https://github.com/jgm/pandoc/releases/tag/3.1.2</a>.</p>
 </div>

docs/odata-url-conventions/odata-url-conventions.md

@@ -9,7 +9,7 @@
 
 ## 14 July 2023
 
- 
+$\hbox{}$
 
 #### This stage:
 https://docs.oasis-open.org/odata/odata/v4.02/csd01/odata-v4.02-csd01-part2-url-conventions.md (Authoritative) \
@@ -154,7 +154,7 @@ pandoc -f gfm+tex_math_dollars+fenced_divs
        --mathjax
        --eol=lf
        --wrap=none
-       --metadata pagetitle="OData Version 4.01. Part 2: URL Conventions"
+       --metadata pagetitle="OData Version 4.02. Part 2: URL Conventions"
        odata-v4.02-csd01-part2-url-conventions.md
 ```
 

lib/build-pdf.js

@@ -1,13 +1,20 @@
 const iterator = require("./iterator");
 const pdf = require("./pdf.js");
 
+const doc = process.argv[2];
+
 iterator(function (srcname, name, variant, meta) {
-  pdf(name, variant, meta)
+  if (doc && doc !== name) return;
+  pdf(name, variant, meta, doc === name)
     .then((refreshed) => {
-      console.log(refreshed ? "✓" : "=", srcname, variant);
+      console.log(
+        refreshed ? "✓" : "=",
+        srcname,
+        variant === "meta" ? "" : variant
+      );
     })
     .catch((error) => {
-      console.log("❌", srcname, variant);
+      console.log("❌", srcname, variant === "meta" ? "" : variant);
       console.error(error);
       process.exitCode = 1;
     });

odata-url-conventions/0 frontmatter.md

@@ -3,13 +3,13 @@
 
 -------
 
-# OData Version 4.02. Part 2: URL Conventions
+# $$$pagetitle$$$
 
-## Committee Specification Draft 01
+## $$$subtitle$$$
 
 ## 14 July 2023
 
- 
+$\hbox{}$
 
 #### This stage:
 https://docs.oasis-open.org/odata/odata/v4.02/$$$stage$$$/$$$filename$$$.md (Authoritative) \

odata-url-conventions/meta.yaml

@@ -1,4 +1,4 @@
-pagetitle: 'OData Version 4.01. Part 2: URL Conventions'
+pagetitle: 'OData Version 4.02. Part 2: URL Conventions'
 subtitle: Committee Specification Draft 01
 filename: odata-v4.02-csd01-part2-url-conventions
 stage: csd01