improve permaid links

mikebarkmin · mikebarkmin · commit 75025ec12710 · 2026-04-19T21:08:53.000+02:00
diff --git a/.changeset/grumpy-bees-kick.md b/.changeset/grumpy-bees-kick.md
@@ -0,0 +1,5 @@
+---
+"hyperbook": minor
+---
+
+Permaid sites are now using a small footprint approach.
diff --git a/packages/hyperbook/build.ts b/packages/hyperbook/build.ts
@@ -82,7 +82,17 @@ export async function buildSingleBookPage(
       permaOut,
       file.markdown.data.permaid + ".html",
     );
-    await fs.writeFile(permaFileOut, result.value);
+    const redirectUrl = posix.join(
+      "/",
+      hyperbookJson.basePath || "",
+      file.path.href || "",
+    );
+    const redirectHtml = `<!DOCTYPE html>
+<meta charset="utf-8">
+<meta http-equiv="refresh" content="0; url=${redirectUrl}">
+<link rel="canonical" href="${redirectUrl}">
+`;
+    await fs.writeFile(permaFileOut, redirectHtml);
   }
   await fs.writeFile(fileOut, result.value);
 
diff --git a/website/en/book/changelog.md b/website/en/book/changelog.md
@@ -38,6 +38,18 @@ If you need a new feature, open an [issue](https://github.com/openpatch/hyperboo
 ::::
 -->
 
+## v0.90.0
+
+::::tabs
+
+:::tab{title="Improved :+1:" id="improved"}
+
+- Permaid files now use a lightweight HTML redirect instead of duplicating the full page content. This reduces build output size and build times while providing proper SEO via `<link rel="canonical">`.
+
+:::
+
+::::
+
 ## v0.89.3
 
 ::::tabs

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"hyperbook": minor
 +---
++
 +Permaid sites are now using a small footprint approach.