第24课：本地化写作

本地化写作：走向全球

本地化的目标不是"翻译正确"，而是"读者感觉这是用自己语言写的"。

# 本地化写作：走向全球

## 核心要点
本地化的目标不是"翻译正确"，而是"读者感觉这是用自己语言写的"。

## 实施步骤
1. 分析现状：识别本地化写作：走向全球中需要改进的关键领域
2. 制定方案：选择最适合的方法和工具
3. 逐步实施：小步迭代，持续验证
4. 评估效果：量化改进，记录经验
5. 分享推广：将成功经验标准化

## 检查清单
□ 明确目标和范围
□ 分析受众和需求
□ 选择合适的方法和工具
□ 制定实施计划和时间线
□ 执行并验证每一步
□ 收集反馈并持续优化

本地化vs国际化

i18n、l10n、g11n的区别和关系。

# 本地化vs国际化

## 核心要点
i18n、l10n、g11n的区别和关系。

## 实施步骤
1. 分析现状：识别本地化vs国际化中需要改进的关键领域
2. 制定方案：选择最适合的方法和工具
3. 逐步实施：小步迭代，持续验证
4. 评估效果：量化改进，记录经验
5. 分享推广：将成功经验标准化

## 检查清单
□ 明确目标和范围
□ 分析受众和需求
□ 选择合适的方法和工具
□ 制定实施计划和时间线
□ 执行并验证每一步
□ 收集反馈并持续优化

国际化写作原则

控制源语言复杂度、使用占位符而非拼接、UI文本外部化。

# 国际化写作原则

## 核心要点
控制源语言复杂度、使用占位符而非拼接、UI文本外部化。

## 实施步骤
1. 分析现状：识别国际化写作原则中需要改进的关键领域
2. 制定方案：选择最适合的方法和工具
3. 逐步实施：小步迭代，持续验证
4. 评估效果：量化改进，记录经验
5. 分享推广：将成功经验标准化

## 检查清单
□ 明确目标和范围
□ 分析受众和需求
□ 选择合适的方法和工具
□ 制定实施计划和时间线
□ 执行并验证每一步
□ 收集反馈并持续优化

翻译工作流

提取→上传→翻译→审校→下载→集成→测试的完整流程。

# 翻译工作流

## 核心要点
提取→上传→翻译→审校→下载→集成→测试的完整流程。

## 实施步骤
1. 分析现状：识别翻译工作流中需要改进的关键领域
2. 制定方案：选择最适合的方法和工具
3. 逐步实施：小步迭代，持续验证
4. 评估效果：量化改进，记录经验
5. 分享推广：将成功经验标准化

## 检查清单
□ 明确目标和范围
□ 分析受众和需求
□ 选择合适的方法和工具
□ 制定实施计划和时间线
□ 执行并验证每一步
□ 收集反馈并持续优化

文化适配

日期和时间、数字和货币、图标和颜色的文化差异。

本地化文档写作

核心文档翻译优先级、自动翻译+人工审校、社区翻译模式。

深入实践：本地化写作的进阶技巧

掌握了本地化写作的基础知识后，以下是一些进阶技巧，帮助你从"会用"提升到"精通"。这些技巧来自业界最佳实践和资深技术写作者的经验总结。

技巧一：建立反馈循环

本地化写作不是一次性的工作，而是持续迭代的过程。建立反馈循环是持续改进的关键。具体方法包括：在文档中嵌入反馈按钮，定期分析搜索数据，每季度进行读者满意度调查，以及建立文档评分系统。这些数据将帮助你识别哪些内容需要改进、哪些内容缺失、哪些内容过时。

技巧二：文档即代码

将本地化写作的产出物纳入代码管理流程。使用Git管理文档版本，与代码同步发布。在CI/CD流水线中加入文档质量检查。这样做的好处是：文档变更有迹可循，多人协作不会冲突，发布时文档和代码同步更新。

技巧三：建立文档风格指南

为团队建立统一的本地化写作风格指南，包含：术语表、格式规范、写作原则、代码示例规范、好/坏对比示例库。风格指南是团队协作的基石——没有它，不同人写的文档风格各异，读者体验割裂。

# 团队风格指南关键部分

## 1. 术语表
| 中文 | 英文 | 缩写 | 使用规则 |
|------|------|------|----------|
| 数据库 | Database | DB | 全文统一用"数据库" |
| 缓存 | Cache | - | 全文统一用"缓存" |
| 请求 | Request | - | 全文统一用"请求" |

## 2. 格式规范
- 标题：H2用于主章节，H3用于子章节
- 列表：>3项用列表，<=3项用行内
- 代码：必须标注语言
- 图片：必须有alt文本

## 3. 写作原则
- 简洁：每句不超过30字
- 主动语态
- 现在时
- 直接面对读者

## 4. 代码示例规范
- 必须可运行
- 包含必要import
- 标注预期输出
- 高亮关键行

技巧四：度量和持续改进

为本地化写作建立度量体系，用数据驱动持续改进。核心指标包括：文档覆盖率（功能/文档比）、文档准确率（技术评审通过率）、读者满意度（评分系统）、文档使用率（PV和停留时间）。每个指标设置目标值，定期追踪，识别差距，制定改进计划。

工具推荐与资源

以下是本课相关的工具推荐和学习资源，帮助你将所学知识快速落地实践。

必用工具

推荐阅读

• 《Developing Quality Technical Information》— IBM技术写作团队的经验总结
• 《Docs for Developers》— 开发者视角的文档写作指南
• 《Docs-Driven Development》— 文档驱动开发的方法论
• Google Developer Documentation Style Guide — 行业标准风格指南
• Write the Docs 社区 — 全球技术写作者社区

下一步行动

学完本课后，建议你立即执行以下行动：

1. 选取一个你正在写的文档，用本课的原则重新审视
2. 找出3个可以立即改进的点
3. 在下一个工作日实施改进
4. 记录改进前后的对比（读者反馈、数据变化）