Add bilingual Pages with a distinct etcd theme (#3)

* feat(docs): add statically rendered Chinese and English guides

* style(docs): give etcd its own brand palette and official logo

* feat(docs): add accessible command tabs and bilingual navigation

* ci(pages): deploy bilingual documentation from trusted main

* docs: link the website and document local building

* docs(etcd): clarify failpoint source and build requirements

Author: yeshan333

.github/workflows/pages.yaml

@@ -0,0 +1,58 @@
+name: GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths: ['website/**', '.github/workflows/pages.yaml', 'metadata.lua', 'README.md']
+  pull_request:
+    paths: ['website/**', '.github/workflows/pages.yaml', 'metadata.lua', 'README.md']
+  workflow_dispatch:
+  workflow_run:
+    workflows: ['Plugin']
+    types: [completed]
+    # Tag releases report the tag as head_branch, so do not filter to main.
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pages-${{ github.event_name == 'pull_request' && github.event.pull_request.number || 'deploy' }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  build:
+    if: github.event_name != 'workflow_run' || (github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.event != 'pull_request')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: read
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          # Releases create a version commit after their original triggering SHA.
+          ref: ${{ github.event_name == 'workflow_run' && 'main' || github.sha }}
+      - name: Read Pages configuration
+        id: pages
+        uses: actions/configure-pages@v6
+      - name: Build both language routes
+        env:
+          SITE_URL: ${{ steps.pages.outputs.base_url }}
+        run: python3 website/build.py --base-url "$SITE_URL"
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: _site
+
+  deploy:
+    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@v5

.gitignore

@@ -1,2 +1,4 @@
 .idea
-.tool-versions
+.tool-versions
+_site/
+__pycache__/

README.md

@@ -97,3 +97,9 @@ the tag. If publication fails, re-run the original failed job to resume it.
 The workflow follows the shared `@v1` release-tool version. Updating the tool does
 not release this plugin. See the [shared workflow documentation](https://github.com/version-fox/plugin-manifest-action)
 for the package contract and first-rollout requirements.
+
+## Documentation website
+
+[中文](https://version-fox.github.io/vfox-etcd/) · [English](https://version-fox.github.io/vfox-etcd/en/)
+
+The bilingual site is maintained under `website/`. See [website/README.md](website/README.md) for local build and deployment instructions.

website/README.md

@@ -0,0 +1,15 @@
+# Documentation site
+
+Chinese: https://version-fox.github.io/vfox-etcd/
+English: https://version-fox.github.io/vfox-etcd/en/
+
+Build with Python's standard library:
+
+```sh
+python3 website/build.py --output /tmp/vfox-etcd-site
+python3 -m http.server 8080 --directory /tmp/vfox-etcd-site
+```
+
+Open http://localhost:8080/ or /en/. A shared template and matching Chinese/English message files render both routes. site.json holds shared commands and canonical configuration. The builder reads plugin version and minimum vfox runtime from metadata.lua and rejects missing or unused template messages. Use --base-url for another deployment URL.
+
+Pages builds PRs, deploys main, and refreshes from trusted main after successful publication, including tag releases. Official logos are stored without modification; see assets/LOGO-SOURCE.txt. Reading the guides, switching languages and opening FAQ entries work without JavaScript. JavaScript adds accessible command tabs and copying.

website/assets/LOGO-SOURCE.txt

@@ -0,0 +1,3 @@
+Official project logo, copied without modification.
+Source: https://raw.githubusercontent.com/cncf/artwork/main/projects/etcd/icon/color/etcd-icon-color.svg
+Used to identify the runtime managed by this plugin, not to imply endorsement.