Update docs build to create multi-version builds. (#44)

* Update docs build to create multi-version builds.

* Build all doc versions from 1.0.0.

Author: reynoldsalec

.github/workflows/pr-docs-tests.yml

@@ -15,17 +15,25 @@ jobs:
     steps:
       # Install deps and cache
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
+      - name: Cache version builds
+        uses: actions/cache@v4
+        with:
+          key: lando-mvb-docs
+          path: docs/.vitepress/cache/@lando/mvb
+          save-always: true
       - name: Install node ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           cache: npm
-      - name: Install dependencies
+      - name: Install NPM dependencies
         run: npm clean-install --prefer-offline --frozen-lockfile
 
       # Run tests
       - name: Run linter
         run: npm run lint
+      - name: Test mvb
+        run: npm run docs:mvb
       - name: Test build
         run: npm run docs:build

.github/workflows/pr-linter.yml

@@ -15,9 +15,9 @@ jobs:
     steps:
       # Install deps and cache
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install node ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           cache: npm

.github/workflows/pr-postgres-tests.yml

@@ -30,9 +30,9 @@ jobs:
     steps:
 
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install node ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           registry-url: https://registry.npmjs.org

.github/workflows/pr-unit-tests.yml

@@ -17,9 +17,9 @@ jobs:
     steps:
       # Install deps and cache
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install node ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           cache: npm

.github/workflows/release.yml

@@ -21,9 +21,9 @@ jobs:
     steps:
       # Install deps and cache
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install node ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           registry-url: https://registry.npmjs.org

docs/.vitepress/config.mjs

@@ -19,6 +19,9 @@ export default defineConfig({
     ['link', {rel: 'icon', href: '/postgres/favicon.svg', type: 'image/svg+xml'}],
   ],
   themeConfig: {
+    multiVersionBuild: {
+      satisfies: '>=1.0.0',
+    },
     sidebar: sidebar(),
   },
 });

docs/v/index.md

@@ -0,0 +1,40 @@
+---
+description: All Other documentation versions
+title: Docuverse
+contributors: false
+lastUpdated: false
+editLink: false
+next: false
+prev: false
+---
+# Docuverse
+
+<br />
+<br />
+
+<div
+  v-for="link in links"
+  :key="link.text"
+  class="version-link"
+>
+  <VPLVersionLink
+    :text="link.text"
+    :href="link.href"
+    :prerelease="link.prerelease"
+    :stable="link.stable"
+    :edge="link.edge"
+  />
+</div>
+
+<br />
+
+<div>
+  <VPLVersionLink :dev="true" :text="aliases.dev" :href="aliasLinks.dev" />
+</div>
+
+<script setup>
+import {useTags} from '@lando/vitepress-theme-default-plus';
+import {VPLCollectionPage, VPLCollectionPageSection, VPLCollectionPageTitle, VPLVersionLink} from '@lando/vitepress-theme-default-plus';
+
+const {aliases, aliasLinks, links} = useTags();
+</script>

netlify.toml

@@ -1,8 +1,21 @@
 [build]
   base = "./"
   publish = "docs/.vitepress/dist"
+  command = "npm run docs:mvb"
+
+[context.deploy-preview]
   command = "npm run docs:build"
 
+# https://github.com/munter/netlify-plugin-checklinks#readme
+[[context.deploy-preview.plugins]]
+  package = "netlify-plugin-checklinks"
+  [context.deploy-preview.plugins.inputs]
+    todoPatterns = [ "load", "CHANGELOG.html", "x.com", "twitter.com", "/v/" ]
+    skipPatterns = [ ".rss", ".gif", ".jpg" ]
+    checkExternal = true
+
+
+
 # Sets our asset optimization
 [build.processing.css]
   bundle = true
@@ -28,13 +41,7 @@
   [plugins.inputs.audits]
     output_path = "reports/lighthouse.html"
 
-# https://github.com/munter/netlify-plugin-checklinks#readme
-[[plugins]]
-  package = "netlify-plugin-checklinks"
-  [plugins.inputs]
-    todoPatterns = [ "load", "CHANGELOG.html", "x.com", "twitter.com" ]
-    skipPatterns = [ ".rss", ".gif", ".jpg" ]
-    checkExternal = true
+
 
 # We need this so preview environments and the base site look ok on their own
 [[redirects]]
@@ -44,4 +51,4 @@
 [[redirects]]
   from = "/plugins/postgres/*"
   to = "/:splat"
-  status = 200
+  status = 200