Arbejde med PDF-skriver
Arbejde med PDF-skriver
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.
Grundlæggende PDF-eksport
Gem alle indlæste dokumenter til PDF ved hjælp af save() metode:
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.pdf")For eksplicit kontrol, skal du bruge SaveFormat:
import aspose.words_foss as aw
doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)Brug af PdfSaveOptions
Konfigurer PDF-udgangen med: 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-renderingspil
PDF-skriveren bruger fire specialiserede renderere internt:
| Udleverer | Håndtagere |
|---|---|
ParagraphRenderer | Gør LDM-paragrafer til PDF håndterer justering, afstand og indtrækninger |
RunRenderer | Render formaterede løber tekstsegmenter med skrifttyper, farver og links |
ShapeRenderer | Gør former, billeder og placerede elementer synlige |
TableRenderer | Gør LDM-tabeller cellegrænser, sammenlægninger og udfyldning |
Disse renderere arbejder sammen for at producere den endelige PDF. Du interagerer med dem indirekte gennem Document.save().
Konvertering af flere formater til PDF-filmer
PDF-skriveren accepterer input fra enhver understøttet læser (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}")Tips og bedste praksis
- Anvendelse:
PdfSaveOptionsnår du skal tilpasse PDF-udgivelsen ud over standardindstillinger. - For batchkonvertering, indlæse og gem i en løkke rendererne er statløse og genanvendelige på tværs af dokumenter.
- PDF-skriveren bevarer fedtegrav, kursiv, underskrift, skrifttype og farver fra kildedokumentet.
- Tabelcellemassering (
CellMerge) er korrekt gengivet i PDF-udgang. - Test med repræsentative dokumenter før udførelse i produktion Kompleks layout kan kræve justering.
Almindelige problemer
| Udgave: | Årsagen til dette | Forklaret |
|---|---|---|
| Skrifttyper er forskellige i PDF-filer | Fonts er ikke tilgængelige på systemet | Installer de nødvendige skrifttyper eller brug skrift- og tekstformidling |
| Tabeller, der er mislignet | Kompleks indlejrede bordstrukturer | Forenkle indlejring af tabeller i kildedokumentet |
| Fuldstændige billeder | Billeddata, der ikke er indlejret i kilden | Sikre, at billederne er indlejret og ikke eksternt forbundet. |
FAQ
Hvilke indgangsformater kan eksporteres til PDF?
DOCX, DOK, RTF, TXT og Markdown-filer kan alle indlæses og gemmes som PDF.
Støtter PDF-skriveren sidehænder og fodnote?
Overskrifter og fodspor fra kildedokumentet indgår i PDF-udgangen, når de er til stede i LDM.
Kan jeg styre PDF-sidestørrelse og orientering?
Pagens opsætningsegenskaber (størrelse, orientering og margener) fra kildedokumentet bevares i PDF-filen. Modify PageSetup på den 1. januar. Document Inden opsætning skal disse værdier ændres.
API-referenceoversigt
| Klasse/metode | Beskrivelse: |
|---|---|
PdfSaveOptions | Muligheder for at gemme dokumenter som PDF-filer |
ParagraphRenderer | Gør LDM-paragrafer til PDF |
RunRenderer | Rendering af formaterede optagelser (tekst med skrifttyper, farver og links) |
ShapeRenderer | Gør former, billeder og placerede elementer synlige |
TableRenderer | Gør LDM-tabeller til PDF |
SaveFormat.PDF | Konstante for PDF-opslag format |
Document.save(path) | Gem dokumentet i det angivne format |