Skip to content

Commit 4cfbd9b

Browse files
committed
Conflicts: 9.3.md 9.4.md
2 parents e6102d3 + dafaf1c commit 4cfbd9b

File tree

3 files changed

+25
-22
lines changed

3 files changed

+25
-22
lines changed

10.1.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
##10.1 设置默认地区
2-
##什么是地区
3-
地区是一组描述世界上某一特定区域文本格式和语言习惯的设置集合。地区名通常由三个部分组成:第一部分,是一个强制性的,表示语言的缩写,例如"en"表示英文或"zh"表示中文。第二部分,跟在一个下划线之后,是一个可选的国家说明符,用于区分将同一种语言的不同国家,例如"en_US"表示美国英语,而"en_UK"表示英国英语。最后一部分,跟在一个句点之后,是一个可选的字符集说明符,例如"zh_CN.gb2312"表示中国实用gb2312字符集。
2+
##什么是Locale
3+
Locale是一组描述世界上某一特定区域文本格式和语言习惯的设置的集合。locale名通常由三个部分组成:第一部分,是一个强制性的,表示语言的缩写,例如"en"表示英文或"zh"表示中文。第二部分,跟在一个下划线之后,是一个可选的国家说明符,用于区分讲同一种语言的不同国家,例如"en_US"表示美国英语,而"en_UK"表示英国英语。最后一部分,跟在一个句点之后,是可选的字符集说明符,例如"zh_CN.gb2312"表示中国实用gb2312字符集。
4+
5+
GO语言默认采用"UTF-8"编码集,所以我们实现i18n时不考虑第三部分,接下来我们都采用locale描述的前面两部分来作为i18n标准的locale名。
46

5-
GO语言默认是"UTF-8"字符集,所以我们这一章实现的i18n不考虑地区的第三部分,接下来我们都采用地区描述的前面两部分来作为i18n标准的地区名。
67

78
>在Linux和Solaris系统中可以通过`locale -a`命令列举所有支持的地区名,读者可以看到这些地区名的命名规范。对于BSD等系统,没有locale命令,但是地区信息存储在/usr/share/locale中。
89
9-
##设置地区
10-
有了上面对地区的定义,那么我们就需要根据用户的信息(访问信息、个人信息、访问域名等)来设置地区,我们可以通过如下几种方式来设置用户的地区
10+
##设置Locale
11+
有了上面对locale的定义,那么我们就需要根据用户的信息(访问信息、个人信息、访问域名等)来设置与之相关的locale,我们可以通过如下几种方式来设置用户的locale
1112

12-
###通过域名设置地区
13-
我们设置地区有一个办法就是在应用运行的时候才用域名分级的方式,例如,我们采用www.asta.com当做我们的英文站(默认站),而把域名www.asta.cn当做中文站点的域名。这样在我们应用里面设置对应的域名和地区的对应关系,就可以设置好地区。这样处理有几点好处:
13+
###通过域名设置Locale
14+
设置Locale的办法这一就是在应用运行的时候采用域名分级的方式,例如,我们采用www.asta.com当做我们的英文站(默认站),而把域名www.asta.cn当做中文站。这样通过在应用里面设置域名和相应的locale的对应关系,就可以设置好地区。这样处理有几点好处:
1415

1516
- 通过URL就可以很明显的识别
1617
- 用户可以通过域名很直观的知道将访问那种语言的站点
@@ -39,19 +40,20 @@ GO语言默认是"UTF-8"字符集,所以我们这一章实现的i18n不考虑
3940
i18n.SetLocale("zh-TW")
4041
}
4142

42-
通过域名设置地区有如上所示的优点,但是我们一般开发Web应用的时候不会采用这种方式,因为首先域名成本比较高,开发一个就需要一个域名,而且往往统一名称的域名不一定能申请的到,其次我们不愿意为每个愿意去本地化一个配置,而更多的是采用url后面带参数的方式,请看下面的介绍。
43+
通过域名设置Locale有如上所示的优点,但是我们一般开发Web应用的时候不会采用这种方式,因为首先域名成本比较高,开发一个Locale就需要一个域名,而且往往统一名称的域名不一定能申请的到,其次我们不愿意为每个站点去本地化一个配置,而更多的是采用url后面带参数的方式,请看下面的介绍。
4344

44-
###从域名参数设置地区
45-
目前最常用的设置地区的方式是在URL里面带上参数,例如www.asta.com/hello?locale=zh或者www.asta.com/zh/hello。这样我们就可以设置地区:`i18n.SetLocale(params["locale"])`
45+
###从域名参数设置Locale
46+
目前最常用的设置Locale的方式是在URL里面带上参数,例如www.asta.com/hello?locale=zh或者www.asta.com/zh/hello。这样我们就可以设置地区:`i18n.SetLocale(params["locale"])`
4647

47-
这种设置地区方式几乎拥有上面通过域名设置地区的优点,他采用RESTful的方式,这种方式使得我们不需要增加额外的方式来处理他。但是这种方式需要我们在每一个我们的link里面增加相应的参数locale,这也许有点复杂而且有时候可能做起来相当的繁琐。不过我们可以写一个通用的函数url,让所有的link地址都通过这个函数来生成,然后在这个函数里面增加`locale=params["locale"]`参数
48+
这种设置方式几乎拥有前面讲的通过域名设置Locale的所有优点,它采用RESTful的方式,以使得我们不需要增加额外的方法来处理。但是这种方式需要在每一个的link里面增加相应的参数locale,这也许有点复杂而且有时候甚至相当的繁琐。不过我们可以写一个通用的函数url,让所有的link地址都通过这个函数来生成,然后在这个函数里面增加`locale=params["locale"]`参数来缓解一下
4849

4950
也许我们希望URL地址看上去更加的RESTful一点,例如:www.asta.com/en/books(英文站点)和www.asta.com/zh/books(中文站点),这种方式的URL更加有利于SEO,而且对于用户也比较友好,能够通过URL直观的知道访问的站点。那么这样的URL地址可以通过router来获取locale(参考REST小节里面介绍的router插件实现):
5051

5152
mux.Get("/:locale/books", listbook)
5253

5354
###从客户端设置地区
54-
在一些特殊的情况下,我们需要根据客户端的信息来设置地区而不是通过URL,这些信息可能来自于客户端设置的喜好语言(浏览器中设置),也可能根据用户访问站点时的IP地址,也可能根据用户在注册的时候填写的所在地信息。这种方式比较适合Web为基础的应用。
55+
在一些特殊的情况下,我们需要根据客户端的信息而不是通过URL来设置Locale,这些信息可能来自于客户端设置的喜好语言(浏览器中设置),用户的IP地址,用户在注册的时候填写的所在地信息等。这种方式比较适合Web为基础的应用。
56+
5557
- Accept-Language
5658

5759
客户端请求的时候在HTTP头信息里面有`Accept-Language`,一般的客户端都会设置该信息,下面是Go语言实现的一个简单的根据`Accept-Language`实现设置地区的代码:
@@ -67,14 +69,14 @@ GO语言默认是"UTF-8"字符集,所以我们这一章实现的i18n不考虑
6769
当然在实际应用中,可能需要更加严格的判断来进行设置地区
6870
- IP地址
6971

70-
另一种根据客户端来设定地区就是用户访问的IP,我们根据相应的IP库,对应访问的IP到地区,目前全球比较常用的就是这个库:GeoIP Lite Country。这种设置地区的机制非常简单,我们只需要根据IP数据库查询用户的IP然后返回国家地区,根据返回的结果设置对应的地区。
72+
另一种根据客户端来设定地区就是用户访问的IP,我们根据相应的IP库,对应访问的IP到地区,目前全球比较常用的就是GeoIP Lite Country这个库。这种设置地区的机制非常简单,我们只需要根据IP数据库查询用户的IP然后返回国家地区,根据返回的结果设置对应的地区。
7173

7274
- 用户profile
7375

74-
当然你也可以在你的Web应用中让用户来设置相应的地区,用户根据你提供的下来菜单或者别的选择相应的地区设置,Web中保存相应的设置,当用户再次登陆的时候把这个设置复写到地区设置中,这样就可以保证该用户每次访问都是基于自己先前设置的地区访问
76+
当然你也可以让用户根据你提供的下拉菜单或者别的什么方式的设置相应的locale,然后我们将用户输入的信息,保存到与它帐号相关的profile中,当用户再次登陆的时候把这个设置复写到locale设置中,这样就可以保证该用户每次访问都是基于自己先前设置的locale来获得页面
7577

7678
##总结
77-
通过上面的介绍,设置地区可以有很多种方式,根据应用程序的不同来选择不同的方式设置地区,但是我们最终期望达到的目的就是让用户访问正确的地区语言,让英语用户访问英文站点,让中文用户访问中文站点
79+
通过上面的介绍可知,设置Locale可以有很多种方式,我们应该根据需求的不同来选择不同的设置Locale的方法,以让用户能以它最熟悉的方式,获得我们提供的服务,提高应用的用户友好性
7880

7981
## links
8082
* [目录](<preface.md>)

10.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
##10 国际化和本地化
2-
随着全球经济的一体化,软件开发者应该开发出支持多国语言、国际化的Web应用。对于Web应用来说,同样的页面在不同的语言环境下需要显示不同的效果。也就是说,一个Web应用程序在运行时能够根据客户端请求所来自的国家和语言显示不同的用户界面。这样 ,当需要在应用程序中添加对一种新的语言的支持时,无需修改应用程序的代码。
2+
为了适应经济的全球一体化,作为开发者,我们需要开发出支持多国语言、国际化的Web应用,即同样的页面在不同的语言环境下需要显示不同的效果,也就是说应用程序在运行时能够根据请求所来自的地域与语言的不同而显示不同的用户界面。这样,当需要在应用程序中添加对新的语言的支持时,无需修改应用程序的代码,只需要增加语言包即可实现
33

4-
国际化与本地化(Internationalization and localization,通常用i18n和L10N表示),国际化是指针对一个为某一个地区设计的程序进行重构,使得它能够在更多地区使用,本地化是指在一个面向国际化的程序中增加一个新地区的支持
4+
国际化与本地化(Internationalization and localization,通常用i18n和L10N表示),国际化是将针对某个地区设计的程序进行重构,以使它能够在更多地区使用,本地化是指在一个面向国际化的程序中增加对新地区的支持
55

6-
Go语言目前标准包里面没有i18n的支持,但有一些第三方库支持,但是都是比较简单的实现,我们通过这一章的介绍将实现一个go-i18n库,用来支持Go语言的i18n。
6+
目前,Go语言的标准包没有提供对i18n的支持,但有一些比较简单的第三方实现,这一章我们将实现一个go-i18n库,用来支持Go语言的i18n。
77

8-
所谓的国际化:就是根据特定的locale信息,提取相应的字符串和其它一些东西(比如时间和货币的格式)等等。那么这个里面需要解决三个问题
8+
所谓的国际化:就是根据特定的locale信息,提取与之相应的字符串或其它一些东西(比如时间和货币的格式)等等。这涉及到三个问题
99

1010
1、如何确定locale。
1111

12-
2、如何保存这些locale相关的字符串和其它信息
12+
2、如何保存与locale相关的字符串或其它信息
1313

1414
3、如何根据locale提取字符串和其它相应的信息。
1515

16-
我们将在第一小节里面介绍如何设置正确的locale以便让访问你的站点的用户能够得到相应的正确的语言。第二小节里面介绍本地化如何处理字符串、货币、时间日期等信息,如何存储locale对应的信息,第三小节将介绍如何实现国际化站点,如何根据不同locale返回不同的字符串。通过这三个小节的介绍,将实现一个完整的i18n方案
16+
在第一小节里,我们将介绍如何设置正确的locale以便让访问站点的用户能够获得与其语言相应的页面。第二小节将介绍如何处理或存储字符串、货币、时间日期等与locale相关的信息,第三小节将介绍如何实现国际化站点,即如何根据不同locale返回不同合适的内容。通过这三个小节的学习,我们将获得一个完整的i18n方案
1717

1818
## 目录
1919
* 1 [设置默认地区](10.1.md)

9.3.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ XSS目前主要的手段和目的如下:
1717
##XSS的原理
1818
Web应用未对用户提交请求的数据做充分的检查过滤,允许用户在提交的数据中掺入HTML代码(最主要的是“>”、“<”),并将未经转义的恶意代码输出到第三方用户的浏览器解释执行,是导致XSS漏洞的产生原因。
1919

20-
接下来以反射性XSS举例说明XSS的过程:现在有一个网站,根据参数输出用户的名称,例如访问url:"http://127.0.0.1/?name=astaxie",就会在浏览器输出如下信息:
20+
接下来以反射性XSS举例说明XSS的过程:现在有一个网站,根据参数输出用户的名称,例如访问url:`http://127.0.0.1/?name=astaxie`,就会在浏览器输出如下信息:
2121

2222
hello astaxie
2323

@@ -42,6 +42,7 @@ Web应用未对用户提交请求的数据做充分的检查过滤,允许用
4242

4343
这样就可以让浏览器解析javascript代码,而不会是html输出。
4444

45+
4546
##总结
4647
XSS漏洞是相当有危害的,在开发Web应用的时候,一定要记住过滤数据,特别是在输出到客户端之前,这是现在行之有效的防止XSS的手段。
4748

0 commit comments

Comments
 (0)