ci: adds initial CI/CD pipeline for preview

Author: claymcleod

.github/workflows/deploy-preview.yml

@@ -0,0 +1,41 @@
+name: Deploy a Preview Site
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "latest"
+      - run: npm install -g pnpm
+      - run: pnpm install
+      - run: sed -i "s|/docs|/docs/branches/${GITHUB_HEAD_REF}|g" nuxt.config.ts; cat nuxt.config.ts
+      - run: pnpm nuxt build --preset github_pages
+      - run: |
+          mkdir -p dist/branches/${{ github.head_ref }}
+          mv .output/public/* dist/branches/${{ github.head_ref }} || exit 0
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          name: "Project Documentation"
+          path: "dist"
+  deploy:
+    needs: build
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+        with:
+          artifact_name: "Project Documentation"

components/molecules/docs/LeftSidebar.vue

@@ -7,11 +7,11 @@
     </div>
     <div class="links">
       <div class="header">Get Started</div>
-      <RouterLink to="/docs/get-started/overview">Overview</RouterLink>
-      <RouterLink to="/docs/get-started/values">Values</RouterLink>
+      <RouterLink to="./docs/get-started/overview">Overview</RouterLink>
+      <RouterLink to="./docs/get-started/values">Values</RouterLink>
 
       <div class="header">Writing Crates</div>
-      <RouterLink to="/docs/writing-crates/checklist">Checklist</RouterLink>
+      <RouterLink to="./docs/writing-crates/checklist">Checklist</RouterLink>
     </div>
   </div>
 </template>

nuxt.config.ts

@@ -5,6 +5,10 @@ export default defineNuxtConfig({
   compatibilityDate: "2024-04-03",
   css: ["~/assets/css/main.postcss"],
   devtools: { enabled: true },
+  ssr: false,
+  app: {
+    baseURL: "/docs",
+  },
   modules: [
     "nuxt-lucide-icons",
     "@nuxt/content",
@@ -26,4 +30,4 @@ export default defineNuxtConfig({
       linkExactActiveClass: "active",
     },
   },
-});
+});