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属性实现，如下：

＜properties＞

＜project.build.sourceEncoding＞UTF-8＜/project.build.sourceEncoding＞

＜project.reporting.outputEncoding＞UTF-8＜/project.reporting.outputEncoding＞

＜/properties＞

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

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

＜plugins＞

……

＜plugin＞

＜groupId＞org.apache.maven.plugins＜/groupId＞

＜artifactId＞maven-site-plugin＜/artifactId＞

＜version＞2.1.1＜/version＞

＜configuration＞

＜locales＞zh_CN＜/locales＞

＜/configuration＞

＜/plugin＞

..

＜plugins＞

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

图　15-19　生成中文Maven站点