@flyewi/eleventy-plugin-redirects 0.1.0 → 0.2.0

package/README.md

@@ -40,6 +40,8 @@ By default this writes an `_redirects` file into your output directory after eve
 | `apache` | `false` | Write an Apache `.htaccess` with `Redirect` directives. |
 | `apacheFile` | `".htaccess"` | Filename for the Apache output. |
 | `html` | `false` | Also write a static HTML fallback page at each `from` URL (meta-refresh + `rel=canonical`), for hosts (e.g. GitHub Pages) that can't act on `_redirects`/`.htaccess`. |
+| `htmlLang` | `"en"` | `lang` attribute of the HTML fallback pages. |
+| `htmlMessage` | `"This page has moved to"` | Text shown (followed by the link) on the HTML fallback pages, for the moment before the redirect or when it doesn't fire. |
 | `log` | `true` | Log a one-line summary after each build. |
 
 ## Netlify output
@@ -65,8 +67,11 @@ With `html: true`, each `from` path also gets a real HTML file at that URL (e.g.
 ```html
 <meta http-equiv="refresh" content="0; url=/new-path/">
 <link rel="canonical" href="/new-path/">
+<script>location.replace("/new-path/" + location.hash);</script>
 ```
 
+The script redirects immediately and keeps the URL fragment (`/old-path/#section` → `/new-path/#section`), like a server-side redirect would; the meta refresh is the fallback when JavaScript is off. If the target already contains a `#fragment`, that one is kept instead.
+
 This is a static fallback for platforms without server-side redirect support — a real `_redirects`/`.htaccess` (or your host/CDN's redirect rules) is always the better option when available, since the HTML approach is a moment slower and depends on the browser executing the refresh.
 
 ## License

package/lib/formats.js

@@ -16,21 +16,32 @@ function escapeAttr(str) {
     .replace(/>/g, ">");
 }
 
+// JSON.stringify yields a valid JS string literal; escaping "<" additionally
+// keeps a target containing "</script>" from closing the inline script early.
+function toScriptString(str) {
+  return JSON.stringify(String(str)).replace(/</g, "\\u003c");
+}
+
 // A static fallback for hosts that can't act on _redirects/.htaccess (e.g.
 // GitHub Pages): an actual HTML file at the old URL that both redirects
 // browsers instantly and points crawlers at the new canonical URL.
-function toHtmlPage(to) {
+// The script runs before the meta refresh fires and carries the URL fragment
+// (#section) over, as a server-side 301 would; the meta refresh remains as the
+// no-JS fallback. A target that already has its own fragment keeps it.
+function toHtmlPage(to, { lang = "en", message = "This page has moved to" } = {}) {
   const target = escapeAttr(to);
+  const hash = String(to).includes("#") ? "" : " + location.hash";
   return `<!doctype html>
-<html lang="en">
+<html lang="${escapeAttr(lang)}">
 <head>
 <meta charset="utf-8">
-<title>Redirecting…</title>
+<title>${escapeAttr(message)} ${target}</title>
 <meta http-equiv="refresh" content="0; url=${target}">
 <link rel="canonical" href="${target}">
+<script>location.replace(${toScriptString(to)}${hash});</script>
 </head>
 <body>
-<p>This page has moved to <a href="${target}">${target}</a>.</p>
+<p>${escapeAttr(message)} <a href="${target}">${target}</a>.</p>
 </body>
 </html>
 `;

package/lib/redirects.js

@@ -10,6 +10,8 @@ const DEFAULTS = {
   netlify: true,
   apache: false,
   html: false,
+  htmlLang: "en",
+  htmlMessage: "This page has moved to",
   netlifyFile: "_redirects",
   apacheFile: ".htaccess",
   log: true,
@@ -59,7 +61,10 @@ module.exports = function redirectsPlugin(eleventyConfig, userOptions = {}) {
       for (const { from, to } of list) {
         const outPath = path.join(outputDir, toOutputPath(from));
         fs.mkdirSync(path.dirname(outPath), { recursive: true });
-        fs.writeFileSync(outPath, toHtmlPage(to));
+        fs.writeFileSync(
+          outPath,
+          toHtmlPage(to, { lang: options.htmlLang, message: options.htmlMessage })
+        );
       }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyewi/eleventy-plugin-redirects",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Eleventy plugin that generates Netlify _redirects, Apache .htaccess, and static HTML fallback pages from a single redirects config.",
   "main": "lib/redirects.js",
   "type": "commonjs",