Робота з PDF-редактором

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-експорт

Заховувати будь-який завантажений документ в PDF з використанням файлу: save() метод:

import aspose.words_foss as aw

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

Формат збереження визначається автоматично з розширення файлу. Для ясного управління використовуйте SaveFormat:

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


---

### Використання PdfSaveOptions

Конфігуруйте вихід PDF з: `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-провідний протокол

Письменник PDF використовує чотири спеціалізовані інтерфейси:

Renderer	Handles
`ParagraphRenderer`	Виведення параграфів LDM в PDF обробка вирівнювання, розмежування та пробіг.
`RunRenderer`	Оформлення форматних проемок текстових сегментів з шрифтами, кольорами та посиланнями
`ShapeRenderer`	Видає форми, зображення та позиціонувані елементи.
`TableRenderer`	Оточує таблиці LDM межі клітин, злиття та підкладки

Ці редюсери працюють разом, щоб створити остаточний PDF. Ви взаємодієте з ними непрямо через Document.save().

Переведення декількох формат до PDF-файлів

Письменник PDF приймає вхід з будь-якого підтримуваного читача (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}")


---

### Поради та найкращі практики

- Використання `PdfSaveOptions` коли вам потрібно налаштувати вихід PDF за межами замовлених параметрів.
- Для переведення бачів, завантаження та збереження в циклі  рендері не мають стану і можуть повторного використання у всіх документах.
- PDF-редактор зберігає сильний, курсивний, підчеркнений, розмір шрифту та кольори з джерельного документа.
- Злиття клітин таблиці (`CellMerge`) правильно відображаються в PDF.
- Тестування з репрезентативними документами перед розгортанням до виробництва  складні макетні конструкції можуть потребувати адаптації.

---

### Загальні питання

| Issue                            | Cause                                  | Виправлення                                                                   |
| -------------------------------- | -------------------------------------- | ----------------------------------------------------------------------------- |
| Шрифти відрізняються в PDF-файлі | Шрифт недоступний в системі            | Інсталювати необхідні шрифти або використовувати заміну шрифта                |
| Таблиці не вирівняні.            | Комплексні об'єднані структури столів  | Простіше розміщення таблиць у джерельному документі                           |
| Відсутність зображень            | Дані зображення не вбудовані у джерело | Переконайтеся, що зображення вбудовані, а не пов'язані з зовнішньою стороною. |

---

### FAQ

#### Які формати входу можна експортувати до PDF?

Файли DOCX, DO C, RTF, TXT та Markdown можна завантажити і зберегти як PDF.

#### Чи підтримує PDF-редактор заголовки та підкладки сторінок?

Заголовки та підкладки з джерельного документа включаються в вихід PDF, якщо вони знаходяться у LDM.

#### Чи можу я керувати розміром та орієнтацією сторінки PDF?

Свойства налаштування сторінки (розмір, орієнтація, маржі) з джерельного документа зберігаються в PDF. Modify `PageSetup` на `Document` розділи перед збереженням для зміни цих значень.

---

### Реферат на API

| Клас / метод          | Description                                                               |
| --------------------- | ------------------------------------------------------------------------- |
| `PdfSaveOptions`      | Можливі варіанти збереження документів у формі PDF                        |
| `ParagraphRenderer`   | Виведення параграфів LDM у PDF-файл                                       |
| `RunRenderer`         | Оформлення форматних випускань (текст з шрифтами, кольорами, посиланнями) |
| `ShapeRenderer`       | Видає форми, зображення та позиціонувані елементи.                        |
| `TableRenderer`       | Видає таблиці LDM в PDF                                                   |
| `SaveFormat.PDF`      | Константа для формату збереження PDF                                      |
| `Document.save(path)` | Заховувати документ у визначеному форматі                                 |

## See Also

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