book-translation

图书翻译技能

此技能指导如何为 prompts.chat 上的 The Interactive Book of Prompting 翻译图书内容。

概述

本书分为 7 个部分，共有 29 章。翻译需要处理：

1. MDX 内容文件 —— src/content/book/{locale}/ 中的完整章节内容
2. JSON 翻译键 —— messages/{locale}.json 中的 UI 字符串、章节标题和简介

前提条件

开始前，请确认：

• 目标区域代码（例如 de、fr、es、ja、ko、zh）
• 检查 messages/ 目录中是否已有该区域
• 检查是否存在 src/content/book/{locale}/ 文件夹

步骤 1：复制土耳其语文件夹作为基础

土耳其语（tr）翻译已经完成并经过充分测试。请复制它作为起点，而不是从英文翻译：

mkdir -p src/content/book/{locale}
cp -r src/content/book/*.mdx src/content/book/{locale}/
cp src/components/book/elements/locales/en.ts src/components/book/elements/locales/{locale}.ts

⚠️ 重要：复制后，必须在 src/components/book/elements/locales/index.ts 中注册新区域：

1. 添加导入：import {locale} from "./{locale}";
2. 添加到 locales 对象：{locale},
3. 添加到具名导出：export { en, tr, az, {locale} };

这样做更快，因为：

• 土耳其语与许多语言的句子结构相似
• 所有 JSX/React 组件都已正确保留
• 文件结构已准备就绪
• 你只需翻译正文，无需重新创建结构

步骤 2：翻译 MDX 内容文件

编辑 src/content/book/{locale}/ 中复制的每个文件，将内容从土耳其语翻译为目标语言。

逐个处理文件：

章节列表（按顺序）

Slug	英文标题
00a-preface	前言
00b-history	历史
00c-introduction	引言
01-understanding-ai-models	了解 AI 模型
02-anatomy-of-effective-prompt	有效提示词的构成
03-core-prompting-principles	提示词的核心原则
04-role-based-prompting	基于角色的提示词
05-structured-output	结构化输出
06-chain-of-thought	思维链
07-few-shot-learning	少样本学习
08-iterative-refinement	迭代优化
09-json-yaml-prompting	JSON 和 YAML 提示词
10-system-prompts-personas	系统提示词与角色设定
11-prompt-chaining	提示词链
12-handling-edge-cases	处理边缘情况
13-multimodal-prompting	多模态提示词
14-context-engineering	上下文工程
15-common-pitfalls	常见误区
16-ethics-responsible-use	伦理与负责任的使用
17-prompt-optimization	提示词优化
18-writing-content	写作与内容创作
19-programming-development	编程与开发
20-education-learning	教育与学习
21-business-productivity	商业与效率
22-creative-arts	创意艺术
23-research-analysis	研究与分析
24-future-of-prompting	提示词的未来
25-agents-and-skills	Agent 与技能
27-tools-mcp-connectors	工具、MCP 与连接器
26-the-harnesses	Harness
28-persistent-bots	常驻机器人：持续工作的 Agent

MDX 翻译指南

1. 保留所有 JSX/React 组件 —— 保持 <div>、<img>、className 等不变
2. 保留代码块 —— 代码示例应保留英文（变量名、关键字）
3. 翻译正文内容 —— 标题、段落、列表
4. 保留 Markdown 语法 —— ##、**bold**、*italic*、[links](url)
5. 保留组件导入 —— 文件顶部的所有 import 语句

步骤 3：翻译 JSON 键

在 messages/{locale}.json 中翻译 "book" 部分。主要包括：

图书元数据

"book": {
  "title": "The Interactive Book of Prompting",
  "subtitle": "An Interactive Guide to Crafting Clear and Effective Prompts",
  "metaTitle": "...",
  "metaDescription": "...",
  ...
}

章节标题（book.chapters）

"chapters": {
  "00a-preface": "Preface",
  "00b-history": "History",
  "00c-introduction": "Introduction",
  ...
}

章节简介（book.chapterDescriptions）

"chapterDescriptions": {
  "00a-preface": "A personal note from the author",
  "00b-history": "The story of Awesome ChatGPT Prompts",
  ...
}

部分名称（book.parts）

"parts": {
  "introduction": "Introduction",
  "foundations": "Foundations",
  "techniques": "Techniques",
  "advanced": "Advanced Strategies",
  "bestPractices": "Best Practices",
  "useCases": "Use Cases",
  "conclusion": "Conclusion"
}

交互式演示示例 (book.interactive.demoExamples)

本地化演示示例文本（分词器示例、温度示例等）：

"demoExamples": {
  "tokenPrediction": {
    "tokens": ["The", " capital", " of", " France", " is", " Paris", "."],
    "fullText": "The capital of France is Paris."
  },
  "temperature": {
    "prompt": "What is the capital of France?",
    ...
  }
}

书籍元素语言环境（必需）

⚠️ 请勿跳过此步骤——否则交互式演示将无法在新语言中正常运行。

翻译 src/components/book/elements/locales/{locale}.ts 中的语言环境数据文件：

• 温度示例、Token 预测、嵌入词
• 能力列表、示例对话、策略
• 分词器示例、构建器字段、链类型
• 框架（CRISPE、BREAK、RTF）、练习
• 图像／视频提示词选项、验证演示

然后在 src/components/book/elements/locales/index.ts 中注册：

import {locale} from "./{locale}";

const locales: Record<string, LocaleData> = {
  en,
  tr,
  az,
  {locale},  // Add your new locale here
};

export { en, tr, az, {locale} };  // Add to exports

UI 字符串（book.interactive.*、book.chapter.*、book.search.*）

翻译所有交互式组件标签和导航字符串。

第 4 步：验证翻译

1. 运行检查脚本：

   node scripts/check-translations.js
   

2. 启动开发服务器并测试：

   npm run dev
   

3. 使用目标语言环境访问 /book，验证内容是否加载

参考：英文翻译

英文（en）翻译已完成，可作为所有新翻译的基础模板：

• MDX 文件：src/content/book/*.mdx——将此文件复制到 src/content/book/{locale}/*.mdx
• JSON 键：messages/en.json → book 部分——参考其结构

推荐工作流

1. 将 src/content/book/*.mdx 复制到 src/content/book/{locale}/*.mdx
2. 将 messages/en.json 中的 "book" 部分复制到 messages/{locale}.json。请分多个 Agent 会话翻译，而不要一次性完成（一次翻译可能超出 Token 限制）
3. 编辑每个文件，将英文翻译成目标语言
4. 保留所有 JSX 组件、代码块和 Markdown 语法

质量指南

• 一致性：全文使用一致的术语（例如，始终以相同方式翻译“prompt”）
• 技术术语：某些术语（如“AI”“ChatGPT”“API”）可以保留英文
• 文化适配：在适当情况下调整示例，使其符合目标受众的实际情况
• 自然语言：优先采用自然流畅的译文，而非字面直译