一步一步实现网站的多语言版本

摘要:
在网站开发过程中,我们需要实现多语言版本。目前,我们认为有英文和中文版本。网站结构包括UI进程、rest服务和相应的js。对于每个部分,我们需要实现多语言,不需要一键切换。然而,我们需要能够在部署期间实现多语言配置。这很容易理解。应用程序可以通过资源文件切换多个语言版本,资源文件自然存储了语言版本的键值对应关系。

    网站在开发的过程中需要实现多语言版本,我们暂且认为有英语和汉语两个版本。网站结构包括,UI过程,rest服务,以及相应的js,各个部分我们都要实现多语言,不要求一键切换,但是在部署过程中要能实现多与语言配置。

首先我们出场的是资源文件,C#的项目实现本地化和区域化,我们要用到资源文件。

添加资源文件夹

一步一步实现网站的多语言版本第1张

添加资源文件项

一步一步实现网站的多语言版本第2张

这里文件的命名最好能规范,如英文版本建议 lang.en.resx,汉语版本建议用lang.zh-cn.resx

实际使用效果

一步一步实现网站的多语言版本第3张

资源文件夹由各个语言版本的资源文件组成,资源文件以.resx后缀和.cs后缀成对出现,其实质是一定规则的Xml文件。这个很容易理解,应用程序通过资源文件实现多语言版本的切换,这个资源文件自然保存着语言版本的键值对应关系。

如果你还不太理解的资源文件的话,可以用记事本打开.resx文件,为了真正看到资源文件的核心数据,我们先提前添加一个资源

一步一步实现网站的多语言版本第4张

.resx文件

以root为根节点的xml文件,刚才我们添加的资源表示为:

<data name="website" xml:space="preserve">
    <value>cnblogs</value>
 </data>

我们操作.resx文件就是要形成多个data节点

接下来我们要添加键值对应关系了,如果键值对应对比较少,我们可以通过上图中的图形化界面操作,但是既然是网站,需要翻译的内容必定会很多,难道我们一个一个添加吗?

既然核心文件就是这个data节点,我们只要保证data节点补充完整即可。

这里我们提供两种方法供参考。

1 可以先把键值对事先批量保存在数据库中,再通过读取数据,使用程序批量生成data节点集合,补充完整即可。这样做的好处是可以把数据保存下来,省去手工添加的繁琐。

其实在实际开发过程中,翻译内容键是会不断增加调整的,并且资源文件不允许重复键,也就意味着要不断的修改数据和程序。总之,这不算一种科学的方法。

2 我们需要发现一个工具,vs早已经准备好了,Resgen

它可以实现txt文件与.resx文件的相互转化,准确快速

一步一步实现网站的多语言版本第5张

上图中的txt文件格式可以是这样

website=网站
service=服务

以上两种方法各有利弊,我个人还是推荐第二种方法

生成资源文件是实现多语言版本的第一步,有些需要注意的地方

1)键的名字不能重复,最好是有意义的无空格及特殊字符的。

2)多个语言版本的文件中需要都有指定的键

即 

<data name="website" xml:space="preserve">
    <value>cnblogs</value>
 </data>

这个节点需要在lang.en.resx和lang.zh-cn.resx文件中都存在,只是value值不同,否则在读取时会出现混淆

读取使用资源文件

资源文件整理完以后,我们需要替换所有需要翻译的内容为资源文件变量,无论是前台aspx页面还是cs文件都可以按照以下格式替换

<%=Resources.lang.website%>

这个时候可以体现键名字规范的好处,智能提示可以清晰的找出,并且不会出现_等符号

js中实现多语言

js实际上与资源文件是没有关系的,所以以上 的资源文件在js部分不能直接使用。既然js也需要有多语言版本,所以js也必定有自己的"资源文件"--json

我们借助json存储需要翻译的js提示语言,value等值的对应关系。

两个语言版本,我们生成3个js文件,以备后用

一步一步实现网站的多语言版本第6张

每个文件中存放的相应的json数组,翻译内容键值对应

var note  { website:"博客园",sure:"确定"}

使用:

在需要使用的js文件中引入lang.en.js和 lang.zh-cn.js,做相应的替换即可。

///<reference path="/Jscript/Translate/lang.en.js" />
///<reference path="/Jscript/Translate/lang.js" />
///<reference path="/Jscript/Translate/lang.zh-cn.js" />

note.sure

为了代码规范我建议在生成json文件时加上注释

///<param name="TianJia" type="String">添加</param>
Add: "Add",

js多语言翻译的关键是js中需要翻译的内容被相应的js文件中的json值替换。比如翻译英文版的 "确定"

在程序中我们必须读到相应的 lang.en.js 文件,这样才可以取到sure值

我们可以通过cookie来决定加载哪个翻译的js"资源文件",也可以部署时直接把相应的js转移到 lang.js,而删除其它不用的js翻译文件。这也是以上我说生成3个js文件的原因。

说完了js的配置,我们再返回头来说说资源文件的配置

程序如何决定网站启动时使用哪个资源文件?

资源文件由在webconfig的<system.web>下globalization节点设置,打开相应的本地化节点即可

<globalization culture="en-US" uiCulture="en-US"/>
<!--<globalization culture="zh-CN" uiCulture="zh-CN"/>-->

     这样就实现了网站的多语言配置,如果要实现真正的一键切换,需要在cookie和Global.asax继续处理,如果你觉得我的文章对你有所帮助,请点 【推荐】

免责声明:文章转载自《一步一步实现网站的多语言版本》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇常用邮箱SMTP服务器地址大全openwrt web管理luci界面修改下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

js-实现常见的拖拽效果(表单滑块验证)

本文将详细介绍拖拽的实现过程,会使用到js的三个事件(鼠标按下mousedown、鼠标移动mousemove、鼠标抬起mouseup),利用这三个事件即可完成拖拽效果。 在没有拖拽到最右端的情况下,会自动返回,效果图如下: 具体实现代码如下: <!DOCTYPE html> <html lang="en"> <head&g...

JS 特性:可选链(?.)

什么是可选链 可选链操作符( ?. )是一个新的js api,允许读取位于连接对象链深处的属性的值,而不必明确验证链中的每个引用是否有效。?. 操作符的功能类似于 . 链式操作符,不同之处在于,在引用为空(nullish ) (null 或者 undefined) 的情况下不会引起错误,该表达式短路返回值是 undefined。与函数调用一起使用时,如果给...

js中的DOM节点操作---增删改查

查找节点 getElementById(),getElementsByClassName(),getElementsByTagName() querySelector(),querySelectorAll() 创建节点 createElement():创建一个dom节点 示例代码 document.createElement('div'); 插入节点 a...

JS以及CSS对页面的阻塞

一、JS阻塞    所有的浏览器在下载JS文件的时候,会阻塞页面上的其他活动,包括其他资源的下载以及页面内容的呈现等等,只有当JS下载、解析、执行完,才会进行后面的 操作。在现代的浏览器中CSS资源和图片image资源是并行下载的,在IE6中默认的并行的加载数目是2个,在IE6以后以及其他的浏览器中的默认的并行加载数目是6个。 在浏览器从服务器接收到HTM...

JS 中 JSON 对象与字符串之间的相互转换

在开发的过程中,如果对于少量参数的前后台传递,可以直接采用ajax的data函数,按json格式传递,后台Request即可,但有的时候,需要传递多个参数,这样后台 接受的时候Request多个很麻烦,此时要按照类的格式 或 集合的形式进行传递。 1、传递单一对象Json 例如:前台按类的格式传递JSON对象: var jsonUser = "{"User...

Js 控制随机数概率

(新)控制随机数概率:https://www.cnblogs.com/whnba/p/10565045.html 算法精简了一下   如: 取 1~10 之间的随机数,那么他们的取值范围是: 整数 区间 概率 1 [0,1) 0.1 2 [1,2) 0.1 3 [2,3) 0.1 4 [3,4) 0.1 5 [4,5) 0.1...