Add custom 404 page and verify essential site files in CI

sbryngelson · claude · sbryngelson · commit aa75bcb081ea · 2026-02-18T22:10:48.000Z
Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -37,6 +37,12 @@ jobs:
         cmake -S . -B build -G Ninja --install-prefix="$(pwd)/build/install" -D MFC_DOCUMENTATION=ON
         ninja -C build install
 
+    - name: Verify essential site files
+      run: |
+        for f in index.html 404.html robots.txt; do
+          test -f "build/install/docs/mfc/$f" || { echo "Missing $f"; exit 1; }
+        done
+
     - name: Upload Built Documentation Artifact
       uses: actions/upload-artifact@v4
       with:
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -833,6 +833,7 @@ if (MFC_DOCUMENTATION)
             DESTINATION "docs/mfc")
 
     install(FILES       "${CMAKE_CURRENT_SOURCE_DIR}/docs/index.html"
+                        "${CMAKE_CURRENT_SOURCE_DIR}/docs/404.html"
             DESTINATION "docs/mfc")
 endif()
 
diff --git a/docs/404.html b/docs/404.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>404 | MFC</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
+</head>
+<body class="bg-slate-900 text-white min-h-screen flex flex-col items-center justify-center px-4">
+    <div class="text-center max-w-md">
+        <div class="text-8xl font-extrabold text-amber-400 mb-4">404</div>
+        <h1 class="text-2xl font-bold mb-2">Page not found</h1>
+        <p class="text-slate-400 mb-8">The page you're looking for doesn't exist or has been moved.</p>
+        <div class="flex flex-col sm:flex-row gap-4 justify-center">
+            <a href="/" class="px-6 py-3 bg-amber-400 text-slate-900 font-semibold rounded hover:bg-amber-300 transition-colors no-underline">
+                <i class="fa-solid fa-house mr-2"></i>Home
+            </a>
+            <a href="/documentation/" class="px-6 py-3 bg-slate-700 font-semibold rounded hover:bg-slate-600 transition-colors no-underline">
+                <i class="fa-solid fa-book mr-2"></i>Documentation
+            </a>
+            <a href="https://github.com/MFlowCode/MFC" class="px-6 py-3 bg-slate-700 font-semibold rounded hover:bg-slate-600 transition-colors no-underline">
+                <i class="fa-brands fa-github mr-2"></i>GitHub
+            </a>
+        </div>
+    </div>
+</body>
+</html>
