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 <[email protected]>

Author: dscho

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({