Práca s PDF Writerom

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.

Základný PDF export

Uložený dokument uložiť do PDF pomocou save() metóda:

import aspose.words_foss as aw

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

Format ukladania sa automaticky určuje z rozšírenia súboru. Pre explicitnú kontrolu, použijte SaveFormat:

import aspose.words_foss as aw

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

Používanie PdfSaveOptions

Konfigurovať výstup PDF pomocou: 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 Rendering Pipeline (PDF renderovací kanál)

PDF spisovateľ používa štyri špecializované rendery:

Výstupník	Rúrky
`ParagraphRenderer`	Vytvára LDM odseky do PDF spravuje vyrovnanie, rozstupy a vkladá
`RunRenderer`	Render formátované textové segmenty s písmenami, farbami a odkazmi
`ShapeRenderer`	Vytvára tvary, obrázky a položené prvky
`TableRenderer`	Vytvára tabuľky LDM hranice buniek, zlúčenia a plnenie

Tieto renderery spolupracujú na vytvorení konečného PDF. Interagujete s nimi nepriamo prostredníctvom Document.save().

Konverzia viacerých formátov na PDF

Písomník PDF prijíma vstup z akéhokoľvek podporovaného čítača (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}")

Tipy a najlepšie postupy

Použitie: PdfSaveOptions keď potrebujete prispôsobiť výstup PDF nad štandardné nastavenia.
Pre batch konverziu, načítanie a ukladanie v smúti renderery sú bezstátne a opakovane použiteľné pre všetky dokumenty.
PDF spisovateľ uchováva tučné, kurzovité, podčiarknuté písmená, veľkosti písem a farby zo zdrojového dokumentu.
Zlúčenie buniek tabuľky (CellMerge) sú správne zobrazené v výstupe PDF.
Skúška s reprezentatívnymi dokumentmi pred nasadením do výroby zložité rozloženia môžu vyžadovať úpravu.

Spoločné problémy

Výstava	Príčina:	Oprava
Písma sa líšia v PDF	Font nie je k dispozícii v systéme	Inštalovať požadované písma alebo použiť nahradenie písomných znakov
Nevyhovujúce tabuľky	Komplexné štruktúry hniezdených stolov	Zjednodušenie vkladov tabuľky do zdrojového dokumentu
Chýbajúce obrázky	Údaje o obrázku, ktoré nie sú vložené do zdroja	Uistite sa, že obrázky sú vložené a nie externá prepojenie.

FAQ

Ktoré vstupné formáty možno exportovať na PDF?

DOCX, DOK, RTF, TXT a Markdown súbory môžu byť všetky načítané a uložené ako PDF.

Podporuje PDF spisovateľ nadpisy a podstavce stránok?

Nadpisy a podpísmy zo zdrojového dokumentu sú zahrnuté do výstupu PDF, ak sú prítomné v LDM.

Môžem ovládať veľkosť a orientáciu stránky PDF?

Vlastnosti nastavenia stránky (veľkosť, orientácia, okrajové časti) zo zdrojového dokumentu sú uchované v PDF. Modify PageSetup v prípade: Document pred ukladaním na zmenu týchto hodnôt.

Zhrnutie referenčného API

Trieda / metóda	Opis:
`PdfSaveOptions`	Možnosti ukladania dokumentov ako PDF
`ParagraphRenderer`	Vytvára LDM odseky do PDF
`RunRenderer`	Renderovanie formátovaných beží (text s písmenami, farbami, odkazmi)
`ShapeRenderer`	Vytvára tvary, obrázky a položené prvky
`TableRenderer`	Vytvára tabuľky LDM do PDF
`SaveFormat.PDF`	Konštantná pre formát ukladania PDF
`Document.save(path)`	Uložiť dokument do špecifikovaného formátu