Merge pull request #31 from A3S-Lab/codex/code-site-pages

docs: launch multilingual A3S Code website

Author: ZhiXiao-Lin

.github/workflows/docs-pages.yml

@@ -0,0 +1,88 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'website/**'
+      - '.github/workflows/docs-pages.yml'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'website/**'
+      - '.github/workflows/docs-pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pages-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build documentation
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: read
+    defaults:
+      run:
+        working-directory: website
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: website/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check formatting
+        run: npm run format:check
+
+      - name: Lint and check language parity
+        run: npm run lint
+
+      - name: Configure GitHub Pages
+        if: github.event_name != 'pull_request' && github.ref == 'refs/heads/main'
+        uses: actions/configure-pages@v5
+
+      - name: Build website
+        run: npm run build
+        env:
+          DOCS_BASE: /Code/
+          DOCS_ORIGIN: https://a3s-lab.github.io
+
+      - name: Check built routes and assets
+        run: npm run check:site
+
+      - name: Upload GitHub Pages artifact
+        if: github.event_name != 'pull_request' && github.ref == 'refs/heads/main'
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: website/doc_build
+
+  deploy:
+    name: Deploy documentation
+    if: github.event_name != 'pull_request' && github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

website/.gitignore

@@ -0,0 +1,14 @@
+# Local
+.DS_Store
+*.local
+*.log*
+
+# Dist
+node_modules
+dist/
+doc_build/
+
+# IDE
+.vscode/*
+!.vscode/extensions.json
+.idea

website/.prettierignore

@@ -0,0 +1,4 @@
+# Lock files
+package-lock.json
+pnpm-lock.yaml
+yarn.lock

website/.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}

website/AGENTS.md

@@ -0,0 +1,13 @@
+## Tools
+
+### Prettier
+
+- Run `npm run format` to format your code
+
+## Docs
+
+- Rslint: https://rslint.rs/llms.txt
+
+### Rslint
+
+- Run `npm run lint` to lint your code

website/README.md

@@ -0,0 +1,26 @@
+# A3S Code website
+
+The official multilingual website and documentation for
+[A3S Code](https://github.com/A3S-Lab/Code), built with Rspress.
+
+## Local development
+
+```bash
+npm ci
+npm run dev
+```
+
+The production site is served from `/Code/`. Override `DOCS_BASE` and
+`DOCS_ORIGIN` only when previewing another deployment target.
+
+## Checks
+
+```bash
+npm run format:check
+npm run lint
+npm run build
+```
+
+The published documentation currently contains only the active `v6` line.
+When a new major line ships, add a version snapshot under `docs/<version>` and
+then list it in `multiVersion.versions` in `rspress.config.ts`.

website/docs/public/a3s-code-mark.svg

@@ -0,0 +1,12 @@
+[
+  {
+    "type": "dir",
+    "name": "guide",
+    "label": "Documentation"
+  },
+  {
+    "type": "dir",
+    "name": "api",
+    "label": "API"
+  }
+]