i18n-jsautotranslate 3.11.11 → 3.12.5

package/README.md

@@ -57,7 +57,7 @@ http://res.zvo.cn/translate/demo.html
 在网页最末尾， ````</html>```` 之前，加入以下代码，一般在页面的最底部就出现了选择语言的 select 切换标签。 其实就这么简单：
 
 ````
-<script src="https://cdn.staticfile.net/translate.js/3.2.1/translate.js"></script>
+<script src="https://cdn.staticfile.net/translate.js/3.12.0/translate.js"></script>
 <script>
 translate.language.setLocal('chinese_simplified'); //设置本地语种（当前网页的语种）。如果不设置，默认自动识别当前网页显示文字的语种。 可填写如 'english'、'chinese_simplified' 等，具体参见文档下方关于此的说明。
 translate.service.use('client.edge'); //设置机器翻译服务通道，直接客户端本身，不依赖服务端 。相关说明参考 http://translate.zvo.cn/43086.html
@@ -104,6 +104,9 @@ translate.execute();//进行翻译
 
 
 # 使用示例
+
+## 在浏览器使用
+
 **普通网站中点击某个语言进行切换**
 如下图所示，网站中的某个位置要有几种语言切换  
 ![](http://cdn.weiunity.com/site/341/news/43b838ea6ad041898037eaaaf5802776.png)  
@@ -118,7 +121,7 @@ translate.execute();//进行翻译
 </ul>
 
 <!-- 引入多语言切换的js -->
-<script src="https://cdn.staticfile.net/translate.js/3.2.1/translate.js"></script>
+<script src="https://cdn.staticfile.net/translate.js/3.12.0/translate.js"></script>
 <script>
 	translate.selectLanguageTag.show = false; //不出现的select的选择语言
     translate.service.use('client.edge'); //设置机器翻译服务通道
@@ -126,32 +129,51 @@ translate.execute();//进行翻译
 </script>
 ````
 
+## 在 NPM 中使用
+
+1. Install
+
+    ```bash
+    npm i i18n-jsautotranslate
+    ```
+
+2. Import
+
+    ```javascript
+    import translate from 'i18n-jsautotranslate'
+    /* Or */
+    const translate = require("i18n-jsautotranslate")
+    ```
+
+[Vue2 中使用 translate.js 在线 Demo](https://lruihao.github.io/vue-el-demo/#/translate-js)
+
 # 谁在使用
 截止 2023.7 月份时，本项目的后端免费翻译服务的请求量就已经达到了 1.5亿次/月 的规模，并且还在非常快速的持续增大，包括一些城投集团像是长沙城投、以及一些政府单位像是环境保障局、企业国际化经营服务平台、海外矿业产业联合、国际潮青联谊年会、人力资源和社会保障局、政务服务网、海外的一些平台如futrom智能住宅、bitheime全球区块链等等都在广泛使用。
 这里给出两个使用比较好的网站作为实际示例参考：
   
 * [**RICE中国大米展**](https://www.cnrice.com.cn)
-* [**北京长城航空集团红十字会**](https://hh.changhang.org.cn)
-* [**第十一届国际潮青联谊年会组委会**](https://ityc.org.cn)
+* [**第十一届国际潮青联谊年会组委会**](http://ityc.org.cn)
 
 另外，很多开源框架及产品也都已将此翻译能力接入了自身系统，赋予自身系统多语言切换能力。
 
 
 ## 这些开源产品已内置本功能
-* [Discuz](https://addon.dismall.com/plugins/domi_translate.html)
-* [Pear Admin Layui](https://gitee.com/pear-admin/Pear-Admin-Layui/tree/i18n/)
-* [kefu.js](https://gitee.com/mail_osc/kefu.js)
-* [Layui](https://gitee.com/mail_osc/translate_layui)
-* [wangmarket CMS](http://cms.zvo.cn)
-* [易优CMS](https://www.eyoucms.com/mall/plus/29751.html)
-* [迅睿CMS](https://www.xunruicms.com/shop/1285.html)
-* [chanyue-cms](https://gitee.com/yanyutao0402/chanyue-cms)
-* [phpok cms](https://gitee.com/phpok/phpok)
-* [RPCMS](https://app.rpcms.cn/app/149.html)
-* [Masuit.MyBlogs](https://gitee.com/masuit/Masuit.MyBlogs)
-* [FixIt](https://github.com/hugo-fixit/cmpt-translate)
+* [管伊佳ERP](https://gitee.com/jishenghua/JSH_ERP) 国产开源ERP系统关注度第一，专注进销存、生产、总账
+* [FixIt](https://github.com/hugo-fixit/cmpt-translate) 一款简洁、优雅且先进的Hugo 博客主题
+* [Z-Blog](https://app.zblogcn.com/?id=49226) 易用的博客程序，功能丰富，模板多样，助轻松搭建个性博客。
+* [Discuz](https://addon.dismall.com/plugins/domi_translate.html) 知名论坛系统，功能强大，插件众多，打造活跃互动的网络社区。
+* [Pear Admin Layui](https://gitee.com/pear-admin/Pear-Admin-Layui/tree/i18n/) Pear Admin Layui 是基于 Layui 的后台管理模板，简洁美观，实用高效。
+* [kefu.js](https://gitee.com/mail_osc/kefu.js) 开源js聊天界面插件，方便快捷，助力网站沟通服务。
+* [Layui](https://gitee.com/mail_osc/translate_layui) 简洁好用的前端框架，组件丰富，上手容易，广受开发者青睐。
+* [wangmarket CMS](http://cms.zvo.cn) 开源的SAAS云建站系统，可私有部署，可通过后台任意开通多个网站，每个网站独立管理
+* [易优CMS](https://www.eyoucms.com/mall/plus/29751.html) 功能强大的内容管理系统，操作简便，模板随心选。
+* [迅睿CMS](https://www.xunruicms.com/shop/1285.html) 一款功能完善的内容管理系统，性能卓越，易于使用。
+* [chanyue-cms](https://gitee.com/yanyutao0402/chanyue-cms) 基于Node、Express、MySQL、Vue3研发的高质量实用型CMS系统
+* [phpok cms](https://gitee.com/phpok/phpok) 极其自由的企业站程序，支持各种自定义配置。
+* [RPCMS](https://app.rpcms.cn/app/149.html) 轻量型php内容管理系统，小型、轻量，但功能丰富，可扩展性强。
+* [Masuit.MyBlogs](https://gitee.com/masuit/Masuit.MyBlogs) 高性能高安全性低占用的个人博客系统
 ...  
-如果您有开源项目，比如文档、cms、UI 框架、后台管理框架、等等，需要采用此进行多语言切换，欢迎喊我，无偿提供全程接入讨论及遇到的问题跟随优化，希望我们的开源项目能互相产生作用一起越来越好  
+如果您有开源项目，比如文档、cms、UI 框架、后台管理框架、等等，需要采用此进行多语言切换，欢迎喊我，无偿提供全程接入讨论及遇到的问题跟随优化，希望我们的开源项目能互相产生作用一起越来越好。如果你的项目在这个列表中没有，欢迎联系我说明，我给加入进去  
 
 
 # 哪些能力
@@ -164,6 +186,15 @@ translate.execute();//进行翻译
 翻译是基于您现有的网站内容，不需要重新建设多语种网站，只需要解析域名到您私有部署的服务器，就可以完成全站翻译。
 详细参见 [TCDN](http://translate.zvo.cn/41159.html)
 
+# TCDN部署
+tcdn是translate.js 的高级版本，它的能力是让你原本的网站可以用不同的域名访问到不同的语种。而不同的语种，都可以被收录！它可以免费部署到服务器进行使用。注意，它需要使用个1核2G的服务器进行部署的。    
+部署方式有两种： 
+### 宝塔部署
+首选需要你的宝塔面板需要 9.3.0 及以上版本。 不然你在下一步部署时，是搜索不到我们 TCDN 这个服务的。  
+如果你没有安装宝塔面板，可以先去安装宝塔面板： [https://www.bt.cn/new/download.html?r=dk_tcdn](https://www.bt.cn/new/download.html?r=dk_tcdn)  
+详细部署步骤可参考：  [https://translate.zvo.cn/302663.html](https://translate.zvo.cn/302663.html)
+### 服务器部署
+需要一个干净的服务器，不依赖任何环境的情况下进行的部署，需要你懂点linux命令行， 部署方式参考：  [https://translate.zvo.cn/236899.html](https://translate.zvo.cn/236899.html)
 
 # 开源仓库目录结构
 * **deploy** - 部署相关，比如shell文件、sql数据库文件等
@@ -195,7 +226,6 @@ translate.execute();//进行翻译
 
 # 优秀开源项目及社区推荐
 [Featbit](https://github.com/featbit/featbit) 一个100%开源的 Feature flags / Feature Management 平台工具  
-[LinkWeChat](https://gitee.com/LinkWeChat/link-wechat) LinkWeChat 是基于企业微信的开源 SCRM 系统，是企业私域流量管理与营销的综合解决方案。    
 [IoTSharp](https://gitee.com/IoTSharp) IoTSharp 是一个 基于.Net Core 开源的物联网基础平台， 支持 HTTP、MQTT 、CoAp 协议    
 [流之云](https://gitee.com/ntdgg) 信息化、数字化服务提供商    
 

package/{translate.js/translate.js → index.js}

@@ -8,11 +8,11 @@
 var translate = {
 	/**
 	 * 当前的版本
-   * 由 npm 脚本自动更新，无需手动修改
-   * 格式：major.minor.patch.date
+	 * 由 npm 脚本自动更新，无需手动修改
+	 * 格式：major.minor.patch.date
 	 */
-  // AUTO_VERSION_START
-  version: '3.11.11.20241209',
+	// AUTO_VERSION_START
+  version: '3.12.5.20250111',
   // AUTO_VERSION_END
 	/*
 		当前使用的版本，默认使用v2. 可使用 setUseVersion2(); 
@@ -148,7 +148,12 @@ var translate = {
 			
 			//判断translate 的id是否存在，不存在就创建一个
 			if(document.getElementById(translate.selectLanguageTag.documentId) == null){
-				var body_trans = document.getElementsByTagName('body')[0];
+				var findBody = document.getElementsByTagName('body');
+				if(findBody.length == 0){
+					console.log('body tag not find, translate.selectLanguageTag.render() is not show Select Language');
+					return;
+				}
+				var body_trans = findBody[0];
 				var div = document.createElement("div");  //创建一个script标签
 				div.id=translate.selectLanguageTag.documentId;
 				body_trans.appendChild(div);
@@ -564,6 +569,7 @@ var translate = {
 			return translate.nomenclature.data;
 		},
 		//对传入的str字符进行替换，将其中的自定义术语提前进行替换，然后将替换后的结果返回
+		//v3.11 后此方法已废弃，不再使用
 		dispose:function(str){
 			if(str == null || str.length == 0){
 				return str;
@@ -1284,9 +1290,15 @@ var translate = {
 		
 		//判断本地语种跟要翻译的目标语种是否一样，如果是一样，那就不需要进行任何翻译
 		if(translate.to == translate.language.getLocal()){
-			return;
+			if(translate.language.translateLocal){
+				//这是自定义设置的允许翻译本地语种中，跟本地语种不一致的语言进行翻译
+
+			}else{
+				return;
+			}
 		}
 		
+
 		/********** 翻译进行 */
 		
 		//先进行图片的翻译替换，毕竟图片还有加载的过程
@@ -1938,12 +1950,15 @@ var translate = {
 					//替换渲染
 					if(typeof(originalText) != 'undefined' && originalText.length > 0){
 						if(typeof(node[attribute]) != 'undefined'){
-							//这种将在 v3.9.2 之后废弃，有下面的setAttribute的方式取代
+							//这种是主流框架，像是vue、element、react 都是用这种 DOM Property 的方式，更快
 							node[attribute] = node[attribute].replace(new RegExp(translate.util.regExp.pattern(originalText),'g'), translate.util.regExp.resultText(resultText));	
 						}
-						if(typeof(node.getAttribute(attribute)) != 'undefined'){
+
+						//这种 Html Attribute 方式 是 v3.12 版本之前一直使用的方式，速度上要慢于 上面的，为了向前兼容不至于升级出问题，后面可能会优化掉
+						var htmlAttributeValue = node.getAttribute(attribute);
+						if(htmlAttributeValue != null && typeof(htmlAttributeValue) != 'undefined'){
 							//这个才是在v3.9.2 后要用的，上面的留着只是为了适配以前的
-							node.setAttribute(attribute, node.getAttribute(attribute).replace(new RegExp(translate.util.regExp.pattern(originalText),'g'), translate.util.regExp.resultText(resultText)));
+							node.setAttribute(attribute, htmlAttributeValue.replace(new RegExp(translate.util.regExp.pattern(originalText),'g'), translate.util.regExp.resultText(resultText)));
 						}
 					}
 					return result;
@@ -2130,12 +2145,33 @@ var translate = {
 				for(var attributeName_index in translate.element.tagAttribute[nodeNameLowerCase]){
 					
 					var attributeName = translate.element.tagAttribute[nodeNameLowerCase][attributeName_index];
-					if(typeof(node.getAttribute(attributeName)) == 'undefined'){
-						//这个tag标签没有这个 attribute，忽略
-						continue
+					//console.log(attributeName);
+					//console.log(node.getAttribute(attributeName));
+
+					/*
+					 * 默认是 HtmlAtrribute 也就是 HTML特性。取值有两个:
+					 * HTMLAtrribute : HTML特性
+					 * DOMProperty : DOM属性
+					 */
+					var DOMPropOrHTMLAttr = 'HTMLAtrribute'; 
+					var attributeValue = node.getAttribute(attributeName);
+					if(typeof(attributeValue) == 'undefined' || attributeValue == null){
+						//vue、element、react 中的一些动态赋值，比如 element 中的 el-select 选中后赋予显示出来的文本，getAttribute 就取不到，因为是改动的 DOM属性，所以要用这种方式才能取出来
+						attributeValue = node[attributeName];
+						DOMPropOrHTMLAttr = 'DOMProperty';
 					}
+					if(typeof(attributeValue) == 'undefined' || attributeValue == null){
+						//这个tag标签没有这个属性，忽略
+						continue;
+					}
+
+					//if(typeof(node.getAttribute(attributeName)) == 'undefined' && typeof(node[attributeName]) == 'undefined'){
+					//	//这个tag标签没有这个 attribute，忽略
+					//	continue
+					//}
+					
 					//加入翻译
-					translate.addNodeToQueue(uuid, node, node.getAttribute(attributeName), attributeName);
+					translate.addNodeToQueue(uuid, node, attributeValue, attributeName);
 				}
 
 			}
@@ -2158,7 +2194,6 @@ var translate = {
 			if(node == null || typeof(node) == 'undefined'){
 				return;
 			}
-			//console.log(node)
 			if(node.parentNode == null){
 				return;
 			}
@@ -2215,6 +2250,7 @@ var translate = {
 				//console.log('addNodeToQueue -- '+nodeAnaly['node']+', text:' + nodeAnaly['text']);
 				translate.addNodeToQueue(uuid, nodeAnaly['node'], nodeAnaly['text']);
 			}
+			
 			//console.log(nodeAnaly);
 			/*
 			//console.log(node.nodeName+', type:'+node.nodeType+', '+node.nodeValue);
@@ -2546,7 +2582,7 @@ var translate = {
 		//获取当前是什么语种
 		//var langs = translate.language.get(text);
 		var textRecognition = translate.language.recognition(text);
-		langs = textRecognition.languageArray;
+		var langs = textRecognition.languageArray;
 		//console.log('langs');
 		//console.log(langs);
 
@@ -2854,6 +2890,14 @@ var translate = {
 
 		//当前本地语种，本地语言，默认是简体中文。设置请使用 translate.language.setLocal(...)。不可直接使用，使用需用 getLocal()
 		local:'',
+
+		/*
+		 * v3.12增加, 是否会翻译本地语种，默认是false，不会翻译。
+		 * 比如当前设置的本地语种是简体中文， 但是网页中也有一段英文， 如果设置了translate.to 为中文，也就是要以中文显示 默认是false的情况下，整个页面是不会被任何翻译的，也就是有的那段英文也不会进行任何翻译，依旧是显示英文。
+		 * 如果这里设置为 true， 则英文也会被翻译，只要不是中文的，都会被翻译为要显示的语种，也就是都会被翻译为中文。
+		 */
+		translateLocal:false,
+
 		/*
 			翻译语种范围
 			比如传入 ['chinese_simplified','chinese_traditional','english'] 则表示仅对网页中的简体中文、繁体中文、英文 进行翻译，而网页中出现的其他的像是法语、韩语则不会进行翻译
@@ -4294,11 +4338,16 @@ var translate = {
 
 		*/
 		name:'translate.service',  
+
 		/*
 			其实就是设置 translate.service.name
-
+	
 		*/
 		use: function(serviceName){
+			if(translate.enterprise.isUse == true){
+				console.log('您已启用了企业级翻译通道 translate.enterprise.use(); (文档：https://translate.zvo.cn/4087.html) , 所以您设置的 translate.service.use(\''+serviceName+'\'); (文档：https://translate.zvo.cn/4081.html) 将失效不起作用，有企业级翻译通道全部接管。');
+				return;
+			}
 			if(typeof(serviceName) == 'string' && serviceName == 'client.edge'){
 				translate.service.name = serviceName;
 
@@ -4768,6 +4817,9 @@ var translate = {
 			}
 			//加入浏览器默认语种  v3.6.1 增加，以便更好的进行自动切换语种
 			data.browserDefaultLanguage = translate.util.browserDefaultLanguage();
+			if(typeof(translate.enterprise.key) != 'undefined' && typeof(translate.enterprise.key) == 'string' && translate.enterprise.key.length > 0){
+				data.key = translate.enterprise.key;
+			}
 
 			if(typeof(data) == 'string'){
 				params = data; //payload 方式
@@ -4884,16 +4936,63 @@ var translate = {
 				//打印翻译结果
 				console.log(data);
 			});
+
+			使用案例三：
+			var obj = {
+				from:'chinese_simplified',
+				to:'english',
+				texts: ['我是翻译的第一句','我是翻译的第二句','我是翻译的第三句']
+			}
+			translate.request.translateText(obj, function(data){
+				//打印翻译结果
+				console.log(data);
+			});
 		*/
-		translateText:function(texts, func){
-			if(typeof(texts) == 'string'){
-				texts = [texts];
+		translateText:function(obj, func){
+			var texts = new Array();
+			var from = translate.language.getLocal();
+			var to = translate.language.getCurrent();
+
+			if(typeof(obj) == 'string'){
+				//案例一的场景，传入单个字符串
+				texts[0] = [obj];
+			}else{
+				//不是字符串了，而是对象了，判断是案例二还是案例三
+
+				var type = Object.prototype.toString.call(obj);
+				//console.log(type);
+				if(type == '[object Array]'){
+					//案例二
+					texts = obj;
+				}else if(type == '[object Object]'){
+					//案例三
+					if(typeof(obj.texts) == 'undefined'){
+						console.log('translate.request.translateText 传入的值类型异常，因为你没有传入 obj.texts 要翻译的具体文本！ 请查阅文档： https://translate.zvo.cn/4077.html');	
+					}
+					if(typeof(obj.texts) == 'string'){
+						//单个字符串
+						texts = [obj.texts];
+					}else{
+						//多个字符串，数组形态
+						texts = obj.texts;
+					}
+					if(typeof(obj.from) == 'string' && obj.from.length > 0){
+						from = obj.from;
+					}
+					if(typeof(obj.to) == 'string' && obj.to.length > 0){
+						to = obj.to;
+					}
+				}else{
+					console.log('translate.request.translateText 传入的值类型错误，请查阅文档： https://translate.zvo.cn/4077.html');
+					return;
+				}
 			}
+			
 
 			var url = translate.request.api.translate;
 			var data = {
-				from:translate.language.getLocal(),
-				to: translate.language.getCurrent(),
+				from:from,
+				to: to,
 				text:encodeURIComponent(JSON.stringify(texts))
 			};
 			//console.log(data);
@@ -5294,6 +5393,12 @@ var translate = {
 			//主节点额外权重降低，更追求响应速度
 			translate.request.speedDetectionControl.hostMasterNodeCutTime = 300; 
 			translate.request.api.host=['https://america-enterprise-api-translate.zvo.cn/','https://beijing.enterprise.api.translate.zvo.cn/','https://deutsch.enterprise.api.translate.zvo.cn/', 'https://america.api.translate.zvo.cn:666/', 'https://api.translate.zvo.cn:666/', 'https://api.translate.zvo.cn:888/'];
+			
+			if(translate.service.name == 'client.edge'){
+				translate.service.name = 'translate.service';
+				console.log('您已启用了企业级翻译通道 translate.enterprise.use(); (文档：https://translate.zvo.cn/4087.html) , 所以您设置的 translate.service.use(\'client.edge\'); (文档：https://translate.zvo.cn/4081.html) 将失效不起作用，有企业级翻译通道全部接管。');
+				return;
+			}
 		},
 		/*
 			自动适配翻译服务通道，如果当前所有网络节点均不可用，会自动切换到 edge.client 进行使用
@@ -5311,7 +5416,9 @@ var translate = {
 					translate.service.name = 'client.edge';
 				} 
 			}
-		}
+		},
+		/* 企业级翻译通道的key， v3.12.3.20250107 增加，针对打包成APP的场景 */
+		key:'', 
 	},
 
 	/*

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "i18n-jsautotranslate",
-  "version": "3.11.11",
+  "version": "3.12.5",
   "description": "Two lines of js realize automatic html translation. No need to change the page, no language configuration file, no API key, SEO friendly!",
-  "main": "translate.js/translate.js",
+  "main": "index.js",
   "scripts": {
     "version": "node dev/update-version.js",
     "postversion": "git push && git push --tags"
@@ -13,7 +13,7 @@
     "i18n-translatejs"
   ],
   "files": [
-    "translate.js/translate.js"
+    "index.js"
   ],
   "homepage": "https://github.com/xnx3/translate#readme",
   "bugs": {