BAAS 文档
使用指南

网页 Wiki

应用内文档页现在默认加载网页文档站,并支持在 Tauri 中弹出独立窗口。

BAAS Tauri 不再把旧的本地 Wiki 文章列表作为主要维护入口。侧边栏的“文档”页面会加载网页文档站,文档内容由 baas-tauri/docs 中的 Fumadocs 项目生成。

主窗口内嵌

进入侧边栏“文档”后,主窗口会显示网页文档站。这个模式适合一边配置任务,一边在同一个窗口内查说明。

文档页会显示:

  • 标题“百科文档”。
  • 当前文档站加载状态。
  • 独立窗口按钮。
  • 加载失败提示和当前 Wiki 地址。

独立窗口

点击“独立窗口”后,Tauri 会创建一个普通系统窗口显示同一个网页文档站。主窗口会显示“已在单独窗口打开”,并提供“聚焦独立窗口”和“回到主窗口”。

独立窗口标题跟随应用语言:

  • 中文:百科文档
  • 英文:Wiki Docs

独立窗口不再使用旧的红绿灯装饰效果,而是普通系统窗口。

语言与回退

文档站只维护中文和英文。应用界面为日文、韩文、法文、德文或俄文时,文档内容回退为英文。文档站页面右上角的语言下拉框用于在中文和英文之间切换。

本地开发地址

本地开发时,文档站通常运行在:

http://localhost:3000/docs/zh/
http://localhost:3000/docs/en/

正式部署到 GitHub Pages 后,Tauri 内的网页 Wiki 地址可以切换到部署后的 URL。

加载失败排查

如果文档页一直显示加载失败:

  • 在浏览器中直接打开同一个 Wiki 地址,确认网络或本地 dev server 是否可用。
  • 如果是 GitHub Pages,确认仓库 Pages 已启用并且 NEXT_PUBLIC_BASE_PATH 与 Pages 路径一致。
  • 如果是本地开发,确认 docs 目录下的 Next dev server 正在运行。
  • 如果独立窗口可打开但内嵌窗口失败,优先检查 WebView2、网络代理和 iframe sandbox 限制。

On this page