shazhou-ww
03e7b42d28
- 添加团队简介、小队定位说明 - 更新真实成员信息：小墨、绿豆、蓝莓 - 添加 kuma-vm 服务器信息 - 使用 MkDocs Material 特性：admonition、grid cards、mermaid、emoji - 添加技术栈和基础设施速查表
🌐 OC Wiki
OC Wiki — 知识共享平台
NEKO 小队和 KUMA 小队的共享知识库，使用 MkDocs Material 构建。
🔗 在线访问: https://shazhou-ww.github.io/oc-wiki/
📁 目录结构
docs/
├── index.md # 首页
├── neko/ # NEKO 小队文档（代码 & 工程）
├── kuma/ # KUMA 小队文档（基础设施 & 运维）
└── shared/ # 共享知识（跨小队通用）
✍️ 如何贡献
- Fork 或 Clone 本仓库
- 在对应目录下新建 / 编辑 Markdown 文件
- 如果新增页面，记得在
mkdocs.yml的nav中添加条目 - 提交 PR，合并到
main后会自动部署
Markdown 特性
本站支持丰富的 Markdown 扩展：
- ✅ 代码高亮 + 复制按钮
- ✅ Mermaid 图表
- ✅ Admonition 提示框
- ✅ 标签页 (Tabs)
- ✅ 任务列表
- ✅ Emoji 😊
🖥️ 本地预览
# 安装依赖
pip install -r requirements.txt
# 启动本地开发服务器
mkdocs serve
# 浏览器访问 http://127.0.0.1:8000
🚀 部署
推送到 main 分支后，GitHub Actions 会自动构建并部署到 GitHub Pages。
⚠️ 首次设置
GitHub Actions workflow 文件需要手动添加（需要 workflow 权限的 token）：
- 在 GitHub 网页上进入仓库
- 点击 "Add file" → "Create new file"
- 文件路径输入
.github/workflows/deploy.yml - 粘贴 deploy.yml 内容（本地 repo 中已有）
- 提交即可触发自动部署
📝 License
MIT