docs: new docs website using Astro + Starlight

.github/workflows/publish-page.yml

@@ -24,10 +24,14 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
       - uses: actions/setup-node@v4
         with:
-          node-version: 16
+          node-version: 20
+          cache: 'pnpm'
 
       - name: Install and Build
         working-directory: docs
@@ -36,13 +40,13 @@ jobs:
           # PRs: https://tanka.dev/pr-preview/pr-{number}/
           PATH_PREFIX: "${{ github.event_name == 'pull_request' && format('/pr-preview/pr-{0}', github.event.number) || '' }}"
         run: |
-          yarn install
-          yarn build
+          pnpm install
+          pnpm build
 
       - name: Deploy main
         if: github.event_name != 'pull_request'
         uses: JamesIves/github-pages-deploy-action@v4
-        with: 
+        with:
           clean-exclude: pr-preview/
           folder: ./docs/public/
 

docs/.gitignore

@@ -1,75 +1,21 @@
-.docz
+# build output
+dist/
+# generated types
+.astro/
 
-# Logs
-logs
-*.log
+# dependencies
+node_modules/
+
+# logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+pnpm-debug.log*
 
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-jspm_packages/
 
-# Typescript v1 declaration files
-typings/
+# environment variables
+.env
+.env.production
 
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# dotenv environment variable files
-.env*
-
-# gatsby files
-public
-.cache
-
-# Mac files
+# macOS-specific files
 .DS_Store
-
-# Yarn
-yarn-error.log
-.pnp/
-.pnp.js
-# Yarn Integrity file
-.yarn-integrity
-
-# gatsby-remark-vscode extensions are required tho
-node_modules/*
-!/node_modules/vscext
-!/node_modules/vscext/*