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

《Maven实战》15.4.4 导航边栏

关灯直达底部

如果用户不自定义站点描述符文件,页面左边的边栏只会显示包含项目信息报告和其他报告的菜单。然而该导航栏内容也是能够自定义的,用户可以在这里创建其他菜单。

要在导航边栏加入自定义菜单,只需要编辑站点描述符中body元素下的menu子元素。如代码清单15-10所示。

代码清单 15-10

上述代码中定义了三个菜单,分别为${project.name}、Examples和reports。

第一个菜单名称使用了Maven属性,站点描述符中的Maven属性会被自动解析至对应的值。因此这里的${project.name}在站点中会被显示成项目名称,该菜单包含了3个子项,分别为Introduction、Usage和FAQ,每个子项链接一个html文件(15.5节将介绍如何创建这些html页面)。

第二个菜单名称是Examples,包含两个子项Example 1和Example 2,也分别链接两个html页面。

最后一个菜单比较特殊,它使用的是ref属性而非name属性,ref用来引用Maven站点默认生成的页面。例如,这里的reports表示引用项目报告菜单。除此之外,还有两个可用的ref值:parent表示包含父模块链接的菜单,modules表示一个包含所有子模块链接的菜单。

基于代码清单15-10生成的站点如图15-15所示。

图15-15 自定义导航边栏菜单