15.4　自定义站点外观

Maven生成的站点非常灵活，除了本章前面提到的标准项目信息报告和其他插件生成的报告，用户还能够自定义站点的布局和外观。这些特性能让用户创建出更适合自己的，更有个性的Maven站点。

15.4.1　站点描述符

要自定义站点外观，用户必须创建一个名为site.xml的站点描述符文件，且默认该文件应该位于项目的src/site目录下。该站点描述符文件是由XML Schema约束定义的，相关的xsd文件位于http://maven.apache.org/xsd/decoration-1.0.0.xsd。

一个简单的站点描述符文件如代码清单15-9所示。

代码清单15-9　站点描述符文件

＜?xml version="1.0"encoding="UTF-8"?＞

＜project xmlns="http://maven.apache.org/DECORATION/1.0.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0

http://maven.apache.org/xsd/decoration-1.0.0.xsd"＞

＜bannerLeft＞

＜name＞Account＜/name＞

＜src＞images/apache-maven-project.png＜/src＞

＜href＞http://maven.apache.org＜/href＞

＜/bannerLeft＞

＜body＞

＜menu ref="reports"/＞

＜/body＞

＜skin＞

＜groupId＞com.googlecode.fluido-skin＜/groupId＞

＜artifactId＞fluido-skin＜/artifactId＞

＜version＞1.3＜/version＞

＜/skin＞

＜/project＞

该描述符文件定义了一个站点头部横幅图片、一个导航栏菜单项以及一个站点皮肤。下面详细介绍各类可在站点描述符中定义的内容。