# DocuTranslate - 交互式文档翻译

#### DocuTranslate

##

自动选择工作流

##

插入模式
选择如何将翻译后的文本插入。
分隔符
当插入模式为附加或前置时，用于分隔原文和译文的字符。`\n` 代表换行。

##

插入模式
选择如何将翻译后的文本插入。
分隔符
附加模式下译文会另起一段。此项用于在原文和译文段落之间添加额外内容。`\n` 可在分隔符内部换行。

##

插入模式
选择如何将翻译后的文本插入到单元格中。
分隔符
当插入模式为附加或前置时，用于分隔原文和译文的字符。`\n` 代表换行。
翻译区域 (可选)

##

插入模式
选择如何将翻译后的文本插入。
分隔符
当插入模式为附加或前置时，用于分隔原文和译文的字符。`\n` 代表换行。

##

插入模式
选择如何将翻译后的文本插入。
分隔符
附加模式下译文会另起一段。此项用于在原文和译文区块之间添加额外内容。`\n` 可在分隔符内部换行。

##

插入模式
选择如何将翻译后的文本插入。
分隔符
附加模式下译文会另起一段。此项用于在原文和译文区块之间添加额外内容。`\n` 可在分隔符内部换行。

##

插入模式
选择如何将翻译后的文本插入。
分隔符
当插入模式为附加或前置时，用于分隔原文和译文的字符。`\N` 是ASS格式的换行符。

##

需要翻译的JSON路径
采用`jsonpath-ng`的路径选择语法，每一行表示一个json路径。 将翻译路径匹配对象内的所有字符串

##

解析引擎
如果上传的文件本身是.md格式，此项可不选。
Mineru Token
Mineru 模型版本
mineru VLM是更新的内测模型。
公式识别
代码识别

##

跳过翻译
选择平台
Base URL: ``
API 地址 (Base URL)
API Key
模型ID
启用系统代理

##

目标语言
思考模式
启用 禁用(推荐) 默认
自定义Prompt
分块大小:
并发数:
Temperature:
重试次数:

##

术语表 (可选)
选择一个或多个CSV文件。文件需包含'src'和'dst'两列标题，分别代表原文和译文。
自动生成术语表
自定义Prompt
生成术语表配置
与翻译配置相同 自定义
选择平台
Base URL: ``
API 地址 (Base URL)
API Key
模型ID
目标语言
分块大小:
并发数:
Temperature: 0.7
重试次数:
思考模式
启用 禁用(推荐) 默认
启用系统代理

GitHub主页(欢迎star❤):
https://github.com/xunbu/docutranslate

交流QQ群: 1047781902

version:

#### 任务列表

当前没有任务，点击“新建任务”开始吧！

##### 预览

###### 原文

###### 译文

##### 使用教程

视频教程可以在B站搜索 docutranslate 获取。

欢迎使用 DocuTranslate！请按照以下步骤完成文档翻译：

1. 第一步：选择工作流

   在左侧配置面板的顶部，首先选择最适合您文件类型的处理流程。

   提示: 默认已开启“自动选择工作流”。您只需上传文件，系统会自动为您匹配合适的工作流，简化操作。
   - 转Markdown再翻译: 适用于翻译PDF、markdown、图片等文件。这是最通用和强大的模式。
   - 纯文本翻译: 用于翻译 `.txt` 纯文本文件。
   - EPUB翻译: 用于翻译 `.epub` 电子书文件。
   - DOCX翻译: 用于翻译 `.docx` Word文档。
   - XLSX翻译: 用于翻译 `.xlsx` 或 `.csv` 电子表格文件。
   - SRT字幕翻译: 用于翻译 `.srt` 字幕文件。
   - ASS字幕翻译: 用于翻译 `.ass` 特效字幕文件。
   - JSON翻译: 用于翻译 `.json` 文件中的特定字段。
   - HTML翻译: 用于翻译 `.html` 网页文件。
2. 第二步：配置参数

   选择工作流后，下方会显示相关的配置选项。请依次完成设置（所有配置都会自动保存在您的浏览器中）：

   A. 工作流特定选项 (根据您第一步的选择出现):

   - 如果选择“转Markdown再翻译”，请配置 解析配置：
     - 解析引擎: 选择一个引擎将您的文件（如PDF）转换为适合翻译的Markdown格式。如果您的文件已经是Markdown格式，则无需选择。
     - Mineru Token: 如果您选择 `minerU` 引擎，需要在此处填入您的Token。
   - 如果选择“纯文本/DOCX/XLSX/SRT/ASS/EPUB/HTML”，请配置其 翻译选项：
     - 插入模式: 定义翻译结果如何放入文档。您可以选择直接“替换”原文，或是在原文之后“附加”，或是在原文之前“前置”。
     - 分隔符: 当选择“附加”或“前置”模式时，此项用于在原文和译文之间插入分隔符（例如ASS格式常用 `\N`，EPUB格式常用 `<br />` 作为换行分隔符）。
   - 如果选择“JSON翻译”，请配置 JSON路径：
     - 需要翻译的JSON路径: 每行输入一个 JSONPath 表达式，将翻译所有与路径匹配的对象中的字符串。例如:`$.*`(翻译全部字符串)，`$..description`(翻译所有键为`description`的值)。

   B. 通用选项 (适用于所有工作流):

   - 翻译模型:
     - 选择平台/API 地址/API Key/模型ID: 配置您希望使用的AI翻译服务。模型能力指令遵循越强，出错、漏翻的概率越低。
     - 跳过翻译: 勾选此项后，将只执行文档解析和格式转换，不调用AI进行翻译。
   - 翻译配置:
     - 目标语言: 指定翻译的目标语言。
     - 自定义Prompt: 可选，添加额外指令，如“人名保持原文不翻译”。
     - 思考模式: 针对部分支持混合推理的模型进行设置，建议选择“禁用(推荐)”。
     - 分块大小/并发数等: 高级参数，用于调整性能和API请求行为，通常保持默认即可。
   - 术语表:
     - 上传术语表 (可选): 上传CSV文件（需包含'src'和'dst'列）来保证特定术语翻译的统一性和准确性。
     - 自动生成术语表: 启用后，程序会先从原文中提取术语并生成一个术语表，然后再进行翻译。
3. 第三步：上传文件

   在右侧的任务列表中，点击或拖拽您的文档到文件上传区域。

4. 第四步：开始翻译

   文件选择成功后，点击任务卡片右下角的 开始翻译 按钮。系统将开始处理任务，您可以在日志区域查看实时进度。

5. 第五步：查看与下载

   翻译完成后，任务卡片下方会出现操作按钮：

   - 预览: 在右侧滑出的面板中进行原文和译文的对照预览。
   - 下载: 下载包括 PDF, DOCX, Markdown 等多种格式的译文。
   - 附件: 如果翻译过程中生成了附加文件（如自动生成的术语表），可在此处下载。

重要提示: 所有配置都会自动保存在您的浏览器本地，方便下次使用。您也可以使用新增的“导出配置”和“导入配置”按钮来备份和恢复您的设置。

##### 感谢贡献

DocuTranslate是一个开源项目！大家的需求与使用是项目进步的动力。

感谢所有资助项目、提交代码与宝贵建议及给项目star的朋友们！

欢迎通过以下方式参与贡献：

github 主页 提交 Pull Request 报告 Issue

或者通过QQ群联系作者：1047781902

##### 当前术语表

原文 (src) | 译文 (dst)
--- | ---