From 516db90cdcc1287a40260090db8be5dae2933de7 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sat, 6 Sep 2025 19:38:44 +0200
Subject: [PATCH 01/14] assets/sass: use correct filename suffix

The files in `assets/sass` are written in SCSS, not plain CSS. Therefore
they should have the `.scss` suffix, not `.css`.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/sass/{dark-mode.css => dark-mode.scss}       | 0
 assets/sass/{git-turns-20.css => git-turns-20.scss} | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename assets/sass/{dark-mode.css => dark-mode.scss} (100%)
 rename assets/sass/{git-turns-20.css => git-turns-20.scss} (100%)

diff --git a/assets/sass/dark-mode.css b/assets/sass/dark-mode.scss
similarity index 100%
rename from assets/sass/dark-mode.css
rename to assets/sass/dark-mode.scss
diff --git a/assets/sass/git-turns-20.css b/assets/sass/git-turns-20.scss
similarity index 100%
rename from assets/sass/git-turns-20.css
rename to assets/sass/git-turns-20.scss

From 46e1a99073c7214e4abe1308c0ad2d0f4a6c3ec9 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sat, 6 Sep 2025 19:48:32 +0200
Subject: [PATCH 02/14] Add a print-specific style sheet

It would appear that the navigation bar is already suppressed when
printing, thanks to being inside an `<aside>` element. Other elements
that are not useful in print, such as the search box, the version
selector, the dark mode toggle, and the "Edit this page" link are
now also hidden when printing.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/sass/application.scss |  1 +
 assets/sass/print.scss       | 28 ++++++++++++++++++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 assets/sass/print.scss

diff --git a/assets/sass/application.scss b/assets/sass/application.scss
index 6d28510499..347fbaf9da 100644
--- a/assets/sass/application.scss
+++ b/assets/sass/application.scss
@@ -30,6 +30,7 @@ $baseurl: "{{ .Site.BaseURL }}{{ if (and (ne .Site.BaseURL "/") (ne .Site.BaseUR
 @import 'cheat-sheet';
 @import 'dark-mode';
 @import 'git-turns-20';
+@import 'print';
 
 code {
   display: inline;
diff --git a/assets/sass/print.scss b/assets/sass/print.scss
new file mode 100644
index 0000000000..7e4101eb55
--- /dev/null
+++ b/assets/sass/print.scss
@@ -0,0 +1,28 @@
+@media print {
+  .inner {
+    // The `position` of the `inner` class is defined as `relative`, which
+    // causes funny issues when printing, for example tens of empty pages in
+    // the middle. Let's suppress that.
+    position: inherit;
+
+    width: inherit;
+    margin-bottom: 0;
+  }
+
+  #main {
+    margin-bottom: 0;
+  }
+
+  footer {
+    padding: 0;
+    margin-top: 0;
+  }
+
+  aside, .sidebar-btn, #search-container, #reference-version, #dark-mode-button, .site-source {
+    display: none;
+  }
+
+  section {
+    break-inside: avoid-page;
+  }
+}
\ No newline at end of file

From 1e46d9b20c12e4de2b1659461f5c49d01dbabab5 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sat, 6 Sep 2025 23:39:49 +0200
Subject: [PATCH 03/14] print: handle rounded borders correctly with multiple
 pages

When the `<div id="main">`, which has rounded borders, is broken apart
because the content does not fit onto a single page, the rounded borders
were cut off at page breaks. Let's just close them, so that each page
gets its own box with rounded borders.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/sass/print.scss | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/assets/sass/print.scss b/assets/sass/print.scss
index 7e4101eb55..61ff6d5f59 100644
--- a/assets/sass/print.scss
+++ b/assets/sass/print.scss
@@ -25,4 +25,8 @@
   section {
     break-inside: avoid-page;
   }
+
+  div#main {
+    box-decoration-break: clone;
+  }
 }
\ No newline at end of file

From fc03d14dd25ad3e37717b083dcdc5a882bf94257 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sat, 6 Sep 2025 23:43:40 +0200
Subject: [PATCH 04/14] Show a different tagline for print media

The taglines are a little fun thing to have, but in printouts, they
cannot change all the time, so let's have a fixed one there.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/js/application.js | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/assets/js/application.js b/assets/js/application.js
index 6e4eb41f6f..e97c4e6d62 100644
--- a/assets/js/application.js
+++ b/assets/js/application.js
@@ -37,6 +37,7 @@ $(document).ready(function() {
   Downloads.init();
   DownloadBox.init();
   PostelizeAnchor.init();
+  Print.init();
 });
 
 function onPopState(fn) {
@@ -807,3 +808,24 @@ var Graphviz = {
     });
   }
 }
+
+var Print = {
+  init: function() {
+    Print.tagline = $("#tagline");
+    Print.scrollToTop = $("#scrollToTop");
+    window.matchMedia("print").addListener((mediaQueryList) => {
+      Print.toggle(mediaQueryList.matches);
+    });
+  },
+  toggle: function(enable) {
+    if (enable) {
+      Print.taglineBackup = Print.tagline.html();
+      Print.tagline.html("--print-out");
+      Print.scrollToTopDisplay = Print.scrollToTop.attr("display");
+      Print.scrollToTop.attr("display", "none");
+    } else {
+      Print.tagline.html(Print.taglineBackup || "--as-git-as-it-gets");
+      Print.scrollToTop.attr("display", Print.scrollToTopDisplay);
+    }
+  }
+}

From bf57087e2845b29ab66415a2c27bd58da0acb658 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sat, 6 Sep 2025 23:44:46 +0200
Subject: [PATCH 05/14] Hide the dark mode button when printing

The dark mode button makes no sense in a printed document.

This change is slightly tricky because we used to hide the dark button
by default and only showed it when the JavaScript initialization ran
as expected, by setting the CSS `display` property to `block`.

However, doing that also meant that the `display` property could not be
overridden by a `@media print` block, because the `display` property was
set on the dark mode button itself, and would therefore always be more
specific than the `@media print` rule.

So let's instead use a CSS class to indicate whether the dark mode button
should be shown or not.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/js/application.js     | 2 +-
 assets/sass/application.scss | 4 ++++
 assets/sass/print.scss       | 4 ++++
 3 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/assets/js/application.js b/assets/js/application.js
index e97c4e6d62..ed83e31d31 100644
--- a/assets/js/application.js
+++ b/assets/js/application.js
@@ -651,7 +651,7 @@ var DarkMode = {
         || (!prefersDarkScheme && currentTheme === "dark")) {
       button.attr("src", `${baseURLPrefix}images/light-mode.svg`);
     }
-    button.css("display", "block");
+    button.addClass('active');
 
     button.on('click', function(e) {
       e.preventDefault();
diff --git a/assets/sass/application.scss b/assets/sass/application.scss
index 347fbaf9da..a1d8d2481e 100644
--- a/assets/sass/application.scss
+++ b/assets/sass/application.scss
@@ -64,3 +64,7 @@ pre {
     align-self: center;
     margin: 5px;
 }
+
+#dark-mode-button.active {
+  display: block;
+}
diff --git a/assets/sass/print.scss b/assets/sass/print.scss
index 61ff6d5f59..b868e08cd1 100644
--- a/assets/sass/print.scss
+++ b/assets/sass/print.scss
@@ -29,4 +29,8 @@
   div#main {
     box-decoration-break: clone;
   }
+
+  #dark-mode-button {
+    display: none !important;
+  }
 }
\ No newline at end of file

From 3ab9b568c0009672bfd23a2e19b6ec6912f338d4 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Mon, 15 Sep 2025 12:50:36 +0200
Subject: [PATCH 06/14] Cheat Sheet: define font sizes relative to container,
 not root

This allows overriding the font sizes for the Cheat Sheet specifically
when printing.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/sass/cheat-sheet.scss | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/assets/sass/cheat-sheet.scss b/assets/sass/cheat-sheet.scss
index 018309a5cf..f430400343 100644
--- a/assets/sass/cheat-sheet.scss
+++ b/assets/sass/cheat-sheet.scss
@@ -9,19 +9,19 @@
     border-radius: 10px;
     border: 1px solid var(--callout-color);
     display: flex;
-    font-size: 1rem;
+    font-size: 1em;
     flex-direction: column;
     gap: 5px;
 
     p {
-      font-size: 1rem;
+      font-size: 1em;
       margin: 0 8px;
     }
 
     h3 {
       color: var(--font-color);
       line-height: 1em;
-      font-size: 1.1rem;
+      font-size: 1.1em;
       margin-bottom: 8px;
       font-weight: 500;
     }
@@ -71,7 +71,7 @@
       grid-column: 1/3;
 
       margin-top: 0;
-      font-size: 1.2rem;
+      font-size: 1.2em;
       font-weight: 700;
       line-height: 1.2;
       color: var(--orange);

From da54cb733417f16ba89942871b2d52a100b3b147 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Mon, 15 Sep 2025 14:31:15 +0200
Subject: [PATCH 07/14] cheat-sheet: adjust the print style-sheet

The intention is to print this in landscape mode, to imitate
https://jvns.ca/blog/2024/04/25/new-zine--how-git-works-/#the-cheat-sheet
better.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/sass/print.scss | 104 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)

diff --git a/assets/sass/print.scss b/assets/sass/print.scss
index b868e08cd1..e86b9dc2da 100644
--- a/assets/sass/print.scss
+++ b/assets/sass/print.scss
@@ -11,6 +11,15 @@
 
   #main {
     margin-bottom: 0;
+
+    /* Improve readability */
+    line-height: 1.4;
+    text-align: justify;
+
+    /* Ensure it uses full page width */
+    width: 100%;
+    border: none;
+    padding: 0;
   }
 
   footer {
@@ -33,4 +42,99 @@
   #dark-mode-button {
     display: none !important;
   }
+
+  .cheat-sheet {
+    font-size: 8pt;
+
+    section {
+      border: 1px solid black;
+      display: block;
+      gap: 0;
+      margin-bottom: 0;
+
+      .item {
+        background: none;
+        border: none;
+
+        h3 {
+          margin-bottom: 0;
+        }
+
+        code {
+          background: none;
+          line-height: inherit;
+          padding: 1px;
+        }
+      }
+    }
+    .commit-reference {
+      background: none;
+      border-left: 0.5px;
+
+      dl {
+        gap: inherit;
+
+        dt,dt::before,dd {
+          line-height: inherit;
+          font-size: 0.7em !important;
+        }
+      }
+    }
+
+    p {
+      font-size: inherit;
+      line-height: inherit;
+      margin: 1px;
+    }
+  }
+}
+
+@media print and (min-width: 231mm) {
+  div#content {
+    width: 297mm;
+  }
+
+  header {
+    padding: 0;
+    #logo img {
+      max-height: 23px;
+      width: auto;
+      height: auto;
+    }
+  }
+
+  /* landscape orientation */
+  @page {
+    size: A4 landscape;
+    width: 297mm;
+    height: 210mm;
+    margin: 1cm;
+  }
+
+  .cheat-sheet {
+    /* Multi-column layout */
+    column-count: 6;
+    column-gap: 1em;
+
+    h1 {
+      column-span: all;
+      position: absolute;
+      top: -10px;
+      width: 100%;
+      font-size: 16px;
+      text-align: center;
+    }
+
+    div.item {
+      display: block;
+      width: 100%;
+      padding: 1px;
+      margin-bottom: 1px;
+      break-inside: avoid;
+
+      label {
+        margin-top: 2px;
+      }
+    }
+  }
 }
\ No newline at end of file

From 10264d47dba1392ea00a019d7b6bc7048d249368 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sat, 6 Sep 2025 23:48:17 +0200
Subject: [PATCH 08/14] Add a script to convert HTML to PDF

This could be used, for example, to render a PDF version of the shiny
new Git Cheat Sheet.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 script/html-to-pdf.js | 53 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 script/html-to-pdf.js

diff --git a/script/html-to-pdf.js b/script/html-to-pdf.js
new file mode 100644
index 0000000000..82d6228b22
--- /dev/null
+++ b/script/html-to-pdf.js
@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+const fs = require('fs')
+const path = require('path')
+const url = require('url')
+const { chromium } = require('playwright')
+
+const htmlToPDF = async (htmlPath, options) => {
+  if (!htmlPath.endsWith('.html')) {
+    throw new Error(`Input file must have the '.html' extension: ${htmlPath}`)
+  }
+  if (!fs.existsSync(htmlPath)) {
+    throw new Error(`Input file does not exist: ${htmlPath}`)
+  }
+  const outputPath = htmlPath.replace(/\.html$/, '.pdf')
+  if (!options.force && fs.existsSync(outputPath)) {
+    throw new Error(`Output file already exists: ${outputPath}`)
+  }
+
+  const browser = await chromium.launch({ channel: 'chrome' })
+  const page = await browser.newPage()
+
+  const htmlPathURL = url.pathToFileURL(htmlPath).toString()
+
+  console.log(`Processing ${htmlPathURL}...`)
+  await page.goto(htmlPathURL, { waitUntil: 'load' })
+
+  await page.pdf({
+    path: outputPath,
+    format: 'A4',
+    landscape: true,
+    margin: { top: '0cm', bottom: '0cm', left: '0cm', right: '0cm' },
+  })
+  await browser.close()
+}
+
+const args = process.argv.slice(2)
+const options = {}
+while (args?.[0].startsWith('-')) {
+  const arg = args.shift()
+  if (arg === '--force' || arg === '-f') options.force = true
+  else throw new Error(`Unknown argument: ${arg}`)
+}
+
+if (args.length !== 1) {
+  process.stderr.write('Usage: html-to-pdf.js [--force] <input-file.html>\n')
+  process.exit(1)
+}
+
+htmlToPDF(args[0], options).catch(e => {
+  process.stderr.write(`${e.stack}\n`)
+  process.exit(1)
+})

From 67b1ad4ee9388db28085d991f75f9bd883cb3b76 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sun, 7 Sep 2025 00:21:43 +0200
Subject: [PATCH 09/14] html-to-pdf: optionally insert PDF link

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 assets/sass/print.scss |  7 ++++++-
 script/html-to-pdf.js  | 22 +++++++++++++++++++++-
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/assets/sass/print.scss b/assets/sass/print.scss
index e86b9dc2da..23ca55959c 100644
--- a/assets/sass/print.scss
+++ b/assets/sass/print.scss
@@ -39,7 +39,7 @@
     box-decoration-break: clone;
   }
 
-  #dark-mode-button {
+  .pdf-link, #dark-mode-button {
     display: none !important;
   }
 
@@ -137,4 +137,9 @@
       }
     }
   }
+}
+
+div#main .pdf-link img {
+  float: right;
+  height: 36px;
 }
\ No newline at end of file
diff --git a/script/html-to-pdf.js b/script/html-to-pdf.js
index 82d6228b22..ad452838ac 100644
--- a/script/html-to-pdf.js
+++ b/script/html-to-pdf.js
@@ -5,6 +5,23 @@ const path = require('path')
 const url = require('url')
 const { chromium } = require('playwright')
 
+const insertPDFLink = (htmlPath) => {
+  const html = fs.readFileSync(htmlPath, 'utf-8')
+  if (html.includes('class="pdf-link"')) {
+    return
+  }
+  // get baseURL prefix via the `favicon.ico` link, it's in the top-level directory
+  const match = html.match(/<link href="(.*?)favicon\.ico"/)
+  if (!match) throw new Error('Failed to determine baseURL prefix from favicon.ico link')
+  const img = `<img src="${match[1].replace(/\/$/, '')}/images/pdf.png" />`
+  const updatedHtml = html.replace(
+    /<h1/,
+    `<a class="pdf-link" href="${path.basename(htmlPath, '.html')}.pdf">${img}</a>$&`
+  )
+  if (updatedHtml === html) throw new Error('Failed to insert PDF link, no <h1> found')
+  fs.writeFileSync(htmlPath, updatedHtml, 'utf-8')
+}
+
 const htmlToPDF = async (htmlPath, options) => {
   if (!htmlPath.endsWith('.html')) {
     throw new Error(`Input file must have the '.html' extension: ${htmlPath}`)
@@ -32,6 +49,8 @@ const htmlToPDF = async (htmlPath, options) => {
     margin: { top: '0cm', bottom: '0cm', left: '0cm', right: '0cm' },
   })
   await browser.close()
+
+  if (options.insertPDFLink) insertPDFLink(htmlPath)
 }
 
 const args = process.argv.slice(2)
@@ -39,11 +58,12 @@ const options = {}
 while (args?.[0].startsWith('-')) {
   const arg = args.shift()
   if (arg === '--force' || arg === '-f') options.force = true
+  else if (arg === '--insert-pdf-link' || arg === '-i') options.insertPDFLink = true
   else throw new Error(`Unknown argument: ${arg}`)
 }
 
 if (args.length !== 1) {
-  process.stderr.write('Usage: html-to-pdf.js [--force] <input-file.html>\n')
+  process.stderr.write('Usage: html-to-pdf.js [--force] [--insert-pdf-link] <input-file.html>\n')
   process.exit(1)
 }
 

From 498ebe47c9acab90d949c325c4cca2503b0a0f01 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sun, 7 Sep 2025 21:45:52 +0200
Subject: [PATCH 10/14] html-to-pdf: deal with HUGO_RELATIVEURLS=false

When Hugo is told to use absolute URLs, it generates links and image
references that start with a slash, which are misinterpreted when
loading the file into a browser via the file: protocol. Rewrite
those URLs to point to the local filesystem.

To do so, we use the very convenient `page.route()` functionality of
Playwright. Unfortunately, we do not get the "URLs" that start with a
slash, but instead we get bogus `file:///<wrong-path>` URLs. Luckily,
those wrong paths do not start with the absolute path of the `public/`
directory, that's what we can use as tell-tale that an incorrect URL
needs rewriting.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 script/html-to-pdf.js | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/script/html-to-pdf.js b/script/html-to-pdf.js
index ad452838ac..1f6ab149e5 100644
--- a/script/html-to-pdf.js
+++ b/script/html-to-pdf.js
@@ -38,8 +38,23 @@ const htmlToPDF = async (htmlPath, options) => {
   const page = await browser.newPage()
 
   const htmlPathURL = url.pathToFileURL(htmlPath).toString()
-
   console.log(`Processing ${htmlPathURL}...`)
+
+  // Work around HUGO_RELATIVEURLS=false by rewriting the absolute URLs
+  const baseURLPrefix = htmlPathURL.substring(0, htmlPathURL.lastIndexOf('/public/') + 8)
+  await page.route(/^file:\/\//, async (route, req) => {
+    // This _will_ be a correct URL when deployed to https://whatevers/, but
+    // this script runs before deployment, on a file:/// URL, where we need to
+    // be a bit clever to give the browser the file it needs.
+    const original = req.url()
+    const url =
+      original.startsWith(baseURLPrefix)
+        ? original
+        : original.replace(/^file:\/\/\/([A-Za-z]:\/)?(git-scm\.com\/)?/, baseURLPrefix)
+    if (url !== original) console.error(`::notice::Rewrote ${original} to ${url}`)
+    await route.continue({ url })
+  })
+
   await page.goto(htmlPathURL, { waitUntil: 'load' })
 
   await page.pdf({

From a760a01a488dc80f29169f2e4c15181cd6329bb5 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sun, 7 Sep 2025 22:39:20 +0200
Subject: [PATCH 11/14] html-to-pdf: work around minified
 `application.{css,js}`

When Hugo minifies resources, it attaches an `integrity` attribute. This
is usually very good! However, when we're trying to generate a `.pdf`
from a HTML file that contains hrefs that contain absolute paths, as we
do when deploying to GitHub Pages, we have to work around that by
re-routing the files. Combined with an `integrity` attribute, this will
fail, and there is no way around it other than editing out that
attribute.

So let's do just that.

Hacky, but works, and we can proceed activities that are substantially
more fun than battling well-intentioned-but-sometimes-really-unhelpful
security measures without escape hatches (there is no way to tell
Chromium that yes, this is intentional, but we need to ignore those
integrity checks in this context, thank you for your cooperation).

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 script/html-to-pdf.js | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/script/html-to-pdf.js b/script/html-to-pdf.js
index 1f6ab149e5..334a14eeb5 100644
--- a/script/html-to-pdf.js
+++ b/script/html-to-pdf.js
@@ -47,6 +47,19 @@ const htmlToPDF = async (htmlPath, options) => {
     // this script runs before deployment, on a file:/// URL, where we need to
     // be a bit clever to give the browser the file it needs.
     const original = req.url()
+    if (original === htmlPathURL) {
+      // Work around rerouted `.css` and `.js` files... Symptom: "has an
+      // integrity attribute, but the resource requires the request to be CORS
+      // enabled to check the integrity, and it is not. The resource has been
+      // blocked because the integrity cannot be enforced."
+      const body =
+        fs.readFileSync(htmlPath, "utf-8")
+	  // strip out the `integrity="sha256-..."` attributes
+          .replace(/(\/application\.[^"/]+") integrity="sha256-[^"]+"/g, "$1")
+      await route.fulfill({ headers: { "Content-Type": "text/html" }, body })
+      return
+    }
+
     const url =
       original.startsWith(baseURLPrefix)
         ? original

From 96253affe7192b5a1e7af5e70b2867c9b82eae79 Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Tue, 16 Sep 2025 15:30:40 +0200
Subject: [PATCH 12/14] html-to-pdf: optionally start Chromium with DevTools

This comes in _real_ handy for debugging.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 script/html-to-pdf.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/script/html-to-pdf.js b/script/html-to-pdf.js
index 334a14eeb5..6ba1707fcc 100644
--- a/script/html-to-pdf.js
+++ b/script/html-to-pdf.js
@@ -34,7 +34,7 @@ const htmlToPDF = async (htmlPath, options) => {
     throw new Error(`Output file already exists: ${outputPath}`)
   }
 
-  const browser = await chromium.launch({ channel: 'chrome' })
+  const browser = await chromium.launch({ channel: 'chrome', ...(options.devtools ? { devtools: true } : {}) })
   const page = await browser.newPage()
 
   const htmlPathURL = url.pathToFileURL(htmlPath).toString()
@@ -76,6 +76,7 @@ const htmlToPDF = async (htmlPath, options) => {
     landscape: true,
     margin: { top: '0cm', bottom: '0cm', left: '0cm', right: '0cm' },
   })
+  if (options.devtools) await new Promise((resolve) => { setTimeout(resolve, 5 * 60 * 1000) })
   await browser.close()
 
   if (options.insertPDFLink) insertPDFLink(htmlPath)
@@ -87,6 +88,7 @@ while (args?.[0].startsWith('-')) {
   const arg = args.shift()
   if (arg === '--force' || arg === '-f') options.force = true
   else if (arg === '--insert-pdf-link' || arg === '-i') options.insertPDFLink = true
+  else if (arg === '--devtools' || arg === '-d') options.devtools = true
   else throw new Error(`Unknown argument: ${arg}`)
 }
 

From 98628ba5cc26b7a4bdc643e1fec8a4a1a837436b Mon Sep 17 00:00:00 2001
From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sun, 7 Sep 2025 00:41:56 +0200
Subject: [PATCH 13/14] deploy/ci: render the cheat sheet as PDF and offer a
 link to it

The Cheat Sheet is quite useful, people might want to print it out...

Suggested-by: Scott Chacon <schacon@gmail.com>
Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 .github/actions/deploy-to-github-pages/action.yml | 6 ++++++
 .github/workflows/ci.yml                          | 7 +++++--
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/.github/actions/deploy-to-github-pages/action.yml b/.github/actions/deploy-to-github-pages/action.yml
index 67230be8cd..1117a47737 100644
--- a/.github/actions/deploy-to-github-pages/action.yml
+++ b/.github/actions/deploy-to-github-pages/action.yml
@@ -88,6 +88,12 @@ runs:
         npm install node-html-parser &&
         node ./script/graphviz-ssr.js
 
+    - name: offer PDF version of the cheat sheet
+      shell: bash
+      run: |
+        npm install @playwright/test &&
+        node script/html-to-pdf.js -i public/cheat-sheet.html
+
     - name: run Pagefind ${{ env.PAGEFIND_VERSION }} to build the search index
       shell: bash
       run: npx -y pagefind@${{ env.PAGEFIND_VERSION }} --site public --write-playground
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7df82cbc3d..86d6156e29 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -38,6 +38,11 @@ jobs:
         npm install node-html-parser &&
         node ./script/graphviz-ssr.js
 
+    - name: Install @playwright/test
+      run: npm install @playwright/test
+    - name: offer PDF version of the cheat sheet
+      run: node script/html-to-pdf.js -i public/cheat-sheet.html
+
     - name: run Pagefind ${{ env.PAGEFIND_VERSION }} to build the search index
       run: npx -y pagefind@${{ env.PAGEFIND_VERSION }} --site public --write-playground
 
@@ -83,8 +88,6 @@ jobs:
         output: lychee.md
         jobSummary: true
 
-    - name: Install @playwright/test
-      run: npm install @playwright/test
     - name: Run Playwright tests
       id: playwright
       env:

From 70d379fa5b98d2f40c325d65e7d8da8717bfafe9 Mon Sep 17 00:00:00 2001
From: Julia Evans <julia@jvns.ca>
Date: Tue, 30 Sep 2025 13:55:21 -0400
Subject: [PATCH 14/14] html-to-pdf: put the cheat sheet on 2 pages

---
 assets/sass/print.scss          | 20 ++++++++++++++------
 content/cheat-sheet/_index.html | 12 ++++++------
 2 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/assets/sass/print.scss b/assets/sass/print.scss
index 23ca55959c..2e6152c13a 100644
--- a/assets/sass/print.scss
+++ b/assets/sass/print.scss
@@ -23,8 +23,7 @@
   }
 
   footer {
-    padding: 0;
-    margin-top: 0;
+    display: none;
   }
 
   aside, .sidebar-btn, #search-container, #reference-version, #dark-mode-button, .site-source {
@@ -50,7 +49,8 @@
       border: 1px solid black;
       display: block;
       gap: 0;
-      margin-bottom: 0;
+      margin-bottom: 8px;
+      padding: 8px;
 
       .item {
         background: none;
@@ -64,12 +64,14 @@
           background: none;
           line-height: inherit;
           padding: 1px;
+          display: block;
+          margin-bottom: 2px;
         }
       }
     }
     .commit-reference {
       background: none;
-      border-left: 0.5px;
+      border-left: 1px solid black;
 
       dl {
         gap: inherit;
@@ -113,8 +115,9 @@
 
   .cheat-sheet {
     /* Multi-column layout */
-    column-count: 6;
+    column-count: 4;
     column-gap: 1em;
+    margin-top: 20px;
 
     h1 {
       column-span: all;
@@ -136,10 +139,15 @@
         margin-top: 2px;
       }
     }
+
+    /* Manual column break controls */
+    .print-break-before {
+      break-before: column;
+    }
   }
 }
 
 div#main .pdf-link img {
   float: right;
   height: 36px;
-}
\ No newline at end of file
+}
diff --git a/content/cheat-sheet/_index.html b/content/cheat-sheet/_index.html
index 71428d3dda..83d3a58df5 100644
--- a/content/cheat-sheet/_index.html
+++ b/content/cheat-sheet/_index.html
@@ -113,7 +113,7 @@ <h3>Commit all unstaged changes:</h3>
     </div>
   </section>
 
-  <section>
+  <section class="print-break-before">
     <h2 id="move-between-branches">Move Between Branches</h2>
     <div class="item">
       <h3>Switch branches:</h3>
@@ -181,7 +181,7 @@ <h3>Show a summary of a diff:</h3>
       <code>git show &lt;commit&gt; --stat</code>
     </div>
   </section>
-  <section class="commit-reference">
+  <section class="commit-reference print-break-before">
     <h2 id="ways-to-refer-to-a-commit">Ways to refer to a commit</h2>
     <p class="intro">
       Every time we say <code>&lt;commit&gt;</code>, you can use any of these:
@@ -236,7 +236,7 @@ <h3>'Stash' all staged and unstaged changes:</h3>
     </div>
   </section>
 
-  <section>
+  <section class="print-break-before">
     <h2 id="edit-history">Edit History</h2>
     <div class="item">
       <h3>"Undo" the most recent commit (keep your working directory the same):</h3>
@@ -285,7 +285,7 @@ <h3>Show who last changed each line of a file:</h3>
     </div>
   </section>
 
-  <section>
+  <section class="print-break-before">
     <h2 id="combine-diverged-branches">Combine Diverged Branches</h2>
     <div class="item">
       <h3>Combine with rebase:</h3>
@@ -695,7 +695,7 @@ <h2 id="add-a-remote">Add a Remote</h2>
     </div>
   </section>
 
-  <section>
+  <section class="print-break-before">
     <h2 id="push-your-changes">Push Your Changes</h2>
     <div class="item">
       <h3>Push the <code>main</code> branch to the remote <code>origin</code>:</h3>
@@ -757,7 +757,7 @@ <h3>See all possible config options:</h3>
     </div>
   </section>
 
-  <section>
+  <section class="print-break-before">
     <h2 id="important-files">Important Files</h2>
     <div class="item">
       <h3>Local git config:</h3>