Document

General

Document és el punt d’entrada principal de Aspose.Words FOSS per a Python. Proporciona l’API pública per carregar documents Word (DOC, DOCX, RTF, TXT, Markdown), guardar en múltiples formats de sortida (PDF, Marcabaix,TXT) i extraure text pla.

Definit en: aspose/words_foss/document.py

Constructor

Signatura	Descripció
`Document(filepath=None, *, stream=None, data=None)`	Carregar un document des d’una ruta de fitxer, flux binari o bytes bruts. Cal proporcionar almenys una font.

Paràmetres:

Nom	Tipus de productes	Descripció
`filepath`	`Optional[Union[str, Path]]`	Camin cap al fitxer de document a carregar.
`stream`	`Optional[BinaryIO]`	Corrent binari que conté dades de document (només en format DOCX).
`data`	`Optional[bytes]`	Bytes bruts del contingut del document (només en format DOCX).

Mètodes

Signatura	Descripció
`save(output_path, save_format_or_options=None)` → `None`	Salvar el document en PDF (`SaveFormat.PDF`), Marca de baixa (`SaveFormat.MARKDOWN`), o text sencer (`SaveFormat.TEXT`) Passar a la `SaveFormat` constant per a la configuració predeterminada, o un objecte d’opcions de salvament (`PdfSaveOptions`, `MarkdownSaveOptions`) per un control de granos fins sobre la producció.
`get_text()` → `str`	Extracció de text en blanc del document carregat.

Propietats

Nom	Tipus de productes	Accés	Descripció
`light_document_model`	`ldm.Document`	Llegeix.	Accedir al model de document lleuger subjacent per a una inspecció avançada de l’estructura del document (paràgrafs, taules, estils, seccions).

Utilització

import aspose.words_foss as aw

# Load a DOCX file
doc = aw.Document("input.docx")

# Extract plain text
text = doc.get_text()

# Save as PDF
doc.save("output.pdf", aw.SaveFormat.PDF)

# Save as Markdown
doc.save("output.md", aw.SaveFormat.MARKDOWN)

Formats suportats

Formats d’entrada

Format de la pàgina	`LoadFormat` Constant	Descripció
DOCX	`LoadFormat.DOCX`	Document de Word d’Office obert XML
DOC	`LoadFormat.DOC`	Format binari de Microsoft Word llegat
RTF	`LoadFormat.RTF`	Format de text enriquit
TXT	`LoadFormat.TEXT`	Text ordinari
Marca de baixa	`LoadFormat.MARKDOWN`	Marcada a baix.
Automòbil.	`LoadFormat.AUTO`	Detectar format a partir de l’extensió del fitxer (default)

Formats de sortida

Format de la pàgina	`SaveFormat` Constant	Salvar opcions
PDF	`SaveFormat.PDF`	`PdfSaveOptions` configurar la conformitat, compressió d’imatges, incrustació de fonts
Marca de baixa	`SaveFormat.MARKDOWN`	`MarkdownSaveOptions` configurar l’alineació de taules, exportació d’imatges, modalitat de llista
Text en format ordinari	`SaveFormat.TEXT`	—
DOCX	`SaveFormat.DOCX`	Constant de només lectura. `Document.save()` No suporta les pujades de DOCX `ValueError`.
DOC	`SaveFormat.DOC`	Constant de només lectura. `Document.save()` No suporta el DOC augments. `ValueError`.

Modell de document Light

El light_document_model Property proporciona accés a l’estructura interna del document (ldm.Document, definit en el següent: light_document_model.py) Aquest pidantic BaseModel exposa paràgrafs, taules, estils, seccions, encabezats i preguntes estructurals com ara: find_style() i de la headings().La majoria dels usuaris no necessiten accedir al LDM directament el públic. Document Els mètodes esmentats inclouen fluxos de treball estàndard.

Veure també

SaveFormat constants de format d’exportació utilitzades amb Document.save()
LoadFormat Constants de format d’entrada per a la especificació explícita del format.
PdfSaveOptions Control de exportació PDF (nivel de conformitat, compressió, incrustació de fonts)
MarkdownSaveOptions Opcions d’exportació de marcament (alineació del quadre, manipulació dimatges, modalitat de llista)