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