翻译风格基准

本页记录本项目书籍翻译与校对时采用的统一口径。后续翻译应优先保持每本书自身已经形成的术语和语气；当局部章节风格不一致时，以本页为校对基准。

基本原则

• 译文面向个人学习和研究，优先准确、清晰、可复查，不追求口语化改写。
• 保留章节、图表、代码清单、术语索引和参考文献的原始结构；必要时只调整 Markdown 表达方式。
• 技术术语首次出现时可采用“中文（English term）”形式，后文优先使用中文或社区通行英文名。
• 程序语言关键字、API、类型、函数名、命令、文件名和协议名使用反引号。
• 不在正文中保留“好的，以下是……”“我将……”等对话式或生成过程痕迹。

标点与格式

• 中文正文使用全角标点；英文术语括注使用半角括号或遵循该书已有风格，不在中英文标点之间加入多余空格。
• 章节标题建议使用“第 N 章 标题（English Title）”或该书既有格式，但同一本书内应保持一致。
• 图表说明统一译为“图 N.M ……”“表 N.M ……”；不要混用未翻译的 Fig. 前缀。
• 图片路径使用 /img/...，并确认对应资源存在于 static/img/...。
• 代码块中的原始代码尽量保持不改；只在已有注释翻译明显错误时校正注释。

术语处理

• transaction 译为“事务”，lock 按上下文译为“锁”或“加锁”，record 在数据库上下文译为“记录”。
• file system 译为“文件系统”，inode 在 BeFS 相关章节统一写作 i-node 或“i-node（索引节点）”。
• extent 在文件系统上下文译为“区段”，如需说明可补“块区间（block run）”。
• process 在 Elixir/Erlang 上下文译为“进程”，不要误译为操作系统线程。

校对流程

每次完成一个校对批次或章节翻译后，至少运行：

pnpm translation:qa
pnpm typecheck
pnpm build

只有验证通过后，才将该批次作为完成状态提交。