feat(website): migrate to a full Starlight documentation site

.github/workflows/deploy-website.yml

@@ -9,6 +9,8 @@ on:
     branches: [main]
     paths:
       - "website/**"
+      - "engdocs/**"
+      - "specs/**"
       - ".github/workflows/deploy-website.yml"
   workflow_dispatch:
 

website/.gitignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+.astro
+src/content/docs/*
+!src/content/docs/index.mdx
+!src/content/docs/.gitignore
+public/mermaid.min.js
+public/robots.txt

website/astro.config.mjs

@@ -1,16 +1,64 @@
 import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
 import sitemap from "@astrojs/sitemap";
 
 const site = process.env.SITE_URL || "https://sverka.dev";
 const baseInput = process.env.BASE_PATH || "/";
-const base = baseInput === "/" || baseInput.endsWith("/")
-  ? baseInput
-  : `${baseInput}/`;
+const basePath = baseInput === "/" ? "" : baseInput.replace(/\/$/, "");
+const base = basePath || undefined;
+
+const asset = (path) => `${basePath}${path}`;
+
+const mermaidInit = `
+document.addEventListener("DOMContentLoaded", function () {
+  if (typeof mermaid === "undefined") return;
+  const blocks = document.querySelectorAll('pre[data-language="mermaid"], pre.mermaid');
+  if (!blocks.length) return;
+  blocks.forEach(function (pre) {
+    const code = pre.querySelector("code");
+    pre.className = "mermaid";
+    pre.textContent = (code && code.textContent) || pre.textContent || "";
+  });
+  var theme = document.documentElement.dataset.theme === "dark" ? "dark" : "default";
+  mermaid.initialize({ startOnLoad: false, theme: theme });
+  mermaid.run({ querySelector: ".mermaid" });
+});
+`;
 
 export default defineConfig({
   site,
   base,
+  trailingSlash: "always",
   output: "static",
-  integrations: [sitemap()],
+  integrations: [
+    starlight({
+      title: "Sverka",
+      description: "Define checks once. Plan locally. Run anywhere.",
+      favicon: "/favicon.svg",
+      social: [
+        {
+          icon: "github",
+          label: "GitHub",
+          href: "https://github.com/sverka-dev/sverka",
+        },
+      ],
+      editLink: {
+        baseUrl: "https://github.com/sverka-dev/sverka/edit/main/",
+      },
+      customCss: ["./src/styles/custom.css"],
+      head: [
+        {
+          tag: "script",
+          attrs: { src: asset("/mermaid.min.js"), defer: true },
+        },
+        {
+          tag: "script",
+          content: mermaidInit,
+        },
+      ],
+      lastUpdated: true,
+    }),
+    sitemap(),
+  ],
   compressHTML: true,
 });