Lavorare con PDF Writer
Lavorare con PDF Writer
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.
Esportazione PDF di base
Salvare qualsiasi documento caricato in PDF utilizzando il file di archivio . save() metodo:
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.pdf")Per il controllo esplicito, utilizzare la funzione di configurazione del file. SaveFormat:
import aspose.words_foss as aw
doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)Utilizzare PdfSaveOptions
Configurare l’ output PDF con: 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)Pipa di rendering PDF
Lo scrittore PDF utilizza quattro render specializzati internamente:
| Renderer (R) | Maniglie |
|---|---|
ParagraphRenderer | Rende LDM paragrafi in PDF gestisce allineamento, spaziatura, indentamenti |
RunRenderer | Render formattato corre segmenti di testo con font, colori e link |
ShapeRenderer | Rende forma, immagini ed elementi posizionati |
TableRenderer | Render tabelle LDM bordi delle celle, fusioni e imbottiture |
Questi renderer lavorano insieme per produrre il PDF finale. Interagisci con loro indirettamente attraverso Document.save().
Conversione di più formati in PDF
Lo scrittore PDF accetta l’input da qualsiasi lettore supportato (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}")Suggerimenti e migliori pratiche
- Utilizzo:
PdfSaveOptionsquando è necessario personalizzare l’uscita PDF oltre i predefiniti. - Per la conversione batch, caricare e salvare in un loop i renderer sono senza stato e riutilizzabili su documenti.
- L’autore PDF conserva il carattere grasso, l’italico, i sottolineamenti, le dimensioni dei font e i colori del documento di origine.
- Fusioni di celle della tabella (
CellMerge) sono correttamente riprodotte in formato PDF. - Test con documenti rappresentativi prima della distribuzione in produzione layout complessi possono richiedere adeguamenti.
Problemi comuni
| Numero di pubblicazione | Causa di morte | Rettifica |
|---|---|---|
| Fonti diversi in PDF | Fonte non disponibile nel sistema | Installare i caratteri richiesti o utilizzare la sostituzione dei carattere |
| Tabelle disallineate | Strutture complesse di tavoli annidati | Semplificare l’ annidamento delle tabelle nel documento sorgente |
| Immagini mancanti | Dati di immagine non incorporati nella fonte | Assicurarsi che le immagini siano incorporate, non collegate esternamente |
FAQ
Quali formati di input possono essere esportati in PDF?
Docx, DOC, RTF, TXT e Markdown possono essere caricati e salvati come PDF.
L’autore PDF supporta gli intestazioni e i piè di pagina?
Le intestazioni e i piedistalli del documento sorgente sono inclusi nell’uscita PDF quando presenti nel LDM.
Posso controllare le dimensioni e l’orientamento delle pagine PDF?
Le proprietà di configurazione della pagina (dimensione, orientamento, margini) del documento sorgente sono conservate nel PDF. Modificare PageSetup sul Document sezioni prima di salvare per modificare questi valori.
Riassunto di riferimento API
| Classe / metodo | Descrizione |
|---|---|
PdfSaveOptions | Opzioni per la memorizzazione dei documenti in formato PDF |
ParagraphRenderer | Rende LDM paragrafi in PDF |
RunRenderer | Rendering delle esecuzioni formattate (testo con font, colori, link) |
ShapeRenderer | Rende forma, immagini ed elementi posizionati |
TableRenderer | Rendering delle tabelle LDM in PDF |
SaveFormat.PDF | Costante per il formato di salvataggio PDF |
Document.save(path) | Salvare il documento nel formato specificato |