Работа с PDF-репитером
Работа с 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:
import aspose.words_foss as aw
doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)Использование PdfSaveOptions
Конфигурировать выход PDF с помощью: PdfSaveOptions:
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-редакторе используются четыре специализированных интернета:
| Редактирующий | Ручки |
|---|---|
ParagraphRenderer | Отображает параграфы LDM в PDF обрабатывает выравнивание, интервалы и выдержки. |
RunRenderer | Оформленные текстовые сегменты с шрифтами, цветами и ссылками. |
ShapeRenderer | Отображает формы, изображения и расположенные элементы. |
TableRenderer | Отображает таблицы LDM границы ячеек, объединения и подкладки |
Эти рейндеры работают вместе, чтобы создать окончательный PDF. Вы взаимодействуете с ними косвенно через Document.save().
Преобразование нескольких форматов в PDF-файлы
Письменник PDF принимает вход от любого поддерживаемого читателя (DOCX, DOC, RTF, TXT, Markdown):
import aspose.words_foss as aw
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-образе. - Испытание с помощью репрезентативных документов перед внедрением в производство сложные макеты могут потребовать корректировки.
Общие проблемы
| Выпуск | Причина . | Устранить |
|---|---|---|
| Шрифты различны в PDF | Шрифт недоступен в системе . | Установка требуемых шрифтов или использование замены шрифта |
| Таблицы неразвитые. | Комплексные гнездовые табличные структуры | Упростить вкладывание таблиц в исходный документ . |
| Недостаточно изображений. | Данные изображения не встроены в источник | Убедитесь, что изображения встроены и не связаны внешне. |
FAQ
Какие формы ввода можно экспортировать на PDF?
Документы DOCX, DOc, RTF, TXT и Markdown могут быть загружены и сохранены в виде PDF.
Поддерживает ли PDF-редактор заголовки и подложки страниц?
Заголовки и нижние части из исходного документа включаются в выход PDF, когда они присутствуют в LDM.
Могу ли я контролировать размер и ориентацию страниц PDF?
Свойства настройки страниц (размер, ориентация, маржи) из исходного документа сохраняются в PDF. Изменить PageSetup в отношении: Document разделы перед сохранением для изменения этих значений.
Справочное резюме API
| Класс / метод | Описание: |
|---|---|
PdfSaveOptions | Варианты сохранения документов в формате PDF |
ParagraphRenderer | Переводится в PDF. |
RunRenderer | Оформление форматированных пробегов (текст с шрифтом, цветами, ссылками) |
ShapeRenderer | Отображает формы, изображения и расположенные элементы. |
TableRenderer | Отображает таблицы LDM в PDF-файлы |
SaveFormat.PDF | Постоянная для формата сохранения PDF |
Document.save(path) | Сохранить документ в указанном формате . |