Trabajar con PDF Writer
Trabajar 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.
Exportación de PDF
Salva cualquier documento cargado en PDF utilizando el save() El método:
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.pdf")El formato de almacenamiento se determina automáticamente desde la extensión del archivo. para control explícito, utiliza el SaveFormat:
import aspose.words_foss as aw
doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)Usando PdfSaveOptions
Configure la salida de 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)PDF Pipe de Rendering
El editor de PDF utiliza cuatro renderes especializados internamente:
| Renderos | Manual |
|---|---|
ParagraphRenderer | Renders LDM parágrafos en PDF — maneja alineamiento, espacio, indentación |
RunRenderer | Renders formatos runs — segmentos de texto con fuentes, colores y enlaces |
ShapeRenderer | Renders formas, imágenes y elementos posicionados |
TableRenderer | Renders tablas LDM — límites de células, fusiones y padding |
Estos renderes trabajan juntos para producir el PDF final. usted interacciona con ellos indirectamente a través de la Document.save().
Convertir varios formatos en PDF
El editor de PDF acepta las entradas de cualquier lector apoyado (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}")Consejos y mejores prácticas
- Uso
PdfSaveOptionsCuando necesitas personalizar la salida de PDF más allá de los defectos. - Para la conversión de batch, carga y ahorro en un loop - los renderes son estatismuos y reutilizables a través de documentos.
- El editor de PDF conserva el valor, la letra, los tamaños de las letras y los colores del documento fuente.
- La mesa de la mesa (
CellMergeSe han renderizado correctamente en la salida de PDF. - Testar con documentos representativos antes de ponerlos en producción: los diseños complejos pueden necesitar ajustes.
Problemas comunes
| Problemas | Causas | Fixado |
|---|---|---|
| Las letras difieren en PDF | No está disponible en el sistema | Instalar las fuentes necesarias o utilizar la sustitución de fuente |
| Tablas desalignadas | Complejos de estruturas de mesa | Simplifica la tabla de inclinación en el documento de fuente |
| Imágenes perdidas | Datos de imagen no incorporados en la fuente | Aseguran que las imágenes están incorporadas, no vinculadas externamente |
FAQ
¿Qué formatos de entrada se pueden exportar a PDF?
Los archivos DOCX, DOC, RTF, TXT y Markdown pueden ser cargados y guardados como PDF.
¿El editor de PDF apoya las páginas y los pies?
Los cabezas y los pies del documento de fuente se incluyen en la salida PDF cuando están presentes en el LDM.
¿Puedo controlar el tamaño y la orientación de las páginas PDF?
Las propiedades de configuración de página (más, orientación, margen) del documento fuente se conservan en el PDF. PageSetup En el Document Secciones antes de ahorrar para cambiar estos valores.
Sumación de referencia API
| Clase / Método | Descripción |
|---|---|
PdfSaveOptions | Opciones para guardar documentos como PDF |
ParagraphRenderer | Renders LDM para PDF |
RunRenderer | Renders formatos (text con letras, colores, enlaces) |
ShapeRenderer | Renders formas, imágenes y elementos posicionados |
TableRenderer | Renders tablas LDM en PDF |
SaveFormat.PDF | Constante para PDF salvar formato |
Document.save(path) | Salva el documento en el formato especificado |
