Treballar amb 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.

Exportació PDF bàsica

Salvar qualsevol document carregat en PDF utilitzant el save() mètode:

import aspose.words_foss as aw

doc = aw.Document("input.docx")
doc.save("output.pdf")

El format d’enregistrament es determina automàticament a partir de l’extensió del fitxer. Per un control explícit, utilitzeu el paràmetre “Serve” per fer-ho més fàcilment. SaveFormat:

import aspose.words_foss as aw

doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)

Utilitzar PdfSaveOptions

Configurar la sortida PDF amb: 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)

Pipeline de renderizació PDF

L’escriptor de PDF utilitza quatre renders especialitzats internament:

Renderer (dissenyador)	Manilles
`ParagraphRenderer`	Renders de paràgrafs LDM en PDF gestiona l’alienació, espaciament i indentaments.
`RunRenderer`	Renders formatades corregeix segments de text amb fonts, colors i enllaços
`ShapeRenderer`	Renders de formes, imatges i elements posicionats.
`TableRenderer`	Renders de taules LDM bordes de cèl·lula, fusions i rellotge

Aquests renders treballen junts per produir el PDF final. Interactues amb ells indirectament a través de Document.save().

Convertir diversos formats en PDF

L’escriptor de PDF accepta la entrada d’un lector suportat (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}")

Consells i millors pràctiques

Utilització: PdfSaveOptions quan necessites personalitzar la sortida del PDF més enllà de les predefinides.
Per a la conversió en batches, carregament i guardar en un bucle els renders no tenen estat i són reutilitzables entre documents.
L’editor de PDF conserva les lletres en gras, cursiva, sota-llàstima, mida de font i colors del document d’origen.
Fusions de cel·les de taula (CellMerge) es presenten correctament en sortida PDF.
Testa amb documents representatius abans de la implantació en producció els dissenys complexos poden necessitar d’ajust.

Problemàtiques comuns

Edició	Causa	Correcció
Les fonts són diferents en PDF	Font no disponible en el sistema	Instal·lar les fonts necessàries o utilitzar substitució de font
Taules desalineades	Estructures de taules complexes amb anidats	Simplificar l’anidament de taules en el document font
Imatges desaparegudes	Dades d’imatge no incrustades en la font	Assegurar-se que les imatges estan incrustades, no vinculades externament

FAQ

Quins formats d’entrada es poden exportar a PDF?

Els arxius DOCX, DOc, RTF, TXT i Markdown poden ser carregats i guardats com a PDF.

L’editor de PDF dóna suport als encabezaments i els peu de pàgina?

Els encabezats i els pies del document font s’inclouen en la sortida PDF quan estan presents al LDM.

Puc controlar la mida i orientació de les pàgines PDF?

Les propietats de configuració de pàgines (dimension, orientació, marges) del document font es conserven en el PDF. Modificar PageSetup en el Document seccions abans de guardar per canviar aquests valors.

Resum de referència d’API

Classe / mètode	Descripció
`PdfSaveOptions`	Opcions per guardar documents com a PDF
`ParagraphRenderer`	Renders de paràgrafs LDM en PDF
`RunRenderer`	Renders formatats (text amb fonts, colors, enllaços)
`ShapeRenderer`	Renders de formes, imatges i elements posicionats.
`TableRenderer`	Renders de taules LDM en PDF
`SaveFormat.PDF`	Constants per a format de conservació PDF
`Document.save(path)`	Salvar el document al format especificat