feat(docs): update vuepress documentation site and fix issues with links

Author: briancaffey

backend/backend/settings/raspberrypi.py

@@ -1,8 +1,11 @@
 import { defineUserConfig } from 'vuepress'
-import type { DefaultThemeOptions } from 'vuepress'
+import { viteBundler } from '@vuepress/bundler-vite'
+import { searchPlugin } from '@vuepress/plugin-search'
 import { navbar } from './configs';
+import { defaultTheme } from '@vuepress/theme-default';
 
-export default defineUserConfig<DefaultThemeOptions>({
+export default defineUserConfig({
+  bundler: viteBundler(),
   port: 8089,
   base: '/django-step-by-step/',
   head: [
@@ -19,15 +22,7 @@ export default defineUserConfig<DefaultThemeOptions>({
     ],
   ],
   plugins: [
-    [
-      '@vuepress/pwa',
-      {
-        skipWaiting: true,
-      },
-    ],
-    [
-      '@vuepress/plugin-search',
-      {
+    searchPlugin({
         locales: {
           '/': {
             placeholder: 'Search',
@@ -36,11 +31,10 @@ export default defineUserConfig<DefaultThemeOptions>({
             placeholder: '搜索',
           },
         },
-      },
-    ],
+    })
   ],
-  // site-level locales config
 
+  // site-level locales config
   locales: {
     '/': {
       lang: 'en-US',
@@ -54,9 +48,10 @@ export default defineUserConfig<DefaultThemeOptions>({
     },
   },
 
-  themeConfig: {
+  theme: defaultTheme({
+
     logo: '/images/ublog.png',
-    darkMode: true,
+    // darkMode: true,
     repo: 'https://github.com/briancaffey/django-step-by-step',
 
     docsDir: 'vuepress-docs/docs',
@@ -107,10 +102,10 @@ export default defineUserConfig<DefaultThemeOptions>({
 
         // a11y
         openInNewWindow: '在新窗口打开',
-        toggleDarkMode: '切换夜间模式',
+        // toggleDarkMode: '切换夜间模式',
       },
     },
-  },
+  }),
   lang: 'en-US',
   title: 'Django Step by Step Documentation',
   description: 'Documentation for Django Step by Step',

stack.yml

@@ -11,44 +11,24 @@ export const en: NavbarConfig = [
     children: [
       {
         text: 'Django Application',
-        link: '/topics/django/',
+        link: '/topics/django',
       },
       {
         text: 'Nuxt Application',
-        link: '/topics/nuxt/',
+        link: '/topics/nuxt',
       },
       {
         text: 'Docker Compose',
-        link: '/topics/docker-compose/',
+        link: '/topics/docker-compose',
       },
       {
         text: 'VuePress Documentation',
-        link: '/topics/vuepress/',
-      }
-    ],
-  },
-  {
-    text: 'Guide',
-    link: '/guide/',
-    children: [
-      {
-        text: 'Step by step guide',
-        link: '/guide/step-by-step/',
-      },
-      {
-        text: 'CI/CD',
-        children: [
-          {
-            text: 'GitHub Actions',
-            link: '/guide/ci-cd/github-actions/',
-          }
-        ]
+        link: '/topics/vuepress',
       }
     ],
   },
   {
     text: 'Deploy',
-    // link: '/deploy/',
     children: [
       {
         link: '/deploy/aws',
@@ -70,10 +50,10 @@ export const en: NavbarConfig = [
       },
       {
         text: 'Application Updates',
-        // link: '/deploy/app'
+        link: '/deploy/app',
         children: [
           {
-            link: '/deploy/app',
+            link: '/deploy/github-actions',
             text: 'GitHub Action'
           }
         ]

vuepress-docs/docs/.vuepress/config.ts

@@ -3,7 +3,7 @@ home: true
 
 actions:
   - text: Introduction
-    link: /intro
+    link: /intro/
     type: primary
 heroImage: /images/ublog.png
 

vuepress-docs/docs/.vuepress/configs/navbar/en.ts

@@ -1,14 +1,11 @@
 ---
-next: /deploy/aws/cdk
+next: /deploy/aws/terraform
 prev: /guide/ci-cd/github-actions
 
 head:
   - - meta
     - name: description
       content: Using different Infrastructure as Code tools for deploying Django projects
-  # - - link
-  #   - rel: canonical
-  #     href: https://briancaffey.github.io/
 ---
 
 # Overview of options for deploying μblog