讀古今文學網 > Maven實戰 > 15.5 創建自定義頁面 >

15.5 創建自定義頁面

15.4節介紹了如何自定義站點導航菜單並鏈接至特定的html頁面,本節介紹如何創建自定義的站點頁面。到目前為止,Maven支持得比較好的兩種文檔格式為APT和FML。

APT(Almost Plain Text)是一種類似於維基的文檔格式,用戶可以用它來快速地創建簡單而又結構豐富的文檔。例如,創建一個對應於15.4.4節提到的introduction.html的APT文檔,首先要記住的是:所有APT文檔必須位於src/site/apt/目錄。這裡創建文件introduction.apt,內容見代碼清單15-11。

代碼清單15-11 創建APT文檔

代碼清單15-11的第一部分是標題,它們必須縮進,且用多個連字號相隔。在接下來的內容中,「What is Maven?」和「Core Maven Concepts」沒有縮進,它們是一級小節。「What is Maven?」下面的內容有縮進,表示一個段落。未縮進的且以星號開頭的部分表示二級小節,因此上述代碼中有Coordinate and Dependency、Repository和Plugin and Lifecycle 3個二級小節,它們都包含了一些段落,其中Repository下面有包含三個項的列表,它們用縮進的星號表示。

上述代碼展示了如何編寫一個簡單的APT文檔。筆者沒有詳細介紹所有APT文檔格式的語法,如果讀者有需要,可以參考http://maven.apache.org/doxia/references/apt-format.html。

上述APT文檔展現後的效果如圖15-16所示。

圖15-16 APT文檔效果

FML(FAQ Markup Language)是一種用來創建FAQ(Frequently Asked Questions,常見問題解答)頁面的XML文檔格式,下面創建一個對應於15.4.4節提到的faq.html頁面的FML文檔。就像APT文檔需要放到src/site/apt/目錄一樣,FML文檔需要放到src/site/fml/目錄。在這裡創建文件faq.fml,如代碼清單15-12所示。

代碼清單15-12 創建FML文檔

上述XML文檔的根元素為faqs,該元素的title屬性定義了文檔的標題。根元素下面使用part元素定義了兩個文檔部分,第一個是install,第二個是run。每個文檔部分有自己的標題,以及用faq元素定義的問題項目,faq的子元素question用來定義問題,子元素answer用來定義答案,這種結構是非常清晰的。同樣地,這裡不會詳細解釋所有的FML文檔語法,如果有需要,可以訪問http://maven.apache.org/doxia/references/fml-format.html。

上述FML文檔展現後的效果如圖15-17所示。

圖15-17 FML文檔效果

到目前為止,站點的目錄結構如下: