提交初版文档

Author: pirunxi

.github/workflows/deploy.yml

@@ -0,0 +1,51 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build site
+        run: npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: build
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

CNAME

@@ -0,0 +1 @@
+doc.zlua.cn

README.md

@@ -1,2 +1,45 @@
-# zlua-doc
-Document for ZLua.
+# ZLua Docs
+
+[ZLua Docs](https://doc.zlua.cn) 是 [ZLua](https://github.com/focus-creative-games/zlua) 的官方文档站点源码，基于 [Docusaurus](https://docusaurus.io/) 构建。
+
+## 本地开发
+
+```bash
+npm install
+npm start
+```
+
+浏览器访问 [http://localhost:3000](http://localhost:3000)。
+
+## 构建
+
+```bash
+npm run build
+npm run serve
+```
+
+## 部署（GitHub Pages）
+
+推送到 `main` 分支后，[`.github/workflows/deploy.yml`](./.github/workflows/deploy.yml) 会自动构建并部署到 **https://doc.zlua.cn**。
+
+### 首次启用
+
+1. 仓库 **Settings → Pages → Build and deployment → Source** 选择 **GitHub Actions**
+2. DNS 为 `doc.zlua.cn` 配置 CNAME 指向 `<org>.github.io`（或按 GitHub Pages 自定义域名说明配置）
+3. 仓库 Settings → Pages 中填写 Custom domain：`doc.zlua.cn` 并启用 HTTPS
+
+`static/CNAME` 会在构建时写入站点根目录，供 GitHub Pages 识别自定义域名。
+
+## 文档结构
+
+- `docs/getting-started/` — 入门
+- `docs/guides/` — 使用指南
+- `docs/concepts/` — 核心概念
+- `docs/reference/` — API 参考
+- `docs/spec/` — 规范文档（权威语义）
+- `docs/architecture/` — 架构与性能
+- `docs/community/` — 社区与贡献
+
+## 许可证
+
+MIT

docs/architecture/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "架构与性能",
+  "position": 1
+}