如何翻译 Markdown 文件？-2-几种商业及开源解决方案介绍

最新推荐文章于 2024-10-02 08:15:00 发布
最新推荐文章于 2024-10-02 08:15:00 发布
阅读量1.7k 收藏 1
点赞数
文章标签： kubernetes 云原生
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/east4ming/article/details/131259261
版权

背景

近期在搭建英文博客-<e-whisper.com>, 需要对现有的所有中文 Markdown 翻译为英文。

需求如下：

  • 将 Markdown 文件从中文 (zh-CN) 翻译为英文 (en)
  • 翻译后要保留 Markdown 的完整格式
  • 部分 Markdown block 不需要翻译，如：front-matter、代码块 等

但是实际使用中，试了好几款翻译（包括 Google，DeepL，Azure）, 结果发现效果都不理想。

也找到了一些专门针对 markdown 的翻译方案，基本上都是这种方案：将 Markdown 拆分为"段".

一起看看吧。

Markdown 商业及开源解决方案

  • simpleen: 商业版
  • GT4T: 商业版
  • markdown-translator: GitHub 开源项目，基于 JavaScript 和 Azure Translate 收费 API
  • Markdown Docs Translator: GitHub 开源项目，基于 Python 和 主流免费翻译 API (Yandex/Google/Bing/Deepl)
  • ChatGPT + Prompt(markdown+翻译） ?

Simpleen

Simpleen 是个在线翻译服务，你可以通过不同的方式使用 Simpleen 来翻译和本地化你的软件： 使用在线 web 翻译器，在本地使用 CLI（连续翻译）或通过 API 自定义使用。其后端是调用 Deppl 的翻译服务。

以下是使用其翻译的效果：

Simpleen 翻译效果

可以看到，翻译除了将[toc] 翻译为 \[toc] 之外，其他都完全准确。

另外上图也可以看到，Simpleen 定位非常准确，就是针对开发者群体的，还有 Variable 相关功能。

Simpleen 一大特色功能是：Custom Translator, 如：

  • Python-i18n
  • Vue I18n
  • YAML
  • JSON
  • Markdown
  • ...

同时 Simpleen 也支持自定义词库功能，称为：Glossaries. 可以自定义个人词库。

Simpleen 就是将完整的 markdown 文档，按照 markdown 语法格式，将其拆分为一个个的 Segment. 并对每一个 Segment 进行翻译，如下：

Simpleen Segments

通过 Segments 也可以看出，Simpleen 是将上篇提到的 2 种方法结合起来实现：

  1. 将 Markdown 转换为 html
  2. 将 html 拆分为 Segments
  3. 将 Segment 逐一翻译
  4. 将翻译后的 Segment html 转换为 markdown.
Simpleen 使用总结

优点:

  • 准确度高
  • 实用的特色功能：Custom Translator
  • 实用的特色功能：Variable 支持
  • 实用的特色功能：Glossaries
  • 底层基于 Deepl, Deepl 的翻译效果是最自然的。
  • 多种使用方式：web/api/cli

缺点:

  • 贵，基于 Segment 收费，价格也贵的厉害。
    • 最便宜的月费也得 $15, 并且只有 1,000 Text Segments

Simpleen Price

GT4T

📝Reference:

GT4T 不只是又一个翻译应用。它是一个超级插件，可以帮助你在任何 Windows/Mac 窗口中使用任何语言写作；也是一个超级文件翻译器，你可以不用上传，在你自己的电脑上翻译文件。

官方宣传其特色功能有：

  • 超级插件：运行在 29 个自动翻译引擎之上。无论哪个语言，GT4T 总是能为你提供最好的自动翻译。
  • GT4T 文件翻译器：GT4T 文件翻译器可以批量翻译文件。GT4T 可以处理包括 Office 或桌面出版文档在内的 20 种文件类型。而且如果你从事翻译业务并使用 CAT 工具，你也可以使用 GT4T 来翻译 Trados 或其他 CAT 项目。也有自己的词汇表。

其在 Translate Markdown/reStructuredText/AsciiDoc/DocBook XML and other documents 这里宣称可以翻译 Markdown, 具体步骤也很详细，这里就不展开了。

但是我在实际使用中，一方面发现它是个桌面 app, 没有 api/cli, 不适合开发者的使用需求，另一方面它对 markdown 的翻译结果相比 Simpleen 准确度欠佳。

markdown-translator

使用 Azure 文本翻译 API 直接翻译 Markdown 文件

其使用的前提条件是：从 Azure 服务 获取文本翻译 API 密钥

主要是通过 CLI 的方式使用：

# install cli
npm install markdown-translator -g

# set key from Azure Text Translate API
md-translator set --key <your key>
md-translator set --region <your region>

# do translate
md-translator translate --src README.md --dest README.zh.md --to zh

# get more information
md-translator --help

也可以通过模块方式使用：

# install module
npm install markdown-translator
const markdownTranslate = require('markdown-translator')
markdownTranslate({
  src,
  // 要么
  text,

  from,
  to,
  subscriptionKey,
}).then((res) => {
  // deal with result
})

目前我的英文站：https://e-whisper.com/ 就是完全基于这种方式翻译的。大家可以去访问看一下，评价一下翻译效果怎么样。

它的实现方案也是：将 markdown 文档拆分为"段", 再进行翻译。

后端调用的是 Azure https://api.cognitive.microsofttranslator.com/ 的 3.0 的文本翻译接口。

另外 Azure 也直接支持 Markdown 文档 翻译功能。 但是价格比文本翻译略贵。

以下是我的一些感受：

优点:

  • 基于 Azure Translate API, 将 markdown 拆分为"段"后调用一次 API 获取完整翻译结果，价格可接受
  • 翻译后 Markdown 格式基本没有错误。
  • CLI 的方案结合一些脚本，可以实现批量翻译，效率很高。

比如很简单的一个脚本，实现批量翻译：

#!/bin/bash

# 遍历指定目录下的所有文件
for MD in source/_posts/*; do
    echo "------Translating ${MD}------"
    md-translator translate --from zh-CN --to en --src ${MD} --dest ${MD} 2>&1 >>logs/md-translator.log
done

缺点:

  • 基于 Azure Translate API, 我个人感觉 Azure 的翻译效果没有 Deppl 的好。
  • Markdown 内嵌的一些 front-matter 等，翻译还是存在问题。建议翻译前先将 front-matter 拿掉。
  • 可能还是 Azure Translate API 的问题，对同一个词汇前后会出现好多不同版本的翻译后词汇（没有自定义词汇表导致的）, 另外上下文也不是特别连贯。

目前的个人感受是基本可用，但是还是有一些特殊需求无法满足，后续我可能会尝试直接使用 Azure 最新提供的 Python SDK 进行开发定制。

Markdown Docs Translator

Markdown Docs Translator 是一个 Markdown 文档的自动翻译器，用 Python 构建。该工具支持多种翻译服务，并提供各种选项来定制翻译过程。

功能:

  • 支持多种翻译服务（Yandex, Google, Bing, Deepl）。
  • 多线程以加快翻译速度。
  • 覆盖原始文件、删除原始文件或用翻译文本创建一个新文件的选项。
  • 缓存以加快重复翻译。
  • 动词水平控制。

具体使用方法也是先安装再通过 CLI 使用：

pipx install md-translate
md-translate path_to_file_or_folder -F source_lang -T target_lang -P service [OPTIONS]

之前，我试用了好多次，都没有成功，可能是跟它使用的是翻译的免费接口有关，容易被封，无法提供稳定的服务。

最近看了一下，它已经改为基于 selenium 模拟浏览器的行为去访问，可能会好一些。后续有机会试试。

另外它的代码结构也很清晰明了，后续也仔细学习一下它的源码。

ChatGPT + Prompt ?

这应该也是一种思路，利用 ChatGPT 的强大能力。但是关键点在于如何提供有效的 Prompt, Prompt 可能是要强调 Markdown 语法，并利用 ChatGPT 出众的上下文理解和自然语言翻译能力给出翻译结果。

甚至还可以利用 ChatGPT 已有的能力，对文章进行进一步的润色、补充、语气调整等。

未来可期。

不过可能大量翻译的话，API 调用费用会贵上不少吧？

总结

本文很浅显地总结了一些我收集到的 markdown 文档的翻译方案。

主要是基于：将 Markdown 拆分为"段" 的思路。

或者是：将 Markdown 拆分为"段" 和 将 Markdown 翻译为 HTML 二者结合起来。

这里我了解了 4 种：

相关方案肯定很多，笔者由于精力和时间所限，无法一一列举。欢迎各位补充~

同时也结合近期 ChatGPT 的爆火，提出用 ChatGPT 翻译 markdown 的可能性。

希望对您有所帮助。

三人行, 必有我师; 知识共享, 天下为公. 本文由东风微鸣技术博客 EWhisper.cn 编写.

东风微鸣
关注
批量word markdown文档翻译软件
三维点云技术探索
08-25 137
因为平时翻译一些技术文档的需要，做了一个自己用的批量文档翻译软件，现在分享出来供大家免费使用，目前仅仅支持中英文互相翻译，支持word markdown文档。下载链接：https://pan.baidu.com/s/1WQQ8kaDilaagjoK5IrYZzA。
MrDeer:由 Java 编写的 MarkDown 翻译器
06-17
鹿先生 我将分 3 个步骤介绍 MrDeer： 什么是 MrDeer，您将在哪里使用 MrDeer。 如何获得 MrDeer 以及如何使用它。 项目的未来以及如何为 MrDeer 做出贡献。 ＃＃第一的 什么是 MrDeer，您将在哪里使用 MrDeer。 MrDeer 是 Java 编写的 MarkDown 翻译器。您可以在项目中使用 MrDeer 将 Markdown 字符串翻译成 HTML 格式的字符串。 例如，如果您想在Android上创建一个编辑器应用程序，并且您希望您的用户以MarkDown格式写笔记，您可以获取用户写的String，然后将它们放入MrDeer的M2HTranslator中，然后调用translate( ) 用于翻译的 HTML 格式字符串。然后，您可以将 HTML 字符串放在 WebView 中，WebView 将解析 HTML 元素并向用户显示 W
Free-Markdown-Translator - 免费 Markdown 翻译（Windows）
最新发布
AI + 工程
10-02 889
Free-Markdown-Translator - 免费 Markdown 翻译（Windows） 简介 功能： 安装与运行 配置 目标语言配置详情
Markdown官方文档[翻译]
lovekun_03的博客
03-16 5373
概述哲学Markdown目标是实现”易读易写”. Markdown最大的亮点在于它的可读性。一篇Markdown格式的文档可以直接以纯文档的形式发布，并且它看起来并不会由标签和格式化指令构成。尽管Markdown语法受到一些已有的text-to-html格式转换工具的影响，包括Setext, atx, Textile, reStructuredText, Grutatext, 以及EtText。Ma
MarkDown文本（md）汉化翻译脚本
iMonster
06-18 344
【代码】MarkDown文本（md）汉化翻译脚本。
Markdown *.MD 文件 技术文档 在SDL Trados Studio中翻译
dark_2001的专栏
04-19 2231
Markdown *.MD 文件 技术文档 在SDL Trados Studio中翻译 Markdown 是一种最新主流的技术文档写作格式，广泛用于API编写，在技术领域十分流行，本篇文档也是在CSDN的Markdown编辑器中撰写的。 SDL Trados 2019 SR2中新添加了Markdown解析器，对外宣布正式支持Markdown文件格式。 来看一下这个解析器，打开SDL Trados ...
markdown语法
choufengyin7439的博客
06-10 195
概述 哲学 Markdown 的目标是易读易写。 Markdown强调可读性高于一切。一份Markdown格式的文档应该能直接以纯文本方式发布，而不致一眼看过去满眼都是标签和格式化指令。Markdown的语法确实受了几种现有的text转HTML过滤器影响－－包括Setext,atx,...
前端开源库-documentation-markdown-api-theme
08-29
总的来说，"前端开源库-documentation-markdown-api-theme"是一个为前端开发者提供高质量API文档解决方案的项目，它利用Markdown的简洁性和API主题的针对性，提升了文档的可读性和实用性。无论是个人开发者还是团队...
生成完美中文编码目录列表[TOC]的终极解决方案 - 用 VSCode 写 Markdown 文档经验总结系列
热门推荐
望儿山下小苗圃的博客
11-01 1万+
用VSCode 编辑器写 Markdown 文档，如果需要生成 TOC 文件目录列表，方法不止一种。通过 MPE 插件可以实现 Markdown 文档的 TOC 目录列表自动生成，不过如果标题中含有中文字符，链接跳转就可能会失效，研究出截止目前为止最完美的中文编码目录列 TOC 生成方法。本文是写博客经验技巧大全系列的一篇，更全面的知识，请看《用 VSCode 打造宇宙最强 Markdown 编辑器》系列专题，专题分几部分详细指导打造 Markdown 编辑器全过程，包含安装设置技巧，Markdown 插件
leetcode答案-Gitbook-Algorithms:用于LeetCode算法解决方案的Gitbook
06-30
《LeetCode答案-Gitbook-Algorithms》是一本专注于LeetCode算法解决方案的开源资源，它旨在帮助程序员提升算法技能，解决实际编程挑战。LeetCode是一个知名的在线平台，提供了大量的编程题目，涵盖各种数据结构和...
代表AIGC 巅峰的ChatGPT 有哪些低成本开源方案能够复现？一张消费级显卡能不能跑出个6-7成的效果？
shiter编写程序的艺术
04-03 4498
代表AIGC 巅峰的ChatGPT 有哪些低成本开源方案能够复现？
markdown-translator:一个使用POPOT标准帮助将markdown文件翻译成其他语言的库
05-11
MarkdownTranslator 一个库，可帮助您提取和替换降价文档的原始内容，并且了解语法。 其驱动力是从降价文件生成POT文件。 然后，根据结果PO文件生成翻译后的降价文档。 这仅是库。 可能（最终）将有一个CI工具来执行诸如markdown-translator input.md output.pot和markdown-translator translation.po output.md 。
使用 ChatGPT 自动将 Markdown 文件批量翻译为多语言
02-07
python chatgpt使用 ChatGPT 自动将 Markdown 文件批量翻译为多语言
mdTranslation 是一个用于准备多语言 Markdown 文档的实用程序。
06-28
翻译mdTranslation 是一个用于准备多语言 Markdown 文档的实用程序。还有一个名为mdbook-translation的 mdBook 预处理器，用于处理 mdBook 书籍。它是如何实现这一目标的？这是通过将源内容及其翻译关联在一起来完成的。这种关联表示为特定简单格式中的单独 Markdown 文档。该文件如下所示：> Original content 1 * lang_ID1 Translated content written in lang_ID1 * lang_ID2 Translated content written in lang_ID2 **** ...该库可以读取每个叶节点（段落、列表项等）中的 Markdown 内容并将其与此处的所有原始内容进行比较，当匹配时，它将替换为相应的翻译内容。这使得在不接触原始文档的情况下进行翻译成为可能。mdTranslation CLI 工具要使用 CLI 工具，只需在终端中输入：cargo install mdtranslation-cli这允许您使用两个命令：mdtranslation_extr
MD文档维护接口文档-markdown-awesomium_v1.6.6_sdk_win.exe组件下载
03-19
window环境下安装markdownpad2，一般会出现错误：右侧html解析出错。 此时，需要安装组建：markdown-awesomium_v1.6.6_sdk_win.exe。 window环境下安装markdownpad2，一般会出现错误：右侧html解析出错。 此时，需要安装组建：markdown-awesomium_v1.6.6_sdk_win.exe。
markdown的下载awesomium sdk(解决html渲染组件出错)1.6.6 官方版
07-02
内 附上markdown的下载以后出现的awesomium v1.65已停止工作，解决的办法。awesomium sdk是一个功能丰富的开源库，软件具有多种网页渲染方式，可以直接将编写的网页渲染到任何游戏场景中，对3D游戏的背景渲染、环境渲染、游戏场景渲染等都具有很大的优势，它支持多种编程语言，支持HTML5和CSS3、JavaScript，能够自动选取符合游戏代码的编程语言进行插入，运用了目前业界速度最快的浏览器内核webkit和v8，能够很快的对插入的网页进行编排，修改，帮助用户快速建立3D游戏开源库。
Zucchini-开源
05-15
它为个人博客、企业网站或任何希望避免动态服务器端渲染的项目提供了解决方案。通过Zucchini，用户可以专注于编写内容，而无需深入学习复杂的Web开发技术。下面我们将详细探讨Zucchini的功能、工作原理以及如何利用...
Markdown For Typora 翻译
weixin_30906425的博客
07-08 341
概览 Markdown 由 Daring Fireball 创造；原指导文档在 这里。然而，与大多数解释器 / 编辑器不同的是，Typora 采用的是 Github 推荐的 Markdown。 Block 元素 段落和换行 一个段落是简单的一行或者多个的连续行。在 markdown 源码中，段落被两个或多个空白行分隔。在 Typora 中，你仅需要一个空白行即可（按一次 Return ）创建一个新...
markdown格式_协作翻译MarkDown格式规范说明
weixin_39943370的博客
11-28 258
非常感谢认领了章节的同学，请大家遵循本文的规范进行翻译，便于后期进行统一整合，再次感谢大家！我在images文件夹中上传了所有的图片，请大家先拉取图片再进行编辑。按1所指的位置进行拉取，按2确定，注意保存好自己修改的内容，不然会覆盖掉。认领了章节的同学，请新建一个md文件，文件名为 英文名中有空格的，请用下划线代替空格例如 2.Lessons_learned.md，如下图：在md文件中，...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值