Práce s PDF Writerem
Práce s PDF Writerem
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žte jakýkoli načtený dokument do PDF pomocí save() metoda:
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.pdf")Format ukládání je automaticky určen z rozšíření souboru. Pro explicitní ovládnutí použijte SaveFormat:
import aspose.words_foss as aw
doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)Použití PdfSaveOptions
Konfigurovat výstup PDF pomocí: 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 zobrazovací potrubí)
PDF spisovatel používá čtyři specializované rendery interně:
| Výstupce | Rukušnice |
|---|---|
ParagraphRenderer | Převede odstavce LDM do PDF ovládá vyrovnání, odstup a náraz. |
RunRenderer | Rendery formátované běhů textové segmenty s písmy, barvami a odkazy |
ShapeRenderer | Představuje tvary, obrázky a položené prvky. |
TableRenderer | Představuje tabulky LDM hranice buněk, sloučení a výplňování |
Tyto rendery spolupracují na vytvoření konečného PDF. Interagujete s nimi nepřímo prostřednictvím Document.save().
Konverze více formátů na PDF
PDF spisovatel přijímá vstup z jakéhokoli podporovaného čtenářů (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 nejlepší postupy
- Použití:
PdfSaveOptionskdyž potřebujete přizpůsobit výstup PDF mimo předvolené nastavení. - Pro batch konverzi, načítání a ukládání v smyčce jsou renderery bezstátní a opakovaně použitelné napříč dokumenty.
- PDF spisovatel zachovává tučné písmo, kurzivní písmena, podtržení, velikost písma a barvy ze zdrojového dokumentu.
- Spojování buněk tabulky (
CellMerge) jsou správně zobrazeny v výstupu PDF. - Testování s reprezentativními dokumenty před nasazením do výroby složitá uspořádání mohou vyžadovat úpravu.
Obvyklé problémy
| Výše: | Příčina: | Opravy |
|---|---|---|
| Písma se liší v PDF | Font není k dispozici v systému | Nainstalujte požadované písmo nebo použít nahradění písma |
| Nevyvážené tabulky | Komplexní struktury vnitřně hnízděných stolů | Zjednodušit vkládání tabulky do zdrojového dokumentu |
| Chybí obrázky. | Údaje o obraze nezasazené do zdroje | Zajistěte, aby obrázky byly vestavěné a nebyly externě propojeny. |
FAQ
Které vstupní formáty lze exportovat do PDF?
Soubory DOCX, DOK, RTF, TXT a Markdown lze všechny načíst a uložit jako PDF.
Podporuje PDF spisovatel titulky a podstavce stránek?
Nadpisy a podpísky ze zdrojového dokumentu jsou zahrnuty do výstupu PDF, pokud jsou v LDM.
Můžu si ovládat velikost a orientaci stránky PDF?
Vlastnosti nastavení stránky (velikost, orientace, okrajové části) ze zdrojového dokumentu jsou uchovávány v PDF. Změnit PageSetup na: Document před ukládáním změnit tyto hodnoty.
Souhrnná referenční informace API
| Třída / metoda | Popis: |
|---|---|
PdfSaveOptions | Možnosti ukládání dokumentů jako PDF |
ParagraphRenderer | Převod odstavec LDM do PDF |
RunRenderer | Rendering formátovaných běhů (text s písmy, barvami a odkazy) |
ShapeRenderer | Představuje tvary, obrázky a položené prvky. |
TableRenderer | Převod tabulek LDM do PDF |
SaveFormat.PDF | Konstanta pro formát ukládání PDF |
Document.save(path) | Uložení dokumentu do stanoveného formátu |