From 1d18594f01803e05b6488509831b08d6dfe14109 Mon Sep 17 00:00:00 2001
From: Mike Frysinger <vapier@google.com>
Date: Wed, 16 Sep 2026 15:53:28 -0400
Subject: [PATCH] add custom 404 page to auto-redirect

We have a lot of stub pages in here simply to redirect people to the
new location.  We can automate this with a bit of client-side JS.

Unfortunately, while GH pages supports this when using markdown files,
a lot of the documents we want to redirect are old XML files.
---
 404.html | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 404.html

diff --git a/404.html b/404.html
new file mode 100644
index 0000000..e68f19f
--- /dev/null
+++ b/404.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>HTTP/404 Page not found</title>
+<link rel="stylesheet" href="/styleguide/assets/css/style.css">
+<link rel="shortcut icon" href="/styleguide/favicon.ico">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<script>
+// Try to redirect for old guidelinks.
+window.onload = function() {
+  // Slice off the leading "/styleguide/".
+  const missingPage = location.pathname.substr(12);
+  const map = {
+    'cppguide.xml': 'cppguide.html',
+    'google-r-style.html': 'Rguide.html',
+    'htmlcssguide.xml': 'htmlcssguide.html',
+    'jsoncstyleguide.xml': 'jsoncstyleguide.html',
+    'objcguide.xml': 'objcguide.html',
+    'Rguide.xml': 'Rguide.html',
+    'shell.xml': 'shellguide.html',
+  };
+  const newPage = map[missingPage];
+  if (newPage) {
+    navigation.navigate(`/styleguide/${newPage}`);
+  }
+};
+</script>
+</head>
+<body>
+<div class="container-lg px-3 my-5 markdown-body">
+<h1><a href="/styleguide/">Google Style Guides</a></h1>
+<h1>Error: HTTP/404 File not found</h1>
+<p>
+Our guides have gone through format changes over the years, so try our
+<a href="/styleguide/">homepage</a> to see the latest available list.
+</p>
+</div>
+</body>
+</html>