v4 Documentation

.node-version

@@ -0,0 +1 @@
+20

.stylua.toml

@@ -0,0 +1,7 @@
+column_width = 80
+line_endings = "Unix"
+indent_type = "Spaces"
+indent_width = 2
+quote_style = "AutoPreferDouble"
+call_parentheses = "Always"
+collapse_simple_statement = "Never"

astro.config.mjs

@@ -1,6 +1,8 @@
 import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
-
+import starlightDocSearch from "@astrojs/starlight-docsearch";
+import starlightLinksValidator from "starlight-links-validator";
+import starlightImageZoom from "starlight-image-zoom";
 import tailwind from "@astrojs/tailwind";
 
 const locales = {
@@ -17,7 +19,7 @@ export default defineConfig({
   locales,
   integrations: [
     starlight({
-      title: "AstroNvim Docs",
+      title: "AstroNvim Documentation",
       description: "The documentation website for AstroNvim.",
       favicon: "/astronvim.svg",
       head: [
@@ -116,8 +118,17 @@ export default defineConfig({
         src: "./src/assets/astronvim.svg",
       },
       components: {
-        Search: "./src/components/Search.astro",
+        SiteTitle: "./src/components/SiteTitle.astro",
       },
+      plugins: [
+        starlightDocSearch({
+          appId: "JXZNTZ86UN",
+          apiKey: "96faee2ebdaf4a8a66d0f810c635bfec",
+          indexName: "astronvim",
+        }),
+        starlightLinksValidator(),
+        starlightImageZoom(),
+      ],
       customCss: [
         // Path to your Tailwind base styles:
         "./src/tailwind.css",
@@ -131,57 +142,70 @@ export default defineConfig({
       },
       sidebar: [
         {
-          label: "Getting started",
+          label: "🚀 Getting Started",
           link: "/",
           collapsed: true,
           translations: {},
         },
         {
-          label: "Basic Usage",
+          label: "📦 AstroCommunity",
+          link: "/astrocommunity",
           collapsed: true,
-          autogenerate: { directory: "basic-usage" },
           translations: {},
         },
         {
-          label: "Configuration",
+          label: "⌨️ Mappings",
+          link: "/mappings",
+          collapsed: true,
+          translations: {},
+        },
+        {
+          label: "📝 Using This Documentation",
+          link: "/using_the_docs",
+          collapsed: true,
+          translations: {},
+        },
+        {
+          label: "🔧 Configuration",
           collapsed: true,
           autogenerate: { directory: "configuration" },
           translations: {},
         },
         {
-          label: "Recipes",
+          label: "🍳 Recipes",
           collapsed: true,
           autogenerate: { directory: "recipes" },
           translations: {},
         },
         {
-          label: "Acknowledgements",
+          label: "📔 Reference",
+          collapsed: true,
+          autogenerate: { directory: "reference" },
+          translations: {},
+        },
+        {
+          label: "⭐ Acknowledgements",
           link: "/acknowledgements",
           collapsed: true,
 
           translations: {},
         },
         {
-          label: "Code of Conduct",
+          label: "👪 Code of Conduct",
           collapsed: true,
           link: "/code_of_conduct",
           translations: {},
         },
         {
-          label: "Frequently Asked Questions",
+          label: "❓ FAQ",
           collapsed: true,
           link: "/faq",
           translations: {},
         },
-        {
-          label: "Core Lua API Documentation",
-          link: "https://api.astronvim.com",
-          translations: {},
-        },
       ],
       lastUpdated: true,
       editLink: {
-        baseUrl: 'https://github.com/AstroNvim/docs/edit/main/'
+        baseUrl: "https://github.com/AstroNvim/docs/edit/main/",
       },
     }),
     tailwind({

netlify.toml

@@ -11,10 +11,6 @@ Cache-Control = "public, max-age=31536000, immutable"
 [[plugins]]
 package = "@netlify/plugin-lighthouse"
 [[plugins]]
-package = "netlify-plugin-checklinks"
-[plugins.inputs]
-skipPatterns = ["dist/404", "id=\"%EF%B8%8F-installation\""]
-[[plugins]]
 package = "netlify-plugin-submit-sitemap"
 [plugins.inputs]
 sitemapPath = "/sitemap-index.xml"
@@ -33,9 +29,8 @@ to = "https://magenta-malasada-aac0c8.netlify.app/:splat"
 status = 200
 force = true                                              # COMMENT: ensure that we always redirect
 
-# Old paths
-
 [[redirects]]
-from = "/Basic%20Usage/*"
-to = "/basic-usage/:splat"
-status = 301
+from = "/v3/*"
+to = "https://neon-salmiakki-8da50a.netlify.app/:splat"
+status = 200
+force = true                                            # COMMENT: ensure that we always redirect

package.json

@@ -1,31 +1,32 @@
 {
-  "name": "docs-v2",
+  "name": "astronvim-documentation",
   "type": "module",
   "version": "0.0.1",
   "scripts": {
     "dev": "astro dev",
     "start": "astro dev",
     "build": "astro build",
     "preview": "astro preview",
-    "astro": "astro"
+    "astro": "astro",
+    "upgrade": "pnpm dlx @astrojs/upgrade"
   },
   "dependencies": {
-    "@astrojs/mdx": "^1.1.5",
-    "@astrojs/starlight": "^0.13.0",
+    "@astrojs/mdx": "^2.2.0",
+    "@astrojs/starlight": "^0.21.2",
+    "@astrojs/starlight-docsearch": "^0.1.0",
     "@astrojs/starlight-tailwind": "^2.0.1",
-    "@astrojs/tailwind": "^5.0.2",
-    "@docsearch/css": "^3.5.2",
-    "@docsearch/js": "^3.5.2",
-    "astro": "^3.5.5",
-    "sharp": "^0.32.6",
-    "tailwindcss": "^3.3.5"
+    "@astrojs/tailwind": "^5.1.0",
+    "astro": "^4.5.7",
+    "sharp": "^0.33.2",
+    "starlight-image-zoom": "^0.1.0",
+    "starlight-links-validator": "^0.5.3",
+    "tailwindcss": "^3.4.1"
   },
   "devDependencies": {
-    "@netlify/plugin-lighthouse": "^5.0.0",
-    "netlify-plugin-checklinks": "^4.1.1",
+    "@netlify/plugin-lighthouse": "^6.0.0",
     "netlify-plugin-submit-sitemap": "^0.4.0",
-    "prettier": "^3.1.0",
-    "prettier-plugin-astro": "^0.12.2",
-    "prettier-plugin-tailwindcss": "^0.5.7"
+    "prettier": "^3.2.5",
+    "prettier-plugin-astro": "^0.13.0",
+    "prettier-plugin-tailwindcss": "^0.5.11"
   }
 }