用户教程与 Wiki 方案

结论

继续使用 Gollum(ty-wiki-portal)作为用例与教程的协作编辑入口,Git 仓库为唯一事实源;正式交付的教程站与 PDF/DOCX 从同一仓库由 CI 构建。

GitLab Wiki 仓库(唯一事实源)
  ▲ push/pull(sync.sh,每 2 分钟)     ▲ MR / push
Gollum 网页编辑(系统账号登录)        VS Code / Obsidian / Typora 本地编辑
  └─ CI:Markdown → VitePress 教程站 / PDF / DOCX(正式交付、可白标)

待补齐:登录与审计

  1. oauth2-proxy 放在 Gollum 前面,接统一身份源(车队/仓库系统账号,如 Supabase Auth OIDC 或 Keycloak/Authentik),按用户组限制可登录人员。
  2. config.rb Rack 中间件:读取 X-Forwarded-User / X-Forwarded-Email,写入 session['gollum.author'],使每次网页编辑的 Git 提交作者为真实用户;缺少请求头的请求一律拒绝。
  3. 读写分离:只读实例(--no-edit)与可编辑实例指向同一仓库。

外部文档联动

  • 技术人员克隆仓库直接编辑并推送。
  • 客户 DOCX 由 CI 用 Pandoc 转为 Markdown 入库;反向导出 DOCX/PDF 交付。
  • 截图由 Playwright 脚本在测试环境自动生成,界面变化后重跑更新。

相关

0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9