5
我目前正在使用Java編寫項目,我正在使用Maven和maven-site-plugin生成一個網站,其中包含所有相關的JavaDoc,報告等。同一時間能夠將相同的文檔轉換爲可讀的書本格式。是否有任何腳本或工具用於設計網站,並將其轉換爲合理格式的PDF或其他樣式,以便可以輕鬆地以數字方式提供或打印出來?將Maven網站軟件文檔轉換爲PDF
我目前正在使用Java編寫項目,我正在使用Maven和maven-site-plugin生成一個網站,其中包含所有相關的JavaDoc,報告等。同一時間能夠將相同的文檔轉換爲可讀的書本格式。是否有任何腳本或工具用於設計網站,並將其轉換爲合理格式的PDF或其他樣式,以便可以輕鬆地以數字方式提供或打印出來?將Maven網站軟件文檔轉換爲PDF
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配置
這個插件似乎無法做的只是包含一些更廣泛的Maven生成的報告,因爲你必須給它一個包含每個文件的列表,這對於像JavaDoc這樣的東西來說可能是一個噸, t隨代碼更改而動態工作。 – FModa3 2009-09-29 17:09:37
@ FModa3是的它不是理想的,但是解決方法是使用像groovy插件一樣的東西來處理文件來生成xsl – 2009-09-29 17:33:34