首页 » Maven实战 » Maven实战全文在线阅读

《Maven实战》15.6 国际化

关灯直达底部

对于广大欧美以外的用户来说,站点上难免需要添加一些本土的文字,如果没有特殊的配置,站点可能无法对其使用正确的字符集编码。本节以简体中文为例,介绍如何生成本地化的Maven站点。

要生成正确的简体中文站点,用户首先需要确保项目所有的源码,包括pom.xml、site.xml以及apt文档等,都以UTF-8编码保存,各种编辑器和IDE都支持用户指定保存文档的编码。图15-18就展示了Windows上用记事本保存文档时候如何指定UTF-8编码。

图15-18 用记事本保存文档时指定UTF-8编码

接下来要做的是告诉maven-site-plugin使用UTF-8编码读取所有源码及文档,并且同样使用UTF-8编码呈现站点html文档。这两点可以通过配置两个Maven属性实现,如下:

project.build.sourceEncoding属性用来指定Maven用什么编码来读取源码及文档,而project.reporting.outputEncoding用来指定Maven用什么编码来呈现站点的html文档。

最后一步要做的是配置maven-site-plugin指定当地的语言,配置当地语言为简体中文zh_CN。如下:

完成这些配置后,就能生成图15-19所示的中文站点。

图15-19 生成中文Maven站点