refactor: Updated docs to use node 20 & a new sitemap plugin

.github/workflows/build-and-deploy-docs.yml

@@ -22,11 +22,11 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        node-version: [14.x]
+        node-version: [20.x]
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
       - run: npm ci
@@ -35,7 +35,7 @@ jobs:
       - name: rsync deployments
         uses: burnett01/[email protected]
         with:
-          switches: -avzr --delete
+          switches: -avzr
           path: ./dist/
           remote_path: ${{ secrets.NYS_DOCS_ROOT }}${{ env.DOCS_DEST_DIR }}
           remote_host: ${{ secrets.NYS_DEPLOY_REMOTE_HOST }}

docs/Dockerfile

@@ -1,7 +1,7 @@
-ARG TAG=14-alpine
+ARG TAG=20-alpine
 FROM node:$TAG
 
-USER node
+RUN npm install -g npm@^10.0.0
 
 WORKDIR /app/
 

docs/Makefile

@@ -1,5 +1,5 @@
 MAJOR_VERSION?=4
-TAG?=14-alpine
+TAG?=20-alpine
 CONTAINER?=$(shell basename $(dir $(CURDIR)))-v${MAJOR_VERSION}-docs
 DOCS_DEV_PORT?=400${MAJOR_VERSION}
 DOCS_DEST?=../../../sites/nystudio107/web/docs/recipe

docs/docs/.vitepress/config.ts

@@ -33,6 +33,12 @@ export default defineConfig({
       {text: 'Store', link: 'https://plugins.craftcms.com/recipe'},
       {text: 'Changelog', link: 'https://nystudio107.com/plugins/recipe/changelog'},
       {text: 'Issues', link: 'https://github.com/nystudio107/craft-recipe/issues'},
+      {
+        text: 'v4', items: [
+          {text: 'v4', link: '/'},
+          {text: 'v1', link: 'https://nystudio107.com/docs/recipe/v1/'},
+        ],
+      },
     ]
   },
 });

docs/docs/vite.config.ts

@@ -1,21 +1,21 @@
-import {defineConfig} from 'vite';
-import SitemapPlugin from 'rollup-plugin-sitemap';
-import VitePressConfig from './.vitepress/config';
+import {defineConfig} from 'vite'
+import { sitemap, Url as SitemapUrl } from '@aminnairi/rollup-plugin-sitemap'
+import VitePressConfig from './.vitepress/config'
+import {DefaultTheme} from "vitepress/types/default-theme";
 
-const docsSiteBaseUrl = 'https://nystudio107.com';
+const docsSiteBaseUrl = 'https://nystudio107.com'
 const docsBaseUrl = new URL(VitePressConfig.base!, docsSiteBaseUrl).href.replace(/\/$/, '') + '/';
-const siteMapRoutes = [{
-  path: '',
-  name: VitePressConfig.title
+let siteMapUrls: SitemapUrl[] = [{
+  location: '',
+  lastModified: new Date(),
 }];
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    SitemapPlugin({
+    sitemap({
       baseUrl: docsBaseUrl,
-      contentBase: './docs/.vitepress/dist',
-      routes: siteMapRoutes,
+      urls: siteMapUrls,
     })
   ],
   server: {