boos
e0a5f57793
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
# 翻译指南
|
||
|
||
感谢你参与文档翻译工作 — 我们非常欢迎贡献！下面是推荐的翻译流程（目前我们主要支持 `zh`）：
|
||
|
||
## 基本流程
|
||
|
||
1. 从 `docs/guide/` 复制英文页面到 `docs/zh/guide/` 并保持文件名一致。
|
||
2. 翻译文案，注意保持代码块、front-matter（如果存在）和链接（指向其他中文页面时请加 `/zh/` 前缀）。
|
||
3. 在本地运行 docs：
|
||
|
||
```bash
|
||
pnpm docs:dev
|
||
# 或者
|
||
pnpm docs:build
|
||
```
|
||
|
||
4. 提交 PR，并标注 `docs` 和 `i18n`（可选）。
|
||
|
||
## 链接处理
|
||
|
||
- 指向其他文档的链接在中文页面中，请使用中文路径：例如 `(/zh/guide/quick-start)`。
|
||
- 对外部链接无需更改。
|
||
|
||
## 风格与口吻
|
||
|
||
- 对技术名词保持一致翻译（例如 Monaco、Mermaid、KaTeX 等），不确定时可保留英文原词并在括号中加入译名。
|
||
- 代码示例不要改动语法，只翻译周边解释文字。
|
||
|
||
## 本地预览与校验
|
||
|
||
- 使用 `pnpm docs:dev` 本地预览，顶部右侧可以切换语言。
|
||
- 确认导航（sidebar）是否正常显示中文页面。
|
||
|
||
## PR 检查清单
|
||
|
||
- [ ] 翻译文件放置在 `docs/zh/guide/` 并保持文件名一致
|
||
- [ ] 指向其他文档的链接指向对应 `zh` 页面
|
||
- [ ] `pnpm docs:build` 可以成功构建
|
||
- [ ] PR 描述中文翻译范围与说明
|
||
|
||
如果你希望我添加 GitHub Action，自动检查 PR 翻译或链接问题，我可以继续添加这项功能。再次感谢你的贡献！
|