保持语义流畅阅读的整段翻译

translate.group 段落翻译

它适合翻译夹有加粗、链接等行内标签的文章。
它把同一段落中的文字一起交给翻译服务,让翻译服务根据整句上下文组织译文,再把每个片段的译文写回对应的原节点。

例如:

  1. <p><b>我们</b>是<b>全世界</b>最好的</p>

可以译成 :

  1. <p><b>We</b> are the best in the <b>world</b></p>

虽然英语中的 world 移到了句尾,它仍由原来包住“全世界”的 <b> 标签显示,并尽量使整段文字阅读更通顺。
也就是,它可能会移动你原句段落中的某个标签在这段文字中的位置,来使整段翻译语句更通顺。

快速接入

比如你的页面中有如下html:

  1. <article id="article">
  2. <p><b>我们</b>是<b>全世界</b>最好的</p>
  3. <p>请阅读<a href="/guide">使用指南</a>。</p>
  4. </article>

那么你可以这样配置:

  1. const article = document.getElementById('article');
  2. translate.group.addElements(article);

addElements(article) 登记整篇文章所在的元素。

排除部分子元素

translate.group.addElements(element, ignoreFunction) 接收一个真实 DOM 元素和一个可选的过滤函数。
示例:

  1. const article = document.getElementById('article');
  2. translate.group.addElements(article, function (element) {
  3. return !element.classList.contains('no-group');
  4. });

其中,第二个参数传入了一个 function(element) 这里传入的 element 是当他进行逐级判断 article 这个传入的第一个参数的子元素的时候,判断到哪个子元素,就把这个子元素的 element 传入进第二个参数function 中,提供判断使用。

同一元素再次调用 addElements() 会更新过滤函数。要登记多篇文章区域,可以逐个传入其 DOM 元素。
登记配置可通过 translate.group.elements 查看,每项包含 element 和 ignoreFunction。

注意

  1. 需要 translate.js v4.1.39.20261118 及更高版本
  2. 设置这行要放到 translate.execute(); 上面
  3. 此能力必须是私有部署翻译服务并接入我们调优修改的翻译模型才支持这个翻译能力。