15.4.2　头部内容及外观

默认情况下，Maven站点的标题来自于POM中的name元素值，用户可以配置站点描述符project元素的name属性来更改此标题。如下：

＜project name="A Project for Maven Book"＞

……

＜/project＞

显示效果如图15-11所示。

图　15-11　自定义站点标题的效果

如果不进行额外的配置，站点头部左边会显示项目的名称，但是用户可以使用banner-Left元素配置该位置显示自定义的横幅图片。类似地，bannerRight元素能用来配置显式在头部右边的横幅图片。具体配置如下：

＜project＞

＜bannerLeft＞

＜name＞maven＜/name＞

＜src＞http://maven.apache.org/images/apache-maven-project.png＜/src＞

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

＜/bannerLeft＞

＜bannerRight＞

＜name＞java＜/name＞

＜src＞images/java.jpg＜/src＞

＜href＞http://www.java.com＜/href＞

＜/bannerRight＞

＜/project＞

上述代码为头部配置了两个横幅图片，左边的图片直接引用了Maven站点，而右边则使用了本地图片。显示效果如图15-12所示。

图　15-12　站点头部横幅图片显示效果

需要注意的是，上述Java图片的src为images/java.jpg，是一个本地图片，所有站点使用的本地Web资源都必须位于src/site/resources目录下。到目前为止，该站点的目录结构是这样的：

-src/

+site/

+resources/

| +images/

| +java.jpg

|

+site.xml

除了标题和头部横幅图片外，Maven用户还能够配置是否显示站点的最近发布时间和版本。如下：

＜project＞

＜version position="right"/＞

＜publishDate position="right"/＞

＜/project＞

这里的position可用的值包括none、left、right、navigation-top、navigation-bottom和bot-tom，它们分别表示不显示、头部左边、头部右边、导航边栏上方、导航边栏下方和底部。

Maven站点还支持面包屑导航。相关配置如下：

＜project＞

＜body＞

＜breadcrumbs＞

＜item name="Maven"href="http://maven.apache.org"/＞

＜item name="Juven Xu"href="http://www.juvenxu.com"/＞

＜/breadcrumbs＞

＜/body＞

＜/project＞

显示效果如图15-13（图中还包括了发布日期和版本）所示。

图　15-13　站点的面包屑导航显示效果