Chuyển đổi Tài liệu Maven Site Software sang PDF

Question

Tôi hiện đang làm việc trên một dự án viết bằng Java và tôi đang sử dụng Maven và maven-site-plugin để tạo một trang web chứa tất cả các JavaDoc, báo cáo, v.v ... có liên quan. đồng thời để có thể chuyển đổi cùng một tài liệu thành một định dạng có thể đọc được, giống như cuốn sách. Có bất kỳ tập lệnh hoặc công cụ nào được thiết kế để đưa trang web và chuyển đổi nó sang định dạng PDF hợp lý hoặc phong cách khác để có thể dễ dàng cung cấp kỹ thuật số hoặc in ra không?

Answer 1

maven-pdf-plugin tạo tệp PDF của tài liệu dự án.

Hai lưu ý từ các tài liệu để xem xét:

Lưu ý 1: Theo mặc định, các plugin PDF tạo ra một tài liệu PDF mà tập hợp tất cả các tài liệu trang web của bạn. Nếu bạn muốn tạo từng tài liệu trang riêng lẻ, bạn cần phải thêm -Daggregate = false vào dòng lệnh.

Lưu ý 2: Theo mặc định, plugin PDF sử dụng triển khai FOP. Plugin cũng hỗ trợ triển khai iText, bạn chỉ cần thêm -Dimplementation = itext vào dòng lệnh.

Bạn thực sự có thể chỉ định thuộc tính tổng hợp trong POM của bạn (xem ví dụ dưới đây)

Cấu hình này sẽ tạo ra PDF trên từng xây dựng rằng hồ sơ docs đang hoạt động (bạn có thể làm điều đó trên mỗi build, nhưng nó sẽ là một chút chậm cho chu kỳ phát triển điển hình của bạn:.

<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> 

bạn có thể kích hoạt cấu hình trên dòng lệnh với -P docs hoặc sử dụng một cấu hình activation nếu bạn muốn trở thành các tinh chỉnh