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
ParagraphRendererRende LDM paragrafi in PDF gestisce allineamento, spaziatura, indentamenti
RunRendererRender formattato corre segmenti di testo con font, colori e link
ShapeRendererRende forma, immagini ed elementi posizionati
TableRendererRender 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: PdfSaveOptions quando è 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 pubblicazioneCausa di morteRettifica
Fonti diversi in PDFFonte non disponibile nel sistemaInstallare i caratteri richiesti o utilizzare la sostituzione dei carattere
Tabelle disallineateStrutture complesse di tavoli annidatiSemplificare l’ annidamento delle tabelle nel documento sorgente
Immagini mancantiDati di immagine non incorporati nella fonteAssicurarsi 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 / metodoDescrizione
PdfSaveOptionsOpzioni per la memorizzazione dei documenti in formato PDF
ParagraphRendererRende LDM paragrafi in PDF
RunRendererRendering delle esecuzioni formattate (testo con font, colori, link)
ShapeRendererRende forma, immagini ed elementi posizionati
TableRendererRendering delle tabelle LDM in PDF
SaveFormat.PDFCostante per il formato di salvataggio PDF
Document.save(path)Salvare il documento nel formato specificato
 Italiano