FreeBSD 官方手册（FreeBSD Handbook）的中文翻译项目，基于 GitBook 格式，发布在 https://handbook.bsdcn.org。
翻译基准为 FreeBSD 最新 RELEASE 版本，英文原版见 https://docs.freebsd.org/en/books/handbook/book/。
- ✅ 第 1-34 章翻译完成
- ✅ 全部章节校对完成（2026.6.2）
目前持续进行质量改进和英文原版同步。
本项目基于 GitBook 格式，可通过 GitBook 平台或本地工具预览：
# 安装 GitBook CLI
npm install -g gitbook-cli
# 本地预览
gitbook serveHandbook/
├── SUMMARY.md # 全书目录结构（GitBook 数据源）
├── CHANGELOG.md # 编辑日志和翻译进度
├── yi-zhe-shuo-ming.md # 术语翻译对照表
├── qian-yan/ # 前言
├── di-1-zhang-*/ # 第 1 章
├── di-2-zhang-*/ # 第 2 章
├── ...
├── di-34-zhang-*/ # 第 34 章
└── fu-lu-*/ # 附录
欢迎社区通过 PR 贡献力量！请遵循以下规范：
- 术语一致性：参考 术语翻译对照表
- CJK 空格：中英文、中文与数字之间必须加半角空格
- 命令行前缀：
#表示 root 权限，$表示普通用户 - 禁止 HTML：本项目不支持任何 HTML 语法
- 文件命名：使用拼音 slug，禁止空格、中文字符或英文冒号
重要： 章节标题必须通过 SUMMARY.md 修改，直接编辑 .md 文件的 # 标题 会被 CI 覆盖。
- Fork 本仓库
- 创建特性分支：
git checkout -b fix/chapter-X-translation - 提交修改：
git commit -m "fix: 修正第 X 章翻译错误" - 推送分支：
git push origin fix/chapter-X-translation - 创建 Pull Request
- 打开 英文原版 对照阅读
- 逐句检查翻译，重点关注：事实性错误、漏译、表达生硬、版本过时
- 修改后提交 PR，描述中列出修改原因
- 官方原址： https://docs.freebsd.org/en/books/handbook/
- 中文发布： https://handbook.bsdcn.org
- 编辑日志： CHANGELOG.md
- 术语对照： yi-zhe-shuo-ming.md
- 旧版存档： https://www.alipan.com/s/9rUaCHKauvC
本项目遵循 BSD 2-Clause 许可证。
感谢所有为本项目贡献翻译和校对工作的社区成员！