讀古今文學網 > Maven實戰 > 15.4.4 導航邊欄 >

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 自定義導航邊欄菜單