使用指南
网页 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 限制。