70 lines
2.9 KiB
Markdown
70 lines
2.9 KiB
Markdown
# 批处理翻译指令（baoyu-translate · quick 模式）
|
||
|
||
目标语言: zh-CN（简体中文）
|
||
模式: quick（直接翻译，不做分析/审校）
|
||
读者: technical（开发/运维工程师，通用术语不加注，生僻概念必要时加注）
|
||
风格: storytelling（叙述流畅、自然地道；同时保持技术准确性）
|
||
|
||
## 处理对象
|
||
|
||
任务文件（txt）里列出了若干个 `.md` 源文件的绝对路径。每个文件都是从 SRE Weekly 摘录的文章，结构为：
|
||
|
||
```
|
||
# 英文标题
|
||
- **期号**: SRE Weekly Issue #NNN（YYYY-MM-DD）
|
||
- **作者**: ...
|
||
- **链接**: ...
|
||
|
||
## 简介
|
||
（摘要，可能是一段话或引用）
|
||
|
||
## 正文
|
||
（文章正文，可能含 # 子标题、代码块、图片、表格、列表、链接）
|
||
```
|
||
|
||
## 对每个文件执行
|
||
|
||
1. 读取整个源文件。
|
||
2. 若文件 > 60KB，分段处理：用 read_file 的 offset/limit 或自行切片，分段翻译，每段译文用追加方式写入输出文件（先 write_file 写首段，后续段落读回+追加，或直接在内存拼好后一次性写完——只要不超上下文就行）。
|
||
3. 构造译文文件 `{源文件名去掉 .md} + "-zh.md"`，与源文件同一目录。格式：
|
||
|
||
```
|
||
# {翻译后的标题}
|
||
|
||
- **期号**: SRE Weekly Issue #NNN（YYYY-MM-DD）（保持原样，日期格式不变）
|
||
- **作者**: {保留原文作者名，可加中文机构名}
|
||
- **链接**: {原样保留}
|
||
|
||
## 简介
|
||
|
||
{简介翻译}
|
||
|
||
## 正文
|
||
|
||
{正文完整翻译}
|
||
```
|
||
|
||
4. 翻译原则：
|
||
- **重写而非直译**：像母语作者重新写一遍，读起来应是地道中文，不是翻译腔。
|
||
- **准确优先**: 事实、数据、逻辑必须与原文一致。数字、版本号、命令、路径、变量名、API 名一律照抄。
|
||
- **格式保留**: Markdown 全部保留——标题层级、加粗、斜体、列表、表格、链接、图片、引用块、代码块。代码块与行内代码的内容一律不翻译。
|
||
- **术语**: 采用通用标准译法。专业术语首次出现时用「英文（中文）」或「中文（英文）」形式标注一次。技术读者，通用术语（如 Kubernetes、Docker、SLO、latency、incident、postmortem 等）可直接用英文或常用中文，不必每次加注。
|
||
- **必要解释**: 目标读者可能缺背景的冷门概念，用加粗括号（**解释**）简短补充，宁少勿滥。
|
||
- **勿本地化图片**: 图片链接/alt 原文保留，不做图片内文字处理。
|
||
5. 不要生成任何分析/中间文件，只产出 -zh.md。
|
||
|
||
## 验收
|
||
|
||
全部文件翻译完成后，逐一核对：
|
||
- 每个源文件都有对应的 -zh.md 且已写入。
|
||
- 译文长度合理（中文通常约为源正文 char 数的 70%~100%，远低于 30% 视为漏译，需补全）。
|
||
- 标题、简介、正文三个区块齐全。
|
||
|
||
## 汇报格式（最终输出，简短）
|
||
|
||
```
|
||
完成 N 个文件
|
||
跳过: 无
|
||
失败: <路径 + 原因>
|
||
每个文件一行: <源文件> -> <译文文件> (源chars -> 译chars)
|
||
``` |