跳到正文

句式、语法与校对

写清动作主体、条件和先后关系,消除模糊指代以及容易误读的否定和范围。

用完整的条件和动作组织句子

把容易漏看的限制放在动作前,例如“启用了离线搜索时,构建输出需要包含索引文件”。动作有明确主体时写出主体,例如“浏览器从静态目录加载索引”。需要判断先后时,用“保存后”“重新加载时”标明顺序。

遇到多层条件时,把可以独立判断的条件写成多条。复查“与”和“或”的关系。例如,“启用了标题索引且输出目录可写”要求两项同时满足。“改用系统生成的路径或手动指定路径”描述同一个任务的两种入口。

容易误读的表述改写
启用工具后它会加载它。启用搜索后,浏览器加载索引文件。
配置要么可选,除非要自定义。使用默认输出路径时可以省略此配置。
保存并在文件存在时重试构建。保存配置。确认输出目录存在后,再次构建。
超过 100 条时截断到 100 条以内。超过 100 条时保留排序后的前 100 条。

把长句拆成可逐条核对的事实

一句话同时解释默认值、触发条件和异常时,可拆成三句。例如,“默认写入 search-index.json。设置了 search.output 时使用指定路径。目标目录不可写时构建失败。”这样也便于译者逐项对照原文。

校对时检查否定的作用范围。“未生成索引时禁用搜索”陈述缺失条件触发的行为。“禁用索引生成”则是设置项的动作。遇到“仅”“首次”“至少”“最多”这类词时,标出它们修饰的对象。

校对正文和代码中的拼写

用站内搜索对照术语表和邻近页面。把代码标识符、引号里的界面字样、版本号和路径逐一对照真实来源。中文拼写检查可能把产品名或技术词标成疑似错误,可以按文档质量检查逐项确认。