Làm việc với PDF Writer

Aspose.Words FOSS for Python exports documents to PDF through a dedicated rendering pipeline. The pipeline converts each LDM element — paragraphs, runs, shapes, and tables — into PDF output using specialized renderers.

PDF xuất khẩu

Lưu bất kỳ tài liệu tải lên PDF bằng cách sử dụng save() Phương pháp :

import aspose.words_foss as aw

doc = aw.Document("input.docx")
doc.save("output.pdf")

Định dạng lưu được xác định tự động từ phần mở rộng tệp. để kiểm soát rõ ràng, sử dụng SaveFormat:

doc = aw.Document(“input.doc”) doc.save(“output.pdf”, aw.SaveFormat.PDF)


---

### Sử dụng PdfSaveOptions

Thiết lập PDF output với `PdfSaveOptions`:

```python
import aspose.words_foss as aw
from aspose.words_foss.saving import PdfSaveOptions

doc = aw.Document("input.docx")
opts = PdfSaveOptions()
doc.save("output.pdf", opts)

PDF Động cơ Rendering Pipeline

Tác giả PDF sử dụng bốn trình render chuyên môn trong nội bộ:

Renderer	Handles
`ParagraphRenderer`	Renders LDM paragraphs into PDF — xử lý điều chỉnh, spacing, indentation
`RunRenderer`	Renders định dạng chạy — các phân đoạn văn bản với chữ cái, màu sắc và liên kết
`ShapeRenderer`	Renders hình dạng, hình ảnh và các yếu tố định vị
`TableRenderer`	Renders LDM bảng - giới hạn tế bào, hợp nhất và đúc

Những trình renderer này làm việc cùng nhau để tạo ra PDF cuối cùng. bạn tương tác với chúng trực tiếp thông qua Document.save().

Chuyển đổi nhiều định dạng sang PDF

Tác giả PDF chấp nhận các bản ghi từ bất kỳ người đọc được hỗ trợ nào (DOCX, DOC, RTF, TXT, Markdown):

for input_file in [“report.docx”, “legacy.doc”, “notes.rtf”, “readme.txt”]: doc = aw.Document(input_file) pdf_name = input_file.rsplit(".", 1)[0] + “.pdf” doc.save(pdf_name) print(f"Saved {pdf_name}")


---

### Mẹo và Thực hành Tốt nhất

- Sử dụng `PdfSaveOptions` khi bạn cần tùy chỉnh phát hành PDF bên ngoài mặc định.
- Đối với chuyển đổi hàng loạt, tải và lưu trong một vòng - các renderers là không có trạng thái và tái sử dụng trên tất cả các tài liệu.
- Tác giả PDF giữ lại những kích thước phông chữ, âm đạo, dưới dạng và màu sắc từ tài liệu nguồn.
- Bảng xếp hạng (`CellMerge`) được trình bày đúng trong PDF output.
- Kiểm tra bằng các tài liệu đại diện trước khi triển khai sản xuất - thiết kế phức tạp có thể cần điều chỉnh.

---

### Các vấn đề thường gặp

| Issue                             | Cause                                       | Fix Đặt                                                    |
| --------------------------------- | ------------------------------------------- | ---------------------------------------------------------- |
| Các phông chữ khác nhau trong PDF | Không có chữ trong hệ thống                 | Cài đặt các phông chữ cần thiết hoặc sử dụng thay thế phon |
| Bảng không hợp nhất               | Các cấu trúc bàn phức tạp                   | Đơn giản bảng nén trong tài liệu nguồn                     |
| Hình ảnh mất tích                 | Dữ liệu hình ảnh không được nhúng vào nguồn | Bảo đảm rằng hình ảnh được nhúng, không liên kết bên ngoài |

---

### FAQ

#### Các định dạng nhập nào có thể được xuất sang PDF?

Các tập tin DOCX, DOC, RTF, TXT và Markdown đều có thể được tải lên và lưu như PDF.

#### PDF tác giả có hỗ trợ các tiêu đề và chân trang không?

Đầu và chân từ tài liệu nguồn được bao gồm trong bản phát hành PDF khi hiện diện trong LDM.

#### Tôi có thể kiểm soát kích thước và định hướng trang PDF không?

Các thuộc tính thiết lập trang (tổng, định hướng, giới hạn) từ tài liệu nguồn được lưu trữ trong PDF. `PageSetup` trên The `Document` Phần trước khi tiết kiệm để thay đổi các giá trị này.

---

### Tóm tắt Tham chiếu API

| Class / Phương pháp   | Description                                                       |
| --------------------- | ----------------------------------------------------------------- |
| `PdfSaveOptions`      | Các tùy chọn để lưu tài liệu như PDF                              |
| `ParagraphRenderer`   | Renders LDM paragraphs into PDF (Điều kiện LDm)                   |
| `RunRenderer`         | Renders định dạng chạy (thiết văn với chữ cái, màu sắc, liên kết) |
| `ShapeRenderer`       | Renders hình dạng, hình ảnh và các yếu tố định vị                 |
| `TableRenderer`       | Renders LDM bảng vào PDF                                          |
| `SaveFormat.PDF`      | Constant for PDF Save định dạng                                   |
| `Document.save(path)` | Lưu tài liệu vào định dạng cụ thể                                 |

## See Also

- [Aspose.Words for Python — Enterprise Documentation](https://docs.aspose.com/words/python-net/)