2009-09-29 45 views
5

我目前正在使用Java編寫項目,我正在使用Maven和maven-site-plugin生成一個網站,其中包含所有相關的JavaDoc,報告等。同一時間能夠將相同的文檔轉換爲可讀的書本格式。是否有任何腳本或工具用於設計網站,並將其轉換爲合理格式的PDF或其他樣式,以便可以輕鬆地以數字方式提供或打印出來?將Maven網站軟件文檔轉換爲PDF

回答

7

maven-pdf-plugin生成項目文檔的PDF。從文檔

兩點需要注意考慮:

注1:默認情況下,PDF插件生成彙總所有站點文檔PDF文檔。如果要單獨生成每個站點文檔,則需要在命令行中添加-Daggregate = false。

注2:默認情況下,PDF插件使用FOP實現。該插件還支持iText實現,您只需在命令行中添加-Dimplementation = itext即可。

實際上,你可以指定你的POM總財產(見下面的例子)

此配置將生成PDF上的每個建立了docs輪廓是有效的(你可以做到這一點在每次構建,但這將是一個典型的開發週期慢了一點:

<profiles> 
    <profile> 
    <id>docs</id> 
    <plugin> 
     <groupId>org.apache.maven.plugins</groupId> 
     <artifactId>maven-pdf-plugin</artifactId> 
     <version>1.0</version> 
     <executions> 
     <execution> 
      <id>pdf</id> 
      <phase>site</phase> 
      <goals> 
      <goal>pdf</goal> 
      </goals> 
      <configuration> 
      <outputDirectory> 
       ${project.reporting.outputDirectory} 
      </outputDirectory> 
      <aggregate>false</aggregate> 
      </configuration> 
     </execution> 
     </executions> 
    </plugin> 
    </profile> 
</profiles> 

可以激活命令行配置文件與-P docs,或者如果你想成爲更細粒度的使用activation配置

+0

這個插件似乎無法做的只是包含一些更廣泛的Maven生成的報告,因爲你必須給它一個包含每個文件的列表,這對於像JavaDoc這樣的東西來說可能是一個噸, t隨代碼更改而動態工作。 – FModa3 2009-09-29 17:09:37

+0

@ FModa3是的它不是理想的,但是解決方法是使用像groovy插件一樣的東西來處理文件來生成xsl – 2009-09-29 17:33:34