translate

README

<h1 align="center">
    translate.js
</h1>
<h4 align="center">
    AI i18n，两行js实现html全自动翻译。 <br/>
    交给AI，无需改动页面、无语言配置文件、无API Key、对SEO友好！
</h4> 
<h4 align="center">
    简体中文 | 
    <a href="http://translate.zvo.cn/index.html?language=chinese_traditional">繁體中文</a> | 
    <a href="http://translate.zvo.cn/index.html?language=english">English</a> | 
    <a href="http://translate.zvo.cn/index.html?language=japanese">日語</a> | 
    <a href="http://translate.zvo.cn/index.html?language=russian">Русский</a> | 
    <a href="http://translate.zvo.cn/index.html?language=german">deutsch</a> | 
    <a href="http://translate.zvo.cn/index.html?language=french">Français</a> 
</h4> 

# 特性说明
* **使用极其简单。** 直接加入几行 JavaScript 代码即可让其拥有上百种语言切换能力，不增加工作量，无需改造页面本身植入大量垃圾代码变得臃肿，也不需要配置各种语种的语言文件，因为它会直接扫描你的DOM自动识别并翻译显示，它不需要你到某某网站登录去申请什么key，它是开源开放的，拿来就能用。
* **极其灵活扩展。** 您可指定它[只翻译某些指定区域的元素](http://translate.zvo.cn/4063.html)、[自定义切换语言方式及美化](http://translate.zvo.cn/4056.html)、[某些id、class、tag不被翻译](https://translate.zvo.cn/4061.html)、[自定义翻译术语](https://translate.zvo.cn/4070.html)、[自动根据用户的语言喜好及所在的国家切换到这个语种进行浏览](http://translate.zvo.cn/4065.html)、 ...... 只要你想的，它都能做到。做不到的，你找我我来让它做到！
* **极速翻译能力。** [采用多线程加速，内置三层缓存、预加载机制、文本预处理清洗等，提供毫秒级瞬间翻译的能力。](http://translate.zvo.cn/4026.html)
* **永久开源免费。** 采用MIT开源协议，您可永久免费使用。[另外你可以用它来做某些系统的三方插件、浏览器插件...等等，进行售卖盈利](http://translate.zvo.cn/4036.html)
* **搜索引擎友好。** 完全不影响你本身网站搜索引擎的收录。爬虫所爬取的网页源代码，它不会对其进行任何改动，你可完全放心。
* **支持私有部署。** [在某些政府机关及大集团内部项目中，对数据隐私及安全保密有强要求场景、或者完全不通外网的场景，可以自行私有部署翻译API服务](http://translate.zvo.cn/391129.html) 
* **全球网络节点。** 美洲、亚洲、欧洲 ... 都有网络节点，它能自动适配最快节点，每间隔1分钟自动获取一次延迟最小的节点进行接入使用，使全球范围使用都可高效稳定。



# 体验
### 拿别人的网站试试效果  

![效果](http://cdn.weiunity.com/site/341/news/9a7228aaae28475996da9026b93356c8.gif "")

1. 随便打开一个网页
2. 右键 - 审查元素
3. 粘贴入以下代码：	  
	```` var head= document.getElementsByTagName('head')[0];  var script= document.createElement('script');  script.type= 'text/javascript';  script.src= 'https://res.zvo.cn/translate/inspector_v2.js';  head.appendChild(script);  ````
4. Enter 回车键 ， 执行
5. 在当前网页的左上角，就出现了一个大大的切换语言，切换试试看。

### 在线体验Demo
http://res.zvo.cn/translate/demo.html


# 使用

### 快速接入
在网页最末尾， ````</html>```` 之前，加入以下代码，一般在页面的最底部，就会选择语言的 select 切换标签 ：

````
<script src="https://res.zvo.cn/translate/translate.js"></script>
<script>
translate.language.setLocal('chinese_simplified'); //设置本地语种（当前网页的语种）。如果不设置，默认自动识别当前网页显示文字的语种。 可填写如 'english'、'chinese_simplified' 等
translate.service.use('client.edge'); //设置机器翻译服务通道，相关说明参考 http://translate.zvo.cn/545867.html
translate.listener.start(); //开启页面元素动态监控，js改变的内容也会被翻译，参考文档： http://translate.zvo.cn/4067.html
translate.execute();//完成翻译初始化，进行翻译
</script>
````


### 更深入使用

1. [快速使用 - 让你最快看到效果，了解它翻译的原理](http://translate.zvo.cn/532777.html)  
1. [常见问题 - 我有多个页面，怎么都能每个页面都能翻译](http://translate.zvo.cn/547814.html)  
1. [最优体验 - 打开新页面后先显示原文1秒然后再显示译文，如何不显示原文？](http://translate.zvo.cn/549731.html)  
1. [项目上线 - 更换更稳定响应更快翻译更好的大模型翻译通道](http://translate.zvo.cn/545867.html)  

它支持极其丰富的微调扩展方式，可参考下面的**微调指令**

### AI自动帮你接入到你当前的项目
我们专为此研发了AI编程工具，可帮你完成自动接入！你不再需要看文档，不再需要写代码。   
使用视频示例（1分钟）：  ![效果](http://video.leimingyun.com/codepanel/CodePanel_TranslateJs.mov "")
视频示例下载： [http://video.leimingyun.com/codepanel/CodePanel_TranslateJs.mov](http://video.leimingyun.com/codepanel/CodePanel_TranslateJs.mov)  
AI编程工具下载，当前适配 Windows 10/11 ，下载地址： [http://d.leimingyun.com/CodePanel-TranslateJs.zip](http://d.leimingyun.com/CodePanel-TranslateJs.zip)

### 微调指令
它有极其丰富的扩展指令，让你可以对它进行各种精准控制，满足各种难缠客户的各种脑洞要求。（如果满足不了，可提出来，我们加）

* **[切换语言select选择框的自定义设置](https://translate.zvo.cn/41541.html)**，设置切换语言选择框位置、CSS美化、是否出现、显示的语种、触发后的自定义、以及重写等。
* **[设置默认翻译为什么语种进行显示](http://translate.zvo.cn/4071.html)**，用户第一次打开时，默认以什么语种显示。
* **[自定义翻译术语](http://translate.zvo.cn/41555.html)**，如果你感觉某些翻译不太符合你的预期，可进行针对性的定义某些词或句子的翻译结果，进行自定义术语库
* **[翻译完后自动触发执行](http://translate.zvo.cn/4069.html)**，当翻译完成后会自动触发执行您的某个方法，以便您来做自定义扩展。
* **[指定翻译服务接口](http://translate.zvo.cn/4068.html)**，如果你不想用我们开源免费的翻译服务接口，使用您自己私有部署的、或者您自己二次开发对接的某个翻译服务，可通过此来指定自己的翻译接口。
* **[监控页面动态渲染的文本进行自动翻译](http://translate.zvo.cn/4067.html)**，如果页面用 JavaScript 的地方比较多，内容都是随时用JS来控制显示的，比如 VUE、React 等框架做的应用，它可以实时监控DOM中文字的变动，当发生变动后立即识别并进行翻译。
* **[设置本地语种（当前网页的语种）](http://translate.zvo.cn/4066.html)**，手动指定当前页面的语言。如果不设置，它会自动识别当前网页的文本，取当前网页文本中，出现频率最高的语种为默认语种。
* **[自动切换为用户所使用的语种](http://translate.zvo.cn/4065.html)**，用户第一次打开网页时，自动判断当前用户所使用的语种、以及所在的国家，来自动进行切换为这个语种。
* **[主动进行语言切换](http://translate.zvo.cn/4064.html)**，开放一个方法提供程序调用，只需传入翻译的目标语言，即可快速切换到指定语种
* **[只翻译指定的元素](http://translate.zvo.cn/4063.html)**，指定要翻译的元素的集合,可传入一个或多个元素。如果不设置此，默认翻译整个网页。
* **[翻译时忽略指定的id](http://translate.zvo.cn/4062.html)**，翻译时追加上自己想忽略不进行翻译的id的值，凡是在这里面的，都不进行翻译，也就是当前元素以及其子元素都不会被翻译。
* **[翻译时忽略指定的class属性](http://translate.zvo.cn/4061.html)**，翻译时追加上自己想忽略不进行翻译的class标签，凡是在这里面的，都不进行翻译，也就是当前元素以及其子元素都不会被翻译。
* **[翻译时忽略指定的tag标签](http://translate.zvo.cn/4060.html)**，翻译时追加上自己想忽略不进行翻译的tag标签，凡是在这里面的，都不进行翻译，也就是当前元素以及其子元素都不会被翻译。
* **[翻译时忽略指定的文字不翻译](http://translate.zvo.cn/283381.html)**，翻译时追加上自己想忽略不进行翻译的文字(支持配置字符串和正则表达式)，凡是在这里面的，都不进行翻译。
* **[对网页中图片进行翻译](http://translate.zvo.cn/4055.html)**，在进行翻译时，对其中的图片也会一起进行翻译。
* **[鼠标划词翻译](http://translate.zvo.cn/4072.html)**，鼠标在网页中选中一段文字，会自动出现对应翻译后的文本
* **[获取当前显示的是什么语种](http://translate.zvo.cn/4074.html)**，如果用户切换为英语进行浏览，那么这个方法将返回翻译的目标语种。
* **[根据URL传参控制以何种语种显示](http://translate.zvo.cn/41929.html)**，设置可以根据当前访问url的某个get参数来控制使用哪种语言显示。
* **[离线翻译及自动生成配置](http://translate.zvo.cn/4076.html)**，其实它也就是传统 i18n 的能力，有语言配置文件提供翻译结果。
* **[手动调用接口进行翻译操作](http://translate.zvo.cn/4077.html)**，通过JavaScript调用一个方法，传入翻译文本进行翻译，并获得翻译结果
* **[元素的内容整体翻译能力配置](http://translate.zvo.cn/4078.html)**，对node节点的文本拿来进行整体翻译处理，而不再拆分具体语种，提高翻译语句阅读通顺程度
* **[翻译接口响应捕获处理](http://translate.zvo.cn/4079.html)**，对翻译API接口的响应进行捕获，进行一些自定义扩展
* **[清除历史翻译语种的缓存](http://translate.zvo.cn/4080.html)**，清除掉你上个页面所记忆的翻译语种，从而达到切换页面时不会按照上个页面翻译语种自动进行翻译的目的。
* **[网页ajax请求触发自动翻译](http://translate.zvo.cn/4086.html)**，监听当前网页中所有的ajax请求，当请求结束后，自动触发翻译
* **[设置只对指定语种进行翻译](http://translate.zvo.cn/4085.html)**，翻译时只会翻译在这里设置的语种，未在里面的语种将不会被翻译。
* **[识别字符串语种及分析](htt