Arbeiten mit PDF-Referenzprogramm
Arbeiten mit PDF-Referenzprogramm
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-Export für die Basis
Speichern Sie jedes geladene Dokument in PDF mit dem save() Methode:
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.pdf")Das Speicherformat wird automatisch von der Dateierweiterung bestimmt. Für explizite Steuerung verwenden Sie die Funktion “Speichern” (File-Extension). SaveFormat:
import aspose.words_foss as aw
doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)Verwendung von PdfSaveOptions
Konfiguration der PDF-Ausgabe mit: 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-Lösung)
Der PDF-Reader verwendet vier spezielle Interne Renderer:
| Ausführungsbezeichnungen | Handgriffe |
|---|---|
ParagraphRenderer | Veröffentlicht LDM-Abschnitte in PDF Handhabt Ausrichtung, Abstand und Einzug |
RunRenderer | Render formatierte Laufzeiten Textsegmente mit Schriftarten, Farben und Links |
ShapeRenderer | Gestaltungs- und Bilddarstellung sowie Positionsbereiche |
TableRenderer | Darstellung von LDM-Tabellen Zellgrenzen, Fusionen und Polsterungen |
Diese Renderer arbeiten zusammen, um das endgültige PDF zu erstellen. Sie interagieren mit ihnen indirekt durch Document.save().
Umwandeln mehrerer Formate in PDF
Der PDF-Reader akzeptiert Eingaben von jedem unterstützten Reader (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}")Tipps und beste Praktiken
- Verwendung
PdfSaveOptionswenn Sie die PDF-Ausgabe über Standardvorgaben hinaus anpassen müssen. - Für die Batch-Konvertierung, Laden und Speichern in einer Schleife Die Renderer sind stateless und wiederverwendbar über Dokumente.
- Der PDF-Repertor bewahrt Fett, Kursiv, Unterstriche, Schriftgrößen und Farben aus dem Quelldokument.
- Tabellenzellenzusammenführung (
CellMerge) sind in PDF-Ausgabe korrekt dargestellt. - Vor der Produktion mit repräsentativen Dokumenten getestet Komplexe Layouts müssen möglicherweise angepasst werden.
Häufige Probleme
| Ausgabe | Ursache | Behebung |
|---|---|---|
| Schriftart unterscheidet sich in PDF-Dateien | Schriftart nicht im System verfügbar | Installieren Sie die erforderlichen Schriftarten oder verwenden Sie eine Schriftartersatzfunktion |
| Tabellen fehlgeleitet | Komplexe eingebettete Tischstrukturen | Vereinfachen der Verknüpfung von Tabellen im Quelldokument |
| Fehlende Bilder | Bilddaten, die nicht in der Quelle eingebettet sind | Stellen Sie sicher, dass die Bilder eingebettet sind und nicht extern verknüpft werden. |
FAQ
Welche Eingabeformate können in PDF exportiert werden?
DOCX, DOK, RTF, TXT und Markdown-Dateien können alle als PDF geladen und gespeichert werden.
Unterstützt der PDF-Repertor Seitenüberschriften und -Fußzeilen?
Die Überschriften und Fußzeilen des Quelldokuments werden in der PDF-Ausgabe enthalten, wenn sie im LDM vorhanden sind.
Kann ich die PDF-Seitengröße und -orientierung steuern?
Die Eigenschaften des Seiten-Setups (Größe, Ausrichtung, Margen) aus dem Quelldokument werden im PDF erhalten. Modify PageSetup auf der Document Die Daten werden dann nach dem Datum der Übermittlung des E-Mail-Nachrichtenberichts eingesetzt.
Zusammenfassung der API-Referenzen
| Klasse / Methode | Beschreibung |
|---|---|
PdfSaveOptions | Optionen zum Speichern von Dokumenten als PDF-Datei |
ParagraphRenderer | LDM-Abschnitte in PDF darstellen |
RunRenderer | Rendering von formatierten Laufzeiten (Text mit Schriftarten, Farben und Links) |
ShapeRenderer | Gestaltungs- und Bilddarstellung sowie Positionsbereiche |
TableRenderer | LDM-Tabellen in PDF darstellen |
SaveFormat.PDF | Konstante für das PDF-Speicherformat |
Document.save(path) | Speichern Sie das Dokument in dem angegebenen Format . |